Skip to content
Tài liệu tham khảo API
/
Điện thoại đám mây
/
/Live Streaming

Live Streaming

Bắt đầu, kiểm tra và dừng phát trực tiếp trên cloud phone.

Operations

Bắt đầu phát trực tiếp

Request

Bắt đầu phát trực tiếp một tệp MP4 đã tải lên trên cloud phone.

  • Điều kiện tiên quyết: cloud phone phải đang bật và không bị thành viên khác chiếm giữ, và thiết bị phải hỗ trợ phát trực tiếp. fileId phải trỏ tới một tệp được tải lên dưới dạng nội dung phát trực tiếp và đã hoàn tất tải lên; mọi trường hợp khác đều bị từ chối vì không hợp lệ hoặc đã hết hạn.
  • Hoàn tất: đã tiếp nhận, chưa hoàn tất. Phản hồi chỉ xác nhận dịch vụ thiết bị đã nhận yêu cầu. Hãy hỏi vòng /cloudphone/live/status cho đến khi liveStatus bằng 1.
  • Lưu ý: giới hạn chỉ nhận MP4 được áp dụng khi bạn tải tệp lên, không phải ở đây.
  • Thử lại: không có cơ chế chống trùng; gọi lại sẽ phát lại lệnh bắt đầu.

Các mã lỗi nghiệp vụ đã ghi nhận: 33300, 33301, 33401, 33418. Xem Error Codes để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

Bodyapplication/jsonrequired
phoneIdstringrequired

Cloud phone ID

Example:"190000000000000001"
fileIdstringrequired

ID of an uploaded MP4 live-streaming file (uploadType=2)

Example:"820000000000000001"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/live/start \
  -H 'Content-Type: application/json' \
  -d '{
    "phoneId": "190000000000000001",
    "fileId": "820000000000000001"
  }'

Responses

Request processed; inspect code for the business result

Bodyapplication/json
codeintegerrequired

Business result code; 0 indicates success

Example:0
msgstring or nullrequired

Error message; null when successful

Example:null
requestIdstringrequired

Request ID for troubleshooting

Example:"1d4f3ea968664593860b94b35d4ebf5e"
databooleanrequired

Whether the live-streaming operation succeeded

Response
{
  "code": 0,
  "msg": null,
  "data": true,
  "requestId": "1d4f3ea968664593860b94b35d4ebf5e"
}