# ライブ配信状態を取得

クラウドフォンが現在ライブ配信中かどうかを報告します。
- **前提条件**
：クラウドフォンが自チームのもので、そのデバイスサービスがライブ配信に対応していること。開始・停止と異なり、起動済みである必要も、自分が占有している必要も
**ありません**
。
- **副作用**
：なし。読み取り専用。バックオフを入れれば安全にリトライできます。
- **値**
：
`liveStatus`
 は
`0`
（配信していない）または
`1`
（配信中）です。
**失敗状態は存在しません**
 — 開始が効かなかった場合も単に
`0`
 のままなので、ポーリングにはタイムアウトを設けてください。

文書化されたビジネスエラー: `33300`, `33401`。 各コードの意味は [Error Codes](/ja/api-reference/getting-started/error-codes) を参照してください。どの操作でも共通コードが返る場合があります。

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

