# 云手机截屏（返回base64）

截取云手机屏幕并以 base64 内联返回图片。
- **前置条件**：云手机必须已开机且未被其他成员占用。**仅兼容机型支持**——不兼容机型都会拒绝该调用。
- **完成信号**：同步。失败时响应携带错误信息而不是图片数据，所以解码前请先检查 `success`。
- **机型支持**：文档记载仅 Android 12 与 Android 15 镜像可用。
- **用途**：当你不想依赖设备服务托管的 URL 时，优先用本接口而不是 `/cloudphone/screenCap`。

Endpoint: POST /cloudphone/screenCapBase64
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## 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)
    请求唯一标识；联系支持时请提供