# Lấy trạng thái phát trực tiếp

Báo cho biết một cloud phone hiện có đang phát trực tiếp hay không.
- **Điều kiện tiên quyết**
: cloud phone phải thuộc nhóm của bạn và dịch vụ thiết bị của nó phải hỗ trợ phát trực tiếp. Khác với lệnh bắt đầu và dừng, endpoint này
**không**
 yêu cầu máy đang bật hay do bạn chiếm giữ.
- **Tác động**
: không có. Chỉ đọc. An toàn khi thử lại với thời gian chờ tăng dần có giới hạn.
- **Giá trị**
:
`liveStatus`
 bằng
`0`
 (không phát) hoặc
`1`
 (đang phát).
**Không tồn tại trạng thái thất bại**
: một lệnh bắt đầu không bao giờ có hiệu lực sẽ chỉ đứng ở
`0`
, nên hãy giới hạn vòng hỏi bằng một thời gian chờ.

Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33401`. 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/status
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

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

## 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` (object, required)

  - `data.liveStatus` (integer)
    Live status (`0` = stopped, `1` = running)
    Enum: "0", "1"

  - `data.writeFileId` (string | null)
    Current file ID, when available

  - `data.liveFilePath` (string | null)
    Current file path or URL, when available

