# 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](/vi/api-reference/getting-started/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.

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

