检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
什么是云手机服务？ 云手机服务（KooPhone）是华为云面向政企、互联网等客户推出的一款优体验、高安全云手机服务。融合ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，并引入华为终端丰富的应用生态，为更多带屏联网设备提供云算力和云应用。
支持区域： 华北-北京四 西南-贵阳一 华南-广州 华东-上海一 不支持区域： 华北-北京一 中国-香港 购买通用云手机 通用云手机 通用云手机是一种融合了ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，并引入华为终端丰富的应用生态，为更多带屏联网设备提供云算力和云应用的云手机服务
API概览 云手机服务接口的分类与说明如表1所示。 表1 KooPhone接口说明 类型 说明 实例执行同步命令 通过该接口可以指定云机实例同步执行adb shell命令。 实例执行异步命令 通过该接口可以指定云机实例异步执行adb shell命令。
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
图1 KooPhone业务架构 与云手机服务器（CPH）的差异 云手机服务器（Cloud Phone Host，简称CPH），是基于鲲鹏裸金属服务器在服务器上虚拟出N个带有原生安卓操作系统，具有虚拟手机功能的云手机服务器。简单来说，云手机服务器=云服务器+Android OS。
KooPhone服务咨询 什么是云手机服务？ 什么是区域和可用区？ 购买云手机后，需要多久可以开通成功？ KooPhone在客户端和云手机分别支持什么操作系统？ KooPhone可以打电话、发短信吗？ KooPhone与CPH的区别
API 实例管理
图解云手机服务
如何调用API 构造请求 认证鉴权 返回结果
实例管理 实例执行同步命令 实例执行异步命令 实例执行任务查询 实例视频设置 实例状态批量查询 实例批量重置 租户实例串流前获取设备的device_token 父主题： API
实例状态批量查询 功能介绍 实例状态批量查询。 调用此api的前提条件是租户需要先购买koophone云手机实例。 接口返回实例当前的状态：云机状态，0：未知，1： 已停止，2：运行中，3：下线中，4：启动中， 5：已关机。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权
签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 父主题： 如何调用API
请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。
实例视频设置 功能介绍 实例视频设置。 调用此api的前提条件是租户需要先购买koophone云手机实例。 使用该接口可以设置实例每一个清晰度对应的码率和出流的帧率。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例
429 Too Many Requests 服务器会对接口进行流控，超过了接口限流要求，服务器将无法处理。 500 Internal Server Error 服务器遇到了一个未曾预料的状况，导致了它无法完成对请求的处理。
实例批量重置 功能介绍 实例批量重置， 调用此api的前提条件是租户需要先购买koophone云手机实例。 调用该接口后，当前实例会被初始化。 调试 您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能
实例执行异步命令 功能介绍 实例执行异步命令接口。 调用此api的前提条件是租户需要先购买koophone云手机实例。 可以通过调用该接口实现对自己的koophone云手机实例进行异步adb指令操作。 调用完该接口后携带该接口返回的task_id去调用实例执行任务查询接口。 调试
附录 状态码 错误码 获取项目ID
在调用云手机服务API之前，请确保已经充分了解云手机服务相关概念。详细信息请参见云手机服务的《产品介绍》。另外，云手机服务提供了REST（Representational State Transfer）风格API，支持您通过HTTPS请求调用，调用方法请参见如何调用API。
返回结果 状态码 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
