全部产品
Search
文档中心

Cloud Phone:CreateScreenshot

更新时间:Dec 21, 2025

Operasi API asinkron ini menghasilkan tangkapan layar dari cloud phone.

Deskripsi operasi

Operasi ini membuat tangkapan layar dari cloud phone dan mengunggahnya ke bucket Object Storage Service (OSS) default. Operasi ini mengembalikan ID task. Anda kemudian dapat memanggil operasi DescribeTasks untuk mengambil tautan unduhan tangkapan layar tersebut.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

AndroidInstanceIdList

array

Yes

Daftar ID instans. Tangkapan layar batch didukung.

string

Yes

ID instans.

acp-ig2bdpk374l12****

OssBucketName

string

No

Bucket OSS kustom. Nama bucket harus diawali dengan awalan cloudphone-saved-bucket-. Instans cloud phone dan bucket OSS harus berada di wilayah yang sama. Jika Anda mengosongkan parameter ini, bucket default bernama cloudphone-saved-bucket-{RegionOfCloudPhone}-{AliUid} akan dibuat.

cloudphone-saved-bucket-cn-shanghai-default

SkipCheckPolicyConfig

string

No

Menentukan apakah pemeriksaan kebijakan tangkapan layar dilewati. Nilai default-nya adalah false.

false

ScreenshotId

string

No

ID tangkapan layar. Tangkapan layar yang dihasilkan diberi nama "ScreenshotId_AndroidInstanceId.png."

Penting

ScreenshotId harus terdiri dari 2 hingga 128 karakter, dimulai dengan huruf, tetapi tidak boleh diawali dengan http:// atau https://. Karakter yang diizinkan meliputi huruf, angka, garis bawah (_), dan tanda hubung (-).

image

Elemen respons

Element

Type

Description

Example

object

PlainResult<integer>

RequestId

string

ID unik dari permintaan. Jika Anda mengalami masalah, berikan ID permintaan ini untuk troubleshooting.

3AF82CE1-2801-52CE-BF64-B491DD7C****

Tasks

array<object>

Daftar task.

object

Tugas.

AndroidInstanceId

string

ID instans.

acp-bwhtebzah2fse****

TaskId

string

ID task. Anda dapat menggunakan ID ini untuk memanggil operasi DescribeTasks dan menanyakan task tangkapan layar. Setelah task selesai, Anda dapat memperoleh tautan unduhan tangkapan layar tersebut.

t-imr0fufqd7cle****

ScreenshotId

string

ID tangkapan layar. Tangkapan layar yang dihasilkan diberi nama "ScreenshotId_AndroidInstanceId.png."

image

Contoh

Respons sukses

JSONformat

{
  "RequestId": "3AF82CE1-2801-52CE-BF64-B491DD7C****",
  "Tasks": [
    {
      "AndroidInstanceId": "acp-bwhtebzah2fse****",
      "TaskId": "t-imr0fufqd7cle****",
      "ScreenshotId": "image"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.