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

Key Bắt buộc Yêu cầu thêm Mô tả Hướng dẫn
SID Bắt buộc ID của trường Xem dữ liệu này tại Trang quản lý classin.com trong mục API
safeKey Bắt buộc Fixed 32-bit all lowercase characters Khóa bảo mật xác thực trường học safeKey=MD5(SECRET+timeStamp)
timeStamp Bắt buộc Theo Unix Epoch timestamp & có hiệu lực trong vòng 20 phút Thờ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
courseId Bắt buộc ID Khóa học
classJson Bắt buộc Mảng thông tin lớp học
└ Class 1 information object Các thiết lập
  └ classId Bắt buộc ID lớp học (lesson)
  └ record Ghi hình lớp học (0=Tắt,1=Bật)
  └ recordScene Ghi hình camera giáo viên (0=Tắt,1=Bật)
  └ live Phát trực tiêp (0=Tắt,1=Bật)
  └ replay Phát lại ghi hình (0=Tắt,1=Bật)
  └ customColumn 1-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ập Nếu để trống thì trường này sẽ không trả về thông tin gì
└ Class 2 information object
  └ classId Bắt buộc ID lớp học (lesson)
  └ record Ghi hình lớp học (0=Tắt,1=Bật)
  └ recordScene Ghi hình camera giáo viên (0=Tắt,1=Bật)
  └ live Phát trực tiêp (0=Tắt,1=Bật)
  └ replay Phát lại ghi hình (0=Tắt,1=Bật)
└ watchByLogin Nế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ện Chỉ 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
└ allowUnloggedChat Nế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ện Cho 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
  └ customColumn 1-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ập Nếu để trống thì trường này sẽ không trả về thông tin gì

Response data

Key Định dạng Phản hồi Ý nghĩa
data array   Returns an array of data information, including the following fields
 └ more_data array [] Returns an array of Data information
 └ live_url string https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d Lesson live player address
 └ live_info array [] Returns an array of Data information
  └ RTMP string “rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd” Live streaming’s pull flow address
  └ HLS string https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd Live streaming’s pull flow address
  └ FLV string https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd Live streaming’s pull flow address
 └ errno number 1 Mã lỗi
 └ error string “Routine execution” Chi tiết lỗi
└ …… [] {……} Error message object, including the following fields
 └ more_data array [] Returns an array of Data information
 └ live_url string https://api.eeo.cn/live.php?lessonKey=0fdc12bc3558164d Lesson live player address
 └ live_info array [] Returns an array of Data information
  └ RTMP string “rtmp://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd” Pull flow address
  └ HLS string https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.m3u8?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd Pull flow address
  └ FLV string https://liveplay.eeo.cn/eeolive/576f5a8c97d9-183291632119a96.flv?txSecret=f4bfe1afcf2592de61c11af9e0954c00&txTime=7d8d37cd Pull flow address
  └ errno number Mã lỗi
  └ error string “Normal execution” Chi tiết lỗi
error_info object   Return message object
└ errno number 1 Mã lỗi
└ error string “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 code Instruction
1 Thành công
100 Parameters sai định dạng hoặc không hoàn chỉnh
102 Không có quyền thao tác (Xác thực bảo mật thất bại)
104 Thao tác thất bại
114 Phát hiện lỗi máy chủ
142 Không có thông tin của khóa học này
143 Không có thông tin của lớp học này
144 Không có khóa học này trong trường
149 Khóa học này đã bị xóa
155 Các trường thông tin thiết lập lớp học không được để trống
212 Lớp học đã bị xóa
251 Chỉ 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
252 Ghi 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
369 Lớp học công khai không hỗ trợ điều chỉnh