跳转到内容
API 参考
/
/
/
云手机截屏

云手机截屏

Request

截取云手机屏幕并返回下载地址。

  • 前置条件：云手机必须已开机且未被其他成员占用。仅兼容机型支持，不兼容机型会拒绝该调用。
  • 副作用：在部分机型上，截图文件在拍摄后会从设备中删除。
  • 完成信号：同步。响应包含临时图片下载地址。
  • 注意：在部分机型上返回的过期时间是响应时刻起固定一小时、success 恒为 true——它不是真实的签名有效期。请及时下载，不要存这个 URL。
  • 重试：除截图本身外没有副作用，可以安全重复调用。
Bodyapplication/jsonrequired
idstringrequired

云手机 ID

Example:"1558968155668507"
curl -i -X POST \
  http://127.0.0.1:40000/api/cloudphone/screenCap \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1558968155668507"
  }'

Responses

成功。data 是对象，包含字段 url、status、expireAt、success。

Bodyapplication/json
codeinteger

响应码：0 = 成功，>0 = 失败

dataobject
msgstring or null

错误信息；code > 0 时返回

requestIdstring

请求唯一标识；联系支持时请提供

Response
{
  "code": 0,
  "data": {
    "url": "http://oss.morelogin.com/test.png",
    "status": "finish",
    "expireAt": "1756024767163",
    "success": true
  },
  "msg": null,
  "requestId": "0d8b6f1c-9f4e-4d02-9d1a-7c3f5a1b2c3d"
}