检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。
云手机类型 提供专业版云手机。专业版包含的云手机规格请参考实例规格。 云手机带宽 如选择的云手机规格为专业版 | 4vCPUs | 8GB | 64GB | 720，则配套2Mbps带宽。 云手机镜像 当前支持公共镜像。
在搜索栏输入应用包名可进行任务筛选，或者单击任务类型、执行状态旁的筛选按钮进行筛选。 任务列表默认展示信息包括“任务ID”、“任务类型”、“应用包名”、“云手机台数”、“下发时间”、“执行状态”等。单击任务列表右上方设置按钮，可自定义任务列表展示参数，必选与可选项详见表1。
参数 是否必选 参数类型 描述 network_type 是 String 网络类型，枚举：MOBILE_NETWORK/WIFI/WIRED，注意这三个参数都必须有，配合encoding_type必填的2种参数共6种组合，详细先看请求示例 encoding_type 是 String
云手机镜像 云手机镜像指手机运行的操作系统，如安卓系统。KooPhone目前提供谷歌原生安卓9。 通用云手机 通用云手机融合了ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，并引入华为终端丰富的应用生态，为更多带屏联网设备提供云算力和云应用的云手机服务。
适用计费项 云手机类型、实例规格、实例数量、购买时长。 云手机类型、实例规格、实例数量、使用时长。 关机计费 按订单的购买周期计费。云手机实例关机对包年/包月计费无影响。 停止计费需手动删除实例。云手机实例关机后，正常计费。 变更计费模式 不支持变更为按需计费模式。
表1 版本类型简介 版本 实例规格 特性说明 适用场景 专业版 4vCPUs | 8GB内存 | 64GB存储 | 最高分辨率720p 端云协同：基于自研端云协议、音视频渲染和编解码算法，通过端侧与云侧SDK的配合，提供高清画质和流畅操作体验。
请求Body参数 参数 是否必选 参数类型 描述 instance_ids 是 Array of strings 实例列表 响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 error_code String 响应码，错误码规范KooPhone.API.1001
参数 参数 是否必选 参数类型 描述 instance_ids 是 Array of strings 实例列表 响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者common.00000xxx
atype Integer 音频类型 address_ipv6 String 外网ipv6地址 表9 rtc 参数 参数类型 描述 ice_signaling ice_signaling object ice信令信息 表10 ice_signaling 参数 参数类型 描述 signaling_url
购买通用云手机 通用云手机类型当前有专业版，并提供不同规格的云手机实例。详细版本类型介绍请参考实例规格。 创建组织并添加部门成员 首次购买通用云手机后，管理员需创建组织、部门和成员，以便将通用云手机实例分配给部门成员使用。
状态码 错误码 错误信息 描述 处理措施 400 KOOPHONE.API.1000 请求参数错误 请求参数错误 检查请求参数类型及范围 400 KOOPHONE.API.1002 实例非同一个大区 实例非同一个大区 修改请求实例为同一个大区 401 KOOPHONE.API.1001
code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。
修订记录 发布日期 修订记录 2024-06-11 第六次正式发布。 本次变更说明如下： 更新KooPhone与CPH的区别。 2023-02-04 第五次正式发布。 本次变更说明如下： 更新KooPhone可以打电话、发短信吗？。 2023-12-11 第四次正式发布。
表1 KooPhone接口说明 类型 说明 实例执行同步命令 通过该接口可以指定云机实例同步执行adb shell命令。 实例执行异步命令 通过该接口可以指定云机实例异步执行adb shell命令。 实例执行任务查询 执行异步adb shell命令后，通过此接口查询执行结果。
名单类型 黑名单、白名单两种类型。 应用包名 本地应用程序的名称，只能由英文字符、数字、和点组成，每个标签长度为1-50个字符，最多可输入40个标签。
区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。
CmdResultWrapper object 命令执行结果 表4 CmdResultWrapper 参数 参数类型 描述 cmd_results Array of CmdResult objects 命令执行结果 表5 CmdResult 参数 参数类型 描述 instance_id
表5 CmdJob 参数 参数类型 描述 instance_id String 实例列表 job_id String 异步命令任务id 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 响应码，KOOPHONE.API.xxxx或者
URI GET /v1/instances/tasks/{task_id} 表1 路径参数 参数 是否必选 参数类型 描述 task_id 是 String 异步请求返回的任务id 请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 x-request-id 是
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
