# 查询直播状态

查询云手机当前是否正在直播。
- **前置条件**：云手机必须属于你的团队，且机型必须支持直播。与开始和停止不同，本接口**不要求**云手机已开机或被你占用。
- **副作用**：无。只读。可带退避安全重试。
- **取值**：`liveStatus` 为 `0`（未直播）或 `1`（直播中）。**没有失败状态**——未生效的开始只会一直停在 `0`，所以轮询必须设超时上限。

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

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