Thiết lập ghi hình, phát trưc tiếp và phát lại video ghi hình cho hàng loạt lớp học

Mục lục

Để thiết lập ghi hình, phát trực tiếp và phát lại cho một lớp học, cần truyền các tham số SID, safekey, timestamp, ID khóa học và thông tin lớp học tương ứng (bao gồm ID lớp học, thiết lậ ghi hình, phát trực tiếp, phát lại, trang web phát trực tiếp phát lại, cho phép người dùng không đăng nhập tham gia trò chuyện trực tiếp và thích)

Lưu ý: Nếu lớp học hiện tại đã kết thúc, chức năng ghi hình và phát sóng trực tiếp không thể được thiết lập. Người dùng có thể truyền các trường tùy chỉnh và giao diện sẽ trả về các tham số theo nguyên trạng. Nếu không đạt, sẽ không có kết quả nào được trả về.

Ghi chú:

  • Nếu khóa học được thiết lập để ghi hình (không phải trực tiếp), more_data sẽ trả về địa chỉ trình phát trực tiếp cho khóa học và địa chỉ luồng phát trực tuyến sẽ trống;
  • Nếu khóa học được thiết lập để ghi hình và phát trực tiếp, more_data sẽ trả về địa chỉ trình phát trực tiếp cho khóa học và địa chỉ luồng phát trực tuyến;
  • Nếu muốn thiết lập ghi hình camera của giáo viên, cần mở lớp có chế độ ghi hình.

For class recording, live broadcasting and playback (multiple), SID, safekey, timeStamp, course ID and class information array (class information object includes class ID, recording, live broadcasting and playback) shall be provided.

Note: if the current session has ended, the recording and live broadcasting functions cannot be set.Users can pass custom fields, and the interface returns the parameters as-is.No pass, no return.

Notes:

  • If class recording is set (live streaming is not set), more_data returns the live streaming player address of the class, and the pull stream address is empty.
  • More_data returns the live player address and pull stream address of the lecture if the lecture is recorded and streamed live.
  • To enable the recording of the on-the-spot scene, please turn on the record function first, otherwise, the recording of the on-the-spot scene is not available.

URL #

https://api.eeo.cn/partner/api/course.api.php?action=setClassVideoMultiple

HTTP Request Methods #

  • POST

Coding format #

  • UTF-8
 

Request data #

KeyBắt buộcYêu cầu thêmMô tảHướng dẫn
SIDBắt buộcID của trườngXem dữ liệu này tại Trang quản lý classin.com trong mục API
safeKeyBắt buộcFixed 32-bit all lowercase charactersKhóa bảo mật xác thực trường họcsafeKey=MD5(SECRET+timeStamp)
timeStampBắt buộcTheo Unix Epoch timestamp & có hiệu lực trong vòng 20 phútThời gian UNIX Epoch là số giây đã trôi qua kể từ 00:00:00 (giờ chuẩn quốc tế) vào ngày 1 tháng 1 năm 1970
courseIdBắt buộcID Khóa học
classJsonBắt buộcMảng thông tin lớp học
└ Class 1 information objectCác thiết lập
  └ classIdBắt buộcID lớp học (lesson)
  └ recordGhi hình lớp học (0=Tắt,1=Bật)
  └ recordSceneGhi hình camera giáo viên (0=Tắt,1=Bật)
  └ livePhát trực tiêp (0=Tắt,1=Bật)
  └ replayPhát lại ghi hình (0=Tắt,1=Bật)
  └ customColumn1-50 ký tự, nếu số ký tự vượt quá 50, hệ thống sẽ tự động cắt ngắn còn 50 ký tựNgười dùng tự thiết lậpNếu để trống thì trường này sẽ không trả về thông tin gì
└ Class 2 information object
  └ classIdBắt buộcID lớp học (lesson)
  └ recordGhi hình lớp học (0=Tắt,1=Bật)
  └ recordSceneGhi hình camera giáo viên (0=Tắt,1=Bật)
  └ livePhát trực tiêp (0=Tắt,1=Bật)
  └ replayPhát lại ghi hình (0=Tắt,1=Bật)
└ watchByLoginNếu không truyền hoặc truyền không đúng thì sẽ không có sửa đổi nào được thực hiệnChỉ những người đã đăng nhập tài khoản ClassIn mới có thể xem (0=Tắt, 1=Bật)Nếu hai hoặc nhiều mục sau đây không được bật: ghi hình, phát trực tiếp hoặc phát lại, tham số này sẽ không được sử dụng ngay cả khi đã được đặt
└ allowUnloggedChatNếu không truyền hoặc truyền không đúng thì sẽ không có sửa đổi nào được thực hiệnCho phép người dùng chưa đăng nhập tham gia trò chuyện trực tiếp và nhấn thích (0=Tắt, 1=Bật)Nếu tính năng ghi hình và phát trực tiếp không được bật, tham số này sẽ không được sử dụng ngay cả khi đã được thiết lập
  └ customColumn1-50 ký tự, nếu số ký tự vượt quá 50, hệ thống sẽ tự động cắt ngắn còn 50 ký tựNgười dùng tự thiết lậpNếu để trống thì trường này sẽ không trả về thông tin gì

Response data #

KeyĐịnh dạngPhản hồiÝ nghĩa
dataarray Returns an array of data information, including the following fields
 └ more_dataarray[]Returns an array of Data information
 └ live_urlstringhttps://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164dLesson live player address
 └ live_infoarray[]Returns an array of Data information
  └ RTMPstring“rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd”Live streaming’s pull flow address
  └ HLSstringhttps://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cdLive streaming’s pull flow address
  └ FLVstringhttps://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cdLive streaming’s pull flow address
 └ errnonumber1Mã lỗi
 └ errorstring“Routine execution”Chi tiết lỗi
└ ……[]{……}Error message object, including the following fields
 └ more_dataarray[]Returns an array of Data information
 └ live_urlstringhttps://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164dLesson live player address
 └ live_infoarray[]Returns an array of Data information
  └ RTMPstring“rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd”Pull flow address
  └ HLSstringhttps://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cdPull flow address
  └ FLVstringhttps://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cdPull flow address
  └ errnonumberMã lỗi
  └ errorstring“Normal execution”Chi tiết lỗi
error_infoobject Return message object
└ errnonumber1Mã lỗi
└ errorstring“Normal execution”Chi tiết lỗi

Sample #

  • HTTP request
POST /partner/api/course.api.php?action=setClassVideoMultiple HTTP/1.1
Host: www.eeo.cn
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

SID=2339736&safeKey=6b5e624027b981fc2da5b1787c974281&timeStamp=1494392466&courseId=523689&classJson=[{"classId":"1419691","record":"1","live":"","replay":"","customColumn":123},{"classId":"1419693","record":"1","live":"","replay":"","customColumn":123}]
  • Shell cURL analog request instruction
curl -H "Content-Type: application/x-www-form-urlencoded" -X "POST" \
      -d "SID=1234567" \
      -d "safeKey=0f7781b3033527a8cc2b1abbf45a5fd2" \
      -d "timeStamp=1484719085" \
      -d "courseId=123456" \
      -d 'classJson=[ \
                      { \
                        "classId":"1234", \
                        "record":"1", \
                        "live":"0", \
                        "replay":"0" \
                      }, \
                      { \
                        "classId":"1235", \
                        "record":"1", \
                        "live":"0", \
                        "replay":"0" \
                      } \
                    ]' \
    "https://api.eeo.cn/partner/api/course.api.php?action=setClassVideoMultiple"

Response sample(The normal return json packet example) #

{
  "data": [
    {
      "customColumn": "123",
      "more_data": {
          "live_url": "https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d",
          "live_info": {
              "RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
              "HLS": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
              "FLV": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd"
          }
        },
      "errno": 1,
      "error": "程序正常执行"
    },
    {
      "customColumn": "123",
      "more_data": {
          "live_url": "https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d",
          "live_info": {
              "RTMP": "rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
              "HLS": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd",
              "FLV": "https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd"
          }
        },
      "errno": 1,
      "error": "程序正常执行"
    }
  ],
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}

Error code instruction #

Error codeInstruction
1Thành công
100Parameters sai định dạng hoặc không hoàn chỉnh
102Không có quyền thao tác (Xác thực bảo mật thất bại)
104Thao tác thất bại
114Phát hiện lỗi máy chủ
142Không có thông tin của khóa học này
143Không có thông tin của lớp học này
144Không có khóa học này trong trường
149Khóa học này đã bị xóa
155Các trường thông tin thiết lập lớp học không được để trống
212Lớp học đã bị xóa
251Chỉ khi ghi hình được bật thì mới có thể bật phát trực tiếp hoặc phát lại
252Ghi hình/phát trực tiếp, chỉ có thể được chỉnh sửa 20 phút trước khi lớp học bắt đầu
253Đang có sự cố với dịch vụ video. Vui lòng thử lại sau
369Lớp học công khai không hỗ trợ điều chỉnh