# クラウドフォンスクリーンキャプチャ（base64レスポンス）

クラウドフォンの画面をキャプチャし、画像を base64 でインラインに返します。
- **前提条件**：クラウドフォンが起動済みで、他のメンバーに占有されていないこと。**対応機種でのみ対応** — 非対応の機種はすべて呼び出しを拒否します。
- **完了シグナル**：同期的です。失敗時は画像データではなくエラーメッセージが返るため、デコードする前に `success` を確認してください。
- **対応機種**：Android 12 と Android 15 のイメージでのみ利用可能と記載されています。
- **用途**：デバイスサービスがホストする URL に依存したくない場合は、`/cloudphone/screenCap` よりこちらを推奨します。

Endpoint: POST /api/cloudphone/screenCapBase64
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    クラウドフォンID
    Example: 1558968155668507

## Response 200:

  - `200` (unknown)
    成功。`data` は `captureBase64`、`errorMessage`、`success` のフィールドを持つオブジェクトです。

## Response 200 fields (application/json):

  - `code` (integer)
    レスポンスコード：0 = 成功、>0 = エラー

  - `data` (object)

  - `data.captureBase64` (string)
    Base64エンコードされた画像
    Example: data:image/png;base64,/9j/4AAQSkZJRgABAQAA.....

  - `data.errorMessage` (string)
    エラーメッセージ
    Example: success

  - `data.success` (boolean)
    正常に生成されたかどうか
    Example: true

  - `msg` (string | null)
    メッセージ；コード > 0 の場合に設定

  - `requestId` (string)
    リクエストの一意な識別子。サポートへの問い合わせ時に提示してください

