检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
如何调用API 构造请求 认证鉴权 返回结果
云手机查询接口调用出错如何处理？ 接口调用出错将无法获取建立相应隧道连接的必要信息，将无法正常连接云手机设备实例，具体报错示例如下： unable to connect to xxxx:xxxx: An error occurred when calling the Cloud Phone
起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头中，从而通过身份认证，获得操作API的权限。Token可通过调用获取用户Token接口获取。 调用本服务API需要
云手机服务器与其他服务的关系 云手机服务器与周边服务的依赖关系如图1所示。 图1 云手机服务器与其他服务的关系示意图 云手机服务器与其他服务的关系 表1 云手机服务器与其他服务的关系 服务名称 云手机服务器与其他服务的关系 主要交互功能 弹性云服务器 弹性云服务器可作为内网方式连
体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见返回值。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。 对于获取用户
构造请求 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户来说明如何调用API，该API获取用户的Token，Token可以用于调用其他API时鉴权。 您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。
可通过以下三种方式在云手机中执行appctrl命令： 通过ADB连接云手机执行命令，请参考一键式ADB连接 。 调用API接口在云手机中执行命令，请参考执行异步adb命令 。 云手机中的业务程序或脚本直接调用appctrl命令。 需确保业务程序或脚本具备root用户权限。 父主题： appctrl命令
错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 CPS.0002 Parameter: offset or limit is invalid. 参数错误：分页参数非法。 请填写正确的参数。
API概览 通过调用云手机服务器服务提供的接口，您可以完整地使用云手机的所有功能。例如查询云手机列表、重启云手机、为云手机推送文件。 表1 云手机服务器接口说明 类型 子类型 说明 云手机服务器 云手机服务器管理 包括查询云手机服务器列表、查询云手机服务器规格列表、购买云手机服务器等接口。
关文档。 功能说明 虚拟摄像头 支持调用云手机侧音视频接口启动虚拟摄像头，获取摄像头信息，配置摄像头参数，关闭虚拟摄像头等。 虚拟麦克风 支持调用云手机侧音视频接口启动麦克风/开始录音，设置录音参数，关闭麦克风/关闭录音。 虚拟陀螺仪 支持调用云手机侧音视频接口注入传感器数据，设置加速度传感器及精度。
本章节介绍如何通过控制台重启云手机实例。 如果采用ADB方式连接云手机，adb reboot命令不能用来重启云手机，因其可能导致云手机故障。请在控制台或调用API进行重启。调用API重启云手机的操作请参见“重启云手机”。 前提条件 重启前请确保云手机所有文件已保存，防止文件丢失。 云手机状态为“运行中”
获取项目ID 操作场景 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式： 调用API获取项目ID 从控制台获取项目ID 调用API获取项目ID 项目ID可以通过调用查询指定条件下的项目列表API获取。 获取项目ID的接口为“GET ht
SetPhysicalResolution(int width, int height, int dpi); 功能描述 设置云手机的物理分辨率或屏幕密度（在出流过程中调用该接口设置物理分辨率会失败）。 输入参数 表1 输入参数说明 参数名称 说明 width 目标屏幕宽度，默认值为当前云手机规格分辨率宽度，设置范围[240
appctrl clear 批量卸载应用 使用场景 批量卸载所有非预安装的共享应用。 使用指导 调用appctrl clear 例如：云手机中有2个非预安装共享应用，执行appctrl clear，可将2个非预安装应用批量卸载。 父主题： appctrl命令
当需要对云手机数据进行备份和恢复时，可以调用接口进行数据备份，在需要时再进行恢复，同时也可用于将一台云手机的数据恢复到其他云手机。 涉及接口 数据备份与恢复涉及的接口如下： 调用导出云手机数据接口进行数据备份。 调用恢复云手机数据接口进行数据恢复。 操作步骤 调用导出云手机数据接口进行数据备份。
仅支持包名为com.cph.config、com.cph.config.level1、com.cph.config.level2。 使用指导 调用appctrl applyConfig {配置文件包名} 例如：appctrl applyConfig com.cph.config.level2
快速入门 本节通过调用一系列云手机服务器服务的API管理云手机。 通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。 涉及API 当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X
推送应用tar包至服务器共享空间 调用接口将OBS桶内的应用tar包推送至云手机服务器共享空间。 调用示例 POST https://${CPH Endpoint}/v1/${projectId}/cloud-phone/phones/share-apps Header: Content-Type:
输入参数说明 参数名称 说明 jsonConfig 音频初始化参数json串（推荐设置为空，使用默认参数），详见表2。 callback 音频数据回调函数。 表2 jsonConfig参数说明 参数名称 参数类型 说明 audioType number 音频类型，默认为1（PCM），可设置为0（OPUS）。
输入参数 表1 输入参数说明 参数名称 说明 jsonConfig 视频初始化参数json串，详见表2。 callback 视频数据回调函数。 表2 jsonConfig参数说明 参数名称 参数类型 说明 frame_type string 出流帧类型，默认值为“h264”，可根据需要设置为“yuv”
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
