Thiết lập số học sinh trên bục giảng (Onstage Student)

Mục lục

Để thiết lập số lượng học viên hiển thị trên bục giảng, cần truyền các tham số, SID, safekey, timeStamp, course ID, class ID, number of students on stage, set the camera definition, and whether to enable dual-camera mode (i.e. enable the second camera). Giá trị tối đa được truyền cho tham số seatNum  là số học sinh tối đa được hiển thị trên bục giảng của trường. Nếu bạn cần sửa đổi số lượng học sinh trên bục nhiều hơn số lượng tối đa của trường, vui lòng liên hệ với chúng tôi.

Lưu ý: Vui lòng truyền ít nhất 1 tham số seatNum hoặc isHd.

To modify the number of students on stage in a class, you need to provide SID, safekey, timeStamp, course ID, class ID, number of students on stage, set the camera definition, and whether to enable dual-camera mode (i.e. enable the second camera). Returns a successful description after execution. The maximum value that seatNum can modify is the maximum number of students on stage in the institution. If you need to modify the number of students on stage beyond the maximum number of students on stage in the institution, please contact the account manager. 

Note : At least one of seatNum and isHd must be passed.

URL

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

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
classId Bắt buộc ID Lớp học
seatNum Bắt buộc Số lượng học sinh tối đa được hiển thị trên bục giảng sẽ là số lượng mà trường đã đăng ký với ClassIn (số lượng tối đa hệ thống có thể thiết lập là 12) Số lượng camera trên hiển thị trên bục giảng (
không bao gồm của giáo viên)
Ví dụ: Nếu cần thiết lập lớp 1v6 thì truyền tham số 6
isHd Không bắt buộc 0= không HD, 1= HD, 2= Full HD, tất cả các giá trị khác ngoài 1 hoặc 2 sẽ mặc định được hiểu là 0 Có bật chế độ HD hay khôngcần truyền ít nhất 1 tham số SeatNum hoặc isHd để gọi API này

Response data

Key Định dạng Phản hồi Ý nghĩa
error_info object   Returns an array of data
└ errno number 1 Mã lỗi
└ error string “program normal run” Chi tiết lỗi

Sample

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

SID=2339736&safeKey=58ce17711abea665f40f67d550ce96fb&timeStamp=1493364941&courseId=490583&classId=1395039&seatNum=6&isHd=2
  • 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=442447" \
     -d "classId=23644"  \
     -d "seatNum=6" \
     -d "isHd=2"
     "https://api.eeo.cn/partner/api/course.api.php?action=modifyClassSeatNum"

Response sample(The normal return json packet example)

{
  "error_info": {
    "errno": 1,
    "error": "程序正常执行"
  }
}

Error Code Description

Error Code Description
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
140 Lớp học đang diễn ra không thể bị chỉnh sửa hay xóa
142 Lớp học không tồn tại trong khóa học
143 Không có thông tin về lớp học
144 Trường không có khóa học này
145 Lớp học này đã kết thúc và không thể xóa
147 Không có thông tin về khóa học này
149 Khóa học này đã bị xóa
153 Khóa học đã hết hạn
212 Lớp học đã bị xóa
259 Số lượng học sinh trên bục giảng đã vượt quá giới hạn cho phép
348 Trong vòng 20 phút trước khi lớp học bắt đầu, không thể điều chỉnh số lượng học sinh trên bục giảng
349 Chỉnh sửa số lượng học sinh trên bục giảng thất bại
367 Điều chỉnh camera HD thất bại
368 Số lượng học sinh trên bục giảng được thiết lập cho lớp học này không hỗ trợ camera HD
369 Không hỗ trợ thao tác cho định dạng lớp học công khai
466 Lớp học được tạo từ LMS không thể chỉnh sửa thông qua API. Vui lòng truy cập ứng dụng ClassIn hoặc Trang quản lý để chỉnh sửa
808 Không hỗ trợ thiết lập dual-camera cho lớp học này