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

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](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

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

## 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