# ライブ配信を開始

アップロード済みの MP4 をクラウドフォンでライブ配信します。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されておらず、そのデバイスサービスがライブ配信に対応していること。`fileId` はライブ配信メディアとしてアップロードが完了したファイルを指す必要があり、それ以外は無効または期限切れとして拒否されます。
- **完了シグナル**：**受理されただけで、完了ではありません。** レスポンスはデバイスサービスがリクエストを受け取ったことのみを示します。`/cloudphone/live/status` をポーリングし、`liveStatus` が `1` になるまで待ちます。
- **補足**：MP4 のみという制限は、ここではなくファイルのアップロード時に適用されます。
- **リトライ**：重複排除はありません。再呼び出しは開始コマンドを再発行します。

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

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