產生一張雲手機的截屏圖片,非同步介面。
介面說明
建立一張雲手機的截屏圖片並上傳到預設的 OSS 桶,介面返回 TaskId,可以通過 DescribeTasks 介面查詢截圖的下載連結。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| AndroidInstanceIdList |
array |
是 |
執行個體 ID 列表,支援批量截圖。 |
|
|
string |
是 |
執行個體 ID。 |
acp-ig2bdpk374l12**** |
|
| OssBucketName |
string |
否 |
自訂 OSS 桶,桶名必須“cloudphone-saved-bucket-”為首碼,雲手機執行個體和 OSS 桶地區需要保持一致。空預設建立桶“cloudphone-saved-bucket-{雲手機所在地區}-{AliUid}”。 |
cloudphone-saved-bucket-cn-shanghai-default |
| SkipCheckPolicyConfig |
string |
否 |
是否跳過截圖策略控制,預設 false。 |
false |
| ScreenshotId |
string |
否 |
截屏 ID。產生的截屏圖片命名為“ ScreenshotId_AndroidInstanceId.png”。 重要 ScreenshotId 長度為 2~128 個字元,以英文字母或中文開頭,不能以 http://和 https://開頭,可包含數字、底線(_)和短劃線(-)。 |
image |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
PlainResult |
||
| RequestId |
string |
請求唯一 ID,如果遇到問題請提供這個請求 ID,由工作人員為您排查。 |
3AF82CE1-2801-52CE-BF64-B491DD7C**** |
| Tasks |
array<object> |
工作清單。 |
|
|
object |
任務。 |
||
| AndroidInstanceId |
string |
執行個體 ID。 |
acp-bwhtebzah2fse**** |
| TaskId |
string |
任務 ID。通過 TaskId 可以調用 DescribeTasks 介面查詢當前執行個體的截圖任務,當任務完成可以拿到截圖的下載連結。 |
t-imr0fufqd7cle**** |
| ScreenshotId |
string |
截屏 ID。產生的截屏圖片命名為“ ScreenshotId_AndroidInstanceId.png”。 |
image |
樣本
正常返回樣本
JSON格式
{
"RequestId": "3AF82CE1-2801-52CE-BF64-B491DD7C****",
"Tasks": [
{
"AndroidInstanceId": "acp-bwhtebzah2fse****",
"TaskId": "t-imr0fufqd7cle****",
"ScreenshotId": "image"
}
]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。