检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
时水印等安全特性，严格管控数据外泄；在云侧具备数据统一监控、安全加固，应用集中管理、一键分发、统一升级，系统漏洞和安全威胁统一修复和防范；提供比一般办公软件更便捷的接入方式、更丰富的应用生态，企业员工可以随时随地使用手机接入云手机，实现消息处理、视频会议等安全的移动办公。 远程客服协助
和云OS的丰富应用，提供优成本、丰富应用生态和优致用户体验。 您可以使用本文档提供的API对云手机服务进行相关操作。如视频设置、批量重置等。支持的全部操作请参见API概览。 在调用云手机服务API之前，请确保已经充分了解云手机服务相关概念。详细信息请参见云手机服务的《产品介绍》。
AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和
实例执行异步命令接口。 调用此api的前提条件是租户需要先购买koophone云手机实例。 可以通过调用该接口实现对自己的koophone云手机实例进行异步adb指令操作。 调用完该接口后携带该接口返回的task_id去调用实例执行任务查询接口。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的获取用户Token接口说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987
功能介绍 实例执行任务批量查询。 调用此api的前提条件是租户需要先购买koophone云手机实例。 该接口需要和实例执行异步命令接口一起使用，使用实例执行异步命令接口返回的task_id作为路径上的参数以此获取异步命令执行的结果。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
API 实例管理 实例使用
租户实例串流前获取设备的device_token， 调用此api的前提条件是租户需要先购买koophone云手机实例。 调用该接口获取云机实例的device_token后作为鉴权信息，并携带云机实例的device_id去调用反参中的信令地址（signaling_url）。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
API概览 云手机服务接口的分类与说明如表1所示。 表1 KooPhone接口说明 类型 说明 实例执行同步命令 通过该接口可以指定云机实例同步执行adb shell命令。 实例执行异步命令 通过该接口可以指定云机实例异步执行adb shell命令。 实例执行任务查询 执行异步adb
实例使用 租户实例串流前获取设备的device_token 父主题： API
实例管理 实例执行同步命令 实例执行异步命令 实例执行任务批量查询 实例视频设置 实例状态批量查询 实例批量重置 父主题： API
如何调用API 构造请求 认证鉴权 返回结果
对于获取用户Token接口，返回如图1所示的消息头，其中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。 图1 获取用户Token响应消息头 响应消息体 响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。
实例批量重置 功能介绍 实例批量重置， 调用此api的前提条件是租户需要先购买koophone云手机实例。 调用该接口后，当前实例会被初始化。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
实例视频设置 功能介绍 实例视频设置。 调用此api的前提条件是租户需要先购买koophone云手机实例。 使用该接口可以设置实例每一个清晰度对应的码率和出流的帧率。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
实例状态批量查询。 调用此api的前提条件是租户需要先购买koophone云手机实例。 接口返回实例当前的状态：云机状态，0：未知，1： 已停止，2：运行中，3：下线中，4：启动中， 5：已关机。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explore
实例执行同步命令接口。调用此api的前提条件是租户需要先购买koophone云手机实例。可以通过调用该接口实现对自己的koophone云手机实例进行adb指令操作。 该接口是同步操作接口，如果有耗时adb操作建议使用实例执行异步命令接口。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API
实例规格 通用云手机 通用云手机分为专业版和企业版，每个版本提供不同规格的云手机实例，当前仅提供专业版，详细介绍请参考表1。 表1 版本类型简介 版本 实例规格 特性说明 适用场景 专业版 4vCPUs | 8GB内存 | 64GB存储 | 最高分辨率720p 端云协同：基于自研
附录 状态码 错误码 获取项目ID
状态码 常用状态码请参见表1。 表1 请求状态返回码 状态码 描述 说明 200 OK 资源获取成功。 201 Created 资源创建成功。 202 Accepted 已经接受处理。 204 No Content 操作成功，但无数据。 400 Bad Request 请求内容缺失或无效的请求内容。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
