跳转到内容
API 参考
/
云手机
/
/Live Streaming

Live Streaming

开始、查询和结束云手机直播。

Operations

开始直播

Request

在云手机上开始直播一个已上传的 MP4 文件。

  • 前置条件：云手机必须已开机且未被其他成员占用，且机型必须支持直播。fileId 必须指向一个已完成上传的直播素材文件，其他情况会以无效或已失效被拒绝。
  • 完成信号：已受理，未完成。 响应仅表示设备服务已接受请求。请轮询 /cloudphone/live/status 直到 liveStatus 为 1。
  • 说明：仅支持 MP4 的限制在上传文件时校验，不在本接口。
  • 重试：没有去重；重复调用会再次下发开始命令。

已记录的业务错误码：33300, 33301, 33401, 33418。 各错误码的含义见 Error Codes。任何接口还可能返回通用错误码。

Security
Authorization
Bodyapplication/jsonrequired
phoneIdstringrequired

Cloud phone ID

Example:"190000000000000001"
fileIdstringrequired

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

Example:"820000000000000001"
POST
/cloudphone/live/start
curl -i -X POST \
  https://api.morelogin.com/cloudphone/live/start \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -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"
}