Để 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 |