# 开始直播

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

已记录的业务错误码：`33300`, `33301`, `33401`, `33418`。 各错误码的含义见 [Error Codes](../Getting%20Started/error-codes.md)。任何接口还可能返回通用错误码。

Endpoint: POST /cloudphone/live/start
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `phoneId` (string, required)
    Cloud phone ID
    Example: 190000000000000001

  - `fileId` (string, required)
    ID of an uploaded MP4 live-streaming file (`uploadType=2`)
    Example: 820000000000000001

## Response 200:

  - `200` (unknown)
    Request processed; inspect `code` for the business result

## Response 200 fields (application/json):

  - `code` (integer, required)
    Business result code; `0` indicates success
    Example: 0

  - `msg` (string | null, required)
    Error message; null when successful
    Example: null

  - `requestId` (string, required)
    Request ID for troubleshooting
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (boolean, required)
    Whether the live-streaming operation succeeded