# 云手机服务器 CPH

> 具有虚拟手机功能的云服务器

## 产品介绍

- [什么是云手机服务器？](https://support.huaweicloud.com/productdesc-cph/cph_prod_0002.md): 云手机服务器（Cloud Phone Host，简称CPH），是基于华为云鲲鹏裸金属服务器在服务器上虚拟出N个带有原生安卓操作系统，具有虚拟手机功能的云手机服务器。简单来说，云手机服务器=云服务器+Android OS。您可以远程实时控制云手机，实现安卓APP的云端运行；也可以基于云手机服务器的基础算力，高效搭建应用，如云游戏、移动办公、
- [产品优势](https://support.huaweicloud.com/productdesc-cph/cph_prod_0006.md): 云手机服务器作为一种新型服务，依靠华为云的服务器底座、创新技术及周边服务的天然优势，让移动应用可以在云端智能运行。相比常见的手机模拟方案，云手机在性能、兼容性、稳定性等方面均有突出的表现，详见本章节描述。公有云业界首家ARM-Based云手机服务器解决方案，端云同构，原生应用运行无需指令集翻译，手机应用高度兼容，运行性能可以较x86模拟器
- [应用场景](https://support.huaweicloud.com/productdesc-cph/cph_prod_0009.md): 云游戏作为游戏行业的热门发展方向，通过视频流化的方式面向玩家提供免下载，脱离手机性能的一种游戏服务方式，其本身包含了PC游戏的流化和移动游戏的流化。云手机服务器作为云端仿真手机可以发挥移动游戏指令同构的优势，在云端承载游戏应用。架构说明：手机游戏APP安装在云手机当中，通过将云手机的音视频画面进行流化编码输出到客户端进行显示，同时接收客户
- [云手机服务器规格](https://support.huaweicloud.com/productdesc-cph/cph_prod_0004.md): 云手机服务器提供软件定义手机的能力，模拟真机的传感器、网络等关键软/硬件，适用于APP自动化测试、移动办公等场景。“手机开数”是指一台服务器可以虚拟出的云手机数量。例如：手机开数为60，表示购买一台服务器，实际可以得到60台云手机。手机磁盘存储大小以及网络等其他配置可在购买时自定义。
- [RX7云手机服务器（公测）](https://support.huaweicloud.com/productdesc-cph/cph_prod_0015.md): 全新一代RX7旗舰级云手机服务器，软硬件全面升级，搭载鲲鹏高性能处理器和专业级GPU，面向云游戏场景提供最高2K 60FPS高清画质，稳定高帧率的畅玩体验。基于华为云QingTian极简虚拟化架构的全面加持，RX7整机可支持高达224路云游戏部署，云手机密度较上一代提升50%，成本及综合性价比更优，现已开放公测。RX7云手机服务器正在公测
- [服务的访问控制](https://support.huaweicloud.com/productdesc-cph/cph_prod_1103.md): 云手机服务器支持通过IAM进行精细的权限管理，实现用户身份认证、权限分配、访问控制等功能，可以帮助您安全地控制资源的访问。您可以在账号中创建IAM用户，并授权控制他们对资源的访问范围。IAM权限是作用于云资源的，IAM权限定义了允许和拒绝的访问操作，以此实现云资源权限访问控制。权限管理简介，请参见CPH权限管理。授权使用CPH，请参见创建
- [数据保护技术](https://support.huaweicloud.com/productdesc-cph/cph_prod_1104.md): 云手机服务器通过多种数据保护手段和特性，保障存储数据的安全可靠。云手机服务器底层为裸金属服务器，具备物理机级的性能和隔离性，用户独占计算资源，并且无任何虚拟化开销。云手机服务器提供备份与恢复接口，支持客户将重要数据备份到自己的OBS桶（导出云手机数据），也支持客户将OBS桶的备份数据还原到指定云手机（恢复云手机数据 ）。为了保障云手机用户
- [审计与日志](https://support.huaweicloud.com/productdesc-cph/cph_prod_1105.md): 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。用户开通云审计服务后，CTS可记录CPH的操作事件用于审计。CTS的详细介绍和开通配置方法，请参见入门指引。CPH支持审计的
- [监控安全风险](https://support.huaweicloud.com/productdesc-cph/cph_prod_1106.md): 当您购买云手机服务器后，无需额外安装其他插件，即可在云监控服务查看云手机服务器及关联资源（磁盘及GPU卡）的监控数据，还可以获取可视化监控图表。CPH支持的监控指标请参见支持的监控指标。CPH支持的事件监控请参见支持的事件监控。如何查看监控指标请参见查看监控指标。如何创建告警规则请参见创建告警规则。
- [认证证书](https://support.huaweicloud.com/productdesc-cph/cph_prod_1107.md): 华为云服务及平台通过了多项国内外权威机构（ISO/SOC/PCI等）的安全合规认证，用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求，具体请查看资源中心。资源中心华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书，供用户下载和参考。具体请查看合规资质证书。网络安全专用产品安全检测证书
- [计费说明](https://support.huaweicloud.com/productdesc-cph/cph_prod_0011.md): 本小节主要介绍云手机服务器的计费说明，包括计费项、计费模式等。CPH计费项如图1所示，各计费项的详细说明请参见表1。服务器计费模式为包年包月付费，不支持按量付费。对于长期使用者，推荐包年购买。如果需要为某一台服务器续费，请勾选后单击列表左上方的“续费”，跳转至续费管理页面完成续费。更多信息（自动续费、导出续费清单、变更资费等）请参见续费管
- [CPH权限管理](https://support.huaweicloud.com/productdesc-cph/cph_prod_0008.md): 如果您需要对华为云上的云手机服务器（Cloud Phone Host，CPH）资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为
- [基本概念](https://support.huaweicloud.com/productdesc-cph/cph_qs_0004.md): 本文介绍使用云手机服务器服务时需要了解的基本概念。服务器是用来提供云手机的物理服务器。云手机服务器目前以服务器为单位购买，您只需要指定具体的服务器类型、实例规格、手机镜像、所需要的网络配置等，即可获得一台服务器，以及相应数量的云手机。具体请参见购买云手机服务器。手机开数是云手机的一种规格参数，指一台服务器可以虚拟出的云手机数量。例如：手机
- [区域和可用区](https://support.huaweicloud.com/productdesc-cph/cph_prod_0007.md): 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Reg
- [约束与限制](https://support.huaweicloud.com/productdesc-cph/cph_prod_0010.md): 本文介绍云手机服务器（CPH）在使用过程中的约束和限制。客户不能使用华为云资源进行黑产，违规以及违反华为安全要求等行为，违反相关要求账户会被受限/冻结。华为云账户受限/冻结或者云手机资源进入保留期时，云手机使用会受到限制，客户应提前了解处理，避免造成业务中断。客户华为云账户因余额不足等原因导致账号受限时，无法进行云手机资源操作（包括但不限
- [云手机服务器与其他服务的关系](https://support.huaweicloud.com/productdesc-cph/cph_prod_0003.md): 云手机服务器与周边服务的依赖关系如图1所示。

## 计费说明

- [云手机服务器计费概述](https://support.huaweicloud.com/price-cph/cph_billing_0000.md): 通过阅读本文，您可以快速了解云手机服务器CPH的计费模式、计费项、续费、欠费等主要计费信息。计费模式云手机服务器计费模式为包年包月付费，不支持按量付费。对于长期使用者，推荐包年购买。关于计费模式的详细介绍请参见云手机服务器计费模式概述。云手机服务器计费模式为包年包月付费，不支持按量付费。对于长期使用者，推荐包年购买。关于计费模式的详细介绍
- [云手机服务器计费模式概述](https://support.huaweicloud.com/price-cph/cph_billing_2001.md): 云手机服务器计费模式为包年包月付费，不支持按量付费。对于长期使用者，推荐包年购买。如您需要快速了解CPH服务不同计费模式的具体价格，请参见CPH价格详情。包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。
- [包年/包月](https://support.huaweicloud.com/price-cph/cph_billing_2002.md): 包年/包月是一种先付费再使用的计费模式，适用于对资源需求稳定且希望降低成本的用户。通过选择包年/包月的计费模式，您可以预先购买云服务资源并获得一定程度的价格优惠。本文将介绍包年/包月CPH资源的计费规则。包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景：稳定业务需求
- [计费项](https://support.huaweicloud.com/price-cph/cph_billing_3000.md): 云手机服务器的计费项由服务器费用、公网带宽费用和云硬盘费用组成。具体内容如表1所示。如您需要快速了解CPH服务的具体价格，请参见CPH价格详情。
- [续费概述](https://support.huaweicloud.com/price-cph/cph_billing_6001.md): 包年/包月云手机服务器到期后会影响云手机服务器正常运行。如果您想继续使用，需要在指定的时间内为云手机服务器续费，否则vCPU、内存、云硬盘等资源会自动释放，数据丢失且不可恢复。续费操作仅适用于包年/包月云手机服务器，只需要保证账户余额充足，若账户余额不足可进行充值，详细内容，请参见账户充值。云手机服务器在到期前续费成功，所有资源得以保留，
- [手动续费](https://support.huaweicloud.com/price-cph/cph_billing_6002.md): 包年/包月云手机服务器从购买到被自动删除之前，您可以随时在CPH控制台为云手机服务器续费，以延长云手机服务器的使用时间。进入“续费管理”页面。可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动
- [自动续费](https://support.huaweicloud.com/price-cph/cph_billing_6003.md): 自动续费可以减少手动续费的管理成本，避免因忘记手动续费而导致云手机服务器被自动删除。自动续费的规则如下所述：以云手机服务器的到期日计算第一次自动续费日期和计费周期。云手机服务器自动续费周期根据开通自动续费的不同途径，遵循不同的规则。在云手机服务器到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00
- [费用账单](https://support.huaweicloud.com/price-cph/cph_billing_7000.md): 您可以在“费用中心 > 账单管理”查看资源的费用账单，以了解该资源在某个时间段的使用量和计费信息。包年/包月：包年/包月计费模式的资源完成支付后，会实时上报一条账单到计费系统进行结算。进入云手机服务器列表页面。进入账单概览页面。这里设置的统计维度为“按资源名称/ID”，统计周期为“按账期”，您也可以设置其他统计维度和周期，详细介绍请参见流
- [欠费说明](https://support.huaweicloud.com/price-cph/cph_billing_8000.md): 用户在使用云手机服务器时，账户的可用额度小于待结算的账单，即被判定为账户欠费。欠费后，可能会影响云手机服务器资源的正常运行，请及时充值。已购买包年/包月的云手机服务器，因持续性周期扣款而导致账户的余额不足。删除包年/包月的云手机服务器后，因存在未删除的关联资源（如云硬盘、EIP）持续扣费而导致账户的余额不足。包年/包月对于包年/包月CPH
- [停止计费](https://support.huaweicloud.com/price-cph/cph_billing_9000.md): 对于包年/包月计费模式的资源，例如包年/包月的云手机服务器、包年/包月的云硬盘等，用户在购买时会一次性付费，服务将在到期后自动停止使用。如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订。如果您已开启“自动续费
- [计费FAQ](https://support.huaweicloud.com/price-cph/cph_billing_11000.md): 云手机服务器的收费标准是什么？服务器到期了，多久会释放资源？购买服务器后，需要多久开通成功？云手机服务器资源冻结/释放/退订常见问题

## 快速入门

- [购买云手机服务器](https://support.huaweicloud.com/qs-cph/cph_qs_0003.md): 您在了解云手机服务器的优势和应用场景后，如果想体验云手机服务器的功能，或者需要部署真实的业务，建议您参考本节操作购买云手机服务器。操作流程如图1所示。准备工作包含两项任务：注册华为云账号并实名认证；创建密钥对。其中，密钥对用于鉴权，在购买服务器时要选择一个密钥对，以便连接云手机（建立SSH隧道）时使用。打开https://www.huaw

## 用户指南

- [购买云手机服务器](https://support.huaweicloud.com/usermanual-cph/cph_ug_0002.md): 云手机实例是以整台服务器的形式购买的，在购买时选择不同手机开数的实例规格，最终可获得的云手机数量也不一样。本章节将为您详细介绍购买云手机实例的操作步骤。登录CPH控制台，进入购买云手机服务器页面。根据界面提示，完成基础配置，如表1。基础配置参数说明参数参数说明样例计费模式服务器仅支持一种计费类型：包年/包月。包年/包月区域不同区域的云服务
- [连接方式简介](https://support.huaweicloud.com/usermanual-cph/cph_ug_0012.md): 您可以通过ADB方式连接云手机实例。ADB方式：Android Debug Bridge（简称ADB），是一个Android操作系统与桌面电脑间沟通的命令行工具，是安卓系统自带的独有应用。该方式使用命令行操作云手机，适用于APP自动化测试等场景。
- [一键式ADB连接（推荐）](https://support.huaweicloud.com/usermanual-cph/cph_ug_0017.md): 云手机实例购买成功后，您可以使用控制台的ADB连接方式快速连接云手机。此方法相当于ADB方式（公网）方式的便捷版，连接原理一致。云手机实例状态必须为“运行中”。登录CPH控制台，进入实例管理页面。在云手机列表，选择一台云手机实例，单击右侧“操作”列的“更多 > ADB公网连接”。进入右侧面板。进入右侧面板。输入服务器的密钥对所对应的私钥文
- [ADB方式（内网）](https://support.huaweicloud.com/usermanual-cph/cph_ug_0004.md): 通过内网连接云手机实例时，需要在您已有的VPC中创建一台弹性云服务器，作为连接云手机的跳板机器。根据服务器使用的网络类型不同，可区分为系统定义网络和自定义网络两种场景，如图1所示，用户可在服务器详情页面，查询当前云手机服务器使用的网络类型。若云手机服务器使用自定义网络，建议弹性云服务器和云手机服务器分配在同一个VPC。若弹性云服务器和云手
- [ADB方式（公网）](https://support.huaweicloud.com/usermanual-cph/cph_ug_0010.md): 通过公网连接云手机实例时，弹性公网IP绑定在服务器上，因此需要先建立SSH隧道，即ADB方式（公网）包括两个步骤：建立SSH隧道；通过ADB连接云手机。关于SSH隧道和ADB的介绍请参见“基本概念”。用于连接云手机的设备可以为本地设备，也可以是云上的机器，推荐您使用本地设备。本地设备的操作系统不限，Windows、Linux、Androi
- [查看云手机实例详情](https://support.huaweicloud.com/usermanual-cph/cph_ug_0025.md): 本章节介绍如何通过控制台查看云手机实例的详细信息。登录CPH控制台，进入实例管理页面。在云手机列表，选择一个云手机实例，单击其名称进入详情页面。您可以查看云手机的如下信息：基本信息包括实例名称、状态、手机ID、IMEI、镜像ID等。IMEI为国际移动设备识别码（International Mobile Equipment Identity
- [重启云手机实例](https://support.huaweicloud.com/usermanual-cph/cph_ug_0007.md): 本章节介绍如何通过控制台重启云手机实例。如果采用ADB方式连接云手机，adb reboot命令不能用来重启云手机，因其可能导致云手机故障。请在控制台或调用API进行重启。调用API重启云手机的操作请参见“重启云手机”。重启前请确保云手机所有文件已保存，防止文件丢失。云手机状态为“运行中”或“关机”才能进行重启。其他状态，比如“故障”、“关
- [重置云手机实例](https://support.huaweicloud.com/usermanual-cph/cph_ug_0008.md): 云手机重置指将云手机的操作系统恢复到初始状态，云手机产生的所有数据也会被删除。一般适用于云手机系统崩溃且无法恢复的场景。云手机重置后无法恢复，请谨慎操作。登录CPH控制台，进入实例管理页面。在云手机列表，选择一个需重置的云手机实例，单击右侧“操作”列的“重置”。选择多个需重置的云手机实例，单击实例列表左上方的“重置”。选择一个需重置的云手
- [关闭云手机实例](https://support.huaweicloud.com/usermanual-cph/cph_ug_0019.md): 本章节介绍如何通过控制台关闭云手机实例。关机前请确保云手机所有文件已保存，防止文件丢失。云手机状态为“运行中”才能进行关机。其他状态，比如“故障”、“创建中”等均不能进行关机。登录CPH控制台，进入实例管理页面。在云手机列表，选择一个需关闭的云手机实例，单击右侧“操作”列的“更多 > 关机”。选择多个需关闭的云手机实例，单击实例列表左上方
- [修改云手机实例名称](https://support.huaweicloud.com/usermanual-cph/cph_ug_0024.md): 本章节介绍如何通过控制台修改云手机实例的名称。登录CPH控制台，进入实例管理页面。在云手机列表，选择需要修改名称的云手机实例，单击名称旁的图标，输入新名称。名称必须符合如下规范：只能由英文字母、数字、中文字符、-、和_组成，且长度为1-60个字符修改云手机实例名称名称必须符合如下规范：只能由英文字母、数字、中文字符、-、和_组成，且长度为
- [更新云手机实例属性](https://support.huaweicloud.com/usermanual-cph/cph_ug_0026.md): 本章节介绍如何通过控制台更新云手机实例的属性，比如产品型号、设备型号、是否隐藏虚拟键、是否横屏显示等。当前AOSP14镜像不支持属性通过这种方式修改。登录CPH控制台，进入实例管理页面。在云手机列表，选择需要更新属性的云手机实例，单击右侧“操作”列的“更新云手机属性”。在右侧面板中，勾选属性ID，修改对应的属性值，单击“确定”。更新云手机
- [批量控制](https://support.huaweicloud.com/usermanual-cph/cph_ug_0003.md): CPH服务提供云手机批量控制功能，该功能可以通过ADB命令API将存放在OBS桶中的APK安装文件等，批量推送或安装到云手机中，便捷用户操作，提升管理效率。本章节通过批量安装APK的示例来介绍批量控制功能。安装和更新APK有以下两种方式：通过API执行install命令进行操作，详情请参考安装apk。用户先完成CPH服务操作OBS桶的委托
- [修改服务器名称](https://support.huaweicloud.com/usermanual-cph/cph_ug_server_name.md): 本章节介绍如何通过控制台修改服务器的名称。登录CPH控制台，进入服务器管理页面。在服务器列表，选择需要修改名称的服务器，单击名称旁的图标，输入新名称。名称必须符合如下规范：只能由英文字母、数字、中文字符、-、和_组成，且长度为1-60个字符修改服务器名称名称必须符合如下规范：只能由英文字母、数字、中文字符、-、和_组成，且长度为1-60个
- [重启服务器](https://support.huaweicloud.com/usermanual-cph/cph_ug_0020.md): 本章节介绍如何通过控制台重启服务器。重启服务器时，可以批量更换云手机镜像。重启服务器会造成云手机断开连接，请提前保存数据。登录CPH控制台，进入服务器管理页面。在服务器列表，选择一个需重启的服务器，单击右侧“操作”列的“更多 > 重启”。选择多个需重启的服务器，单击列表左上方的“重启”。选择一个需重启的服务器，单击右侧“操作”列的“更多 
- [退订服务器](https://support.huaweicloud.com/usermanual-cph/cph_ug_0022.md): 服务器的计费方式为“包年/包月”，如果在计费周期内不想再继续使用，请参考本节指导进行退订。执行退订操作前，请确保待退订的服务器数据已完成备份或者迁移，退订完成后资源将被完全删除，且不可恢复，请谨慎操作。退订包周期资源是指退订续费部分（如果已续费）和当前正在使用的部分，资源退订后将无法使用。未生效的续费周期退订时不扣除手续费，其他情况退订需
- [续费服务器](https://support.huaweicloud.com/usermanual-cph/cph_ug_0023.md): 服务器的计费方式为“包年/包月”，在资源到期前，如果还想继续使用，请参考本节指导进行续费。登录CPH控制台，进入服务器管理页面。在服务器列表，选择一个或多个需要续费的服务器，单击列表左上方的“续费”。在右侧面板中，单击“确定”，跳转至“续费”页面。选择续费时长，单击“去支付”，按界面提示进行付款。
- [更换弹性公网IP](https://support.huaweicloud.com/usermanual-cph/cph_ug_0055.md): 您现在可以自行更换CPH服务器的弹性公网IP。您可以选择通过控制台或者调用API接口进行更换EIP操作。服务器的网络类型需要是“自定义”网络。可以通过控制台进入云手机服务器详情页面查看网络类型。解绑弹性公网IP登录CPH控制台，进入服务器管理页面。在服务器列表，选择一个已经绑定了EIP的服务器，单击操作列的“更多”，在弹出的列表中单击“解
- [切换云手机服务器](https://support.huaweicloud.com/usermanual-cph/cph_ug_0070.md): 切换云手机服务器, 支持您换一台新的云手机服务器。通过切换服务器您可以调整手机规格，网络配置和磁盘大小。切换后服务器规格、名称、服务器ID和服务器所在AZ与原服务器相同，服务器计费保持不变。服务器切换的同时服务器上的手机重新创建，不保留用户数据。本章节将为您详细介绍切换云手机服务器的操作步骤。原服务器必须是包周期并且订单已完成的服务器。切
- [使用AOSP功能概述](https://support.huaweicloud.com/usermanual-cph/cph_ug_0037.md): 您可以使用云手机AOSP功能，如配置自己的init.rc，隐藏云手机虚拟按键，设置GPS定位信息，关闭截屏保护等。在使用AOSP功能之前，请确保已经充分了解云手机服务相关概念，详细信息请参见“产品介绍”。以下功能仅限用于容器方案云手机，qemu方案暂不支持。
- [自动对App授权](https://support.huaweicloud.com/usermanual-cph/cph_ug_0038.md): 安装App时，自动赋予应用所需权限。通过更新云手机属性API接口，设置手机属性ro.permission.changed=1。0表示不赋予权限，1表示赋予。设置立即生效。
- [摄像头加载指定图片](https://support.huaweicloud.com/usermanual-cph/cph_ug_0039.md): 摄像头加载指定图片。可用于扫码场景。例如将二维码图片注入进云手机摄像头。从最新动态里获取2020.10.9（含）后的镜像。用获取到的镜像id替换云手机镜像。您可以在console上单击重启手机按钮进行换镜像，或调用重启云手机API接口重启手机换镜像。上传图片到云手机/data/local/tmp/路径下。例如/data/local/tmp
- [云手机root权限](https://support.huaweicloud.com/usermanual-cph/cph_ug_0040.md): 安装在云手机上的应用，默认没有root权限。云手机提供为所有应用统一授予root权限，或为每个应用单独管理root权限的方法。为所有应用统一授予root权限如果您希望云手机上的所有应用都拥有root权限，请通过重启云手机API接口重启手机更新属性设置ro.com.cph.non_root=0。为每个应用单独管理root权限如果您希望云手机
- [开机回调脚本](https://support.huaweicloud.com/usermanual-cph/cph_ug_0041.md): 支持客户自定义启动脚本。客户推送自己的脚本文件到/data/local/tmp/extend_custom.sh。脚本文件路径为：/data/local/tmp/extend_custom.sh。文件属组为root:root，文件权限为 750（rwxr-x---），权限不正确会导致脚本无法执行。重启生效。脚本执行的超时时间为10s。
- [自动安装App](https://support.huaweicloud.com/usermanual-cph/cph_ug_0042.md): 安装App，当弹出系统Installer界面时，自动安装和运行应用。通过更新云手机属性API接口，设置手机属性ro.install.auto=1。0表示不自动安装，1表示自动安装。设置立即生效。
- [隐藏虚拟按键](https://support.huaweicloud.com/usermanual-cph/cph_ug_0043.md): 隐藏云手机虚拟按键。通过更新云手机属性API接口重启手机更新属性，设置手机属性com.cph.mainkeys=1。0表示不隐藏，1表示隐藏。重启生效。
- [隐藏状态栏](https://support.huaweicloud.com/usermanual-cph/cph_ug_0044.md): 隐藏云手机状态栏。通过更新云手机属性API接口重启手机更新属性，设置手机属性disable.status.bar=1。0表示不隐藏，1表示隐藏。重启生效。
- [禁用通知系统](https://support.huaweicloud.com/usermanual-cph/cph_ug_0045.md): 功能介绍禁用通知系统（包括屏幕上方弹出的消息通知和Toast），所有应用的通知都将被禁用。使用方法通过更新云手机属性API接口，设置手机属性ro.com.cph.notification_disable=1。该属性为1时，通知系统将被禁用。如果此时您想单独将Toast开关打开，请同时设置手机属性ro.com.cph.toast_enabl
- [关闭截屏保护](https://support.huaweicloud.com/usermanual-cph/cph_ug_0046.md): 某些APP，在对安全有要求的场景中，会禁止截屏。如果您接入云手机的软件是通过传输实时截屏来显示画面，此时您通过此软件看到云手机的画面可能为黑屏，需要关闭截屏保护并重启云手机后才可以看到实际画面。通过设置com.cph.disable_fb_permission=1属性，在上述场景中，您将不被限制截屏。通过重启云手机API接口重启手机更新属
- [应用安装白名单](https://support.huaweicloud.com/usermanual-cph/cph_ug_0050.md): 应用安装白名单。只有白名单里的应用允许安装。如果不配置，则可安装任何apk。客户推送配置文件到路径/data/local/config/InstallWhitelist。如果想对某一系的app全部设置白名单，配置文件中可以简写为该系app包名共同拥有的子字符串。例：A公司推出2款APP，包名分别为：com.aaa.bbb和com.aaa.
- [应用安装黑名单](https://support.huaweicloud.com/usermanual-cph/cph_ug_0051.md): 应用安装黑名单。黑名单里的应用不允许安装。如果想对某一系的app全部设置黑名单，配置文件中可以简写为该系app包名共同拥有的子字符串。例：A公司推出2款APP，包名分别为：com.aaa.bbb和com.aaa.ccc。当想同时对这两个包设置黑名单时，黑名单里可以配置：com.aaa。客户推送配置文件到路径/data/local/conf
- [强制安装32位应用](https://support.huaweicloud.com/usermanual-cph/cph_ug_0053.md): 当apk同时支持32位和64位时，云手机指定安装该apk的32位版本。客户推送配置文件到/data/local/config/use32bit，然后安装apk，32位版本的apk将被安装到云手机中。如果想变更为64位，需要删除配置，然后卸载应用重新安装。如果配置的apk不支持32位，应用将安装失败。配置格式为：${package_name
- [动态修改系统语言](https://support.huaweicloud.com/usermanual-cph/cph_ug_0061.md): 通过am命令行动态修改系统语言环境。adb shell am update-config --locale + 语言标签列表。各国语言标签。参考语言标签列表，见源码 /aosp/frameworks/base/core/res/res/values/locale_config.xml。参考语言标签列表，见源码 /aosp/framewor
- [后台进程管理](https://support.huaweicloud.com/usermanual-cph/cph_ug_0066.md): 云手机performance系统服务，自动清理后台应用进程，防止第三方应用后台自动拉起和相互唤醒，对开机速度、手机OOM、CPU高占用等现象有显著的提升和改善。performance低内存查杀策略当系统剩余空闲内存低于某阈值，将根据剩余内存档位，从高到低选择杀不同优先级的进程。策略触发条件清理进程High档总内存剩余25%空进程缓存进程M
- [纹理压缩开关](https://support.huaweicloud.com/usermanual-cph/cph_ug_0067.md): 云手机默认启用全局纹理压缩，以降低显存占用。云手机提供以命令行方式动态开关全局纹理压缩，同时提供配置应用粒度纹理压缩的黑白名单。配置应用粒度纹理压缩的黑白名单：当全局纹理压缩打开，只配置某一应用到白名单时，该应用的纹理压缩功能打开，只配置某一应用到黑名单时，该应用的纹理压缩功能关闭。当全局纹理压缩关闭，只配置某一应用到白名单时，该应用的纹
- [手机内重启](https://support.huaweicloud.com/usermanual-cph/cph_ug_0077.md): 用户在云手机内重启手机，而不用通过管理面重启手机。建议使用手机内重启功能时进行流量控制。并发重启大量手机可能会导致宿主机负载骤升，可能会对其他正常运行的手机产生影响。通过命令行重启adb shell reboot约束：只有uid为0，1000或2000的进程有权限执行reboot命令。约束：只有uid为0，1000或2000的进程有权限执
- [对接高显存应用退出广播](https://support.huaweicloud.com/usermanual-cph/cph_ug_0078.md): 云手机服务器显卡的显存占用过高，可能导致应用渲染卡顿，为了防止显存占用过高，系统会在显存占用过高时，对显存占用高的应用进行查杀；为了使得用户感知到应用被查杀的动作，系统查杀应用后会发送广播进行通知。广播action：android.intent.action.APP_KILLED广播附带信息：查杀原因：key是reason；value是g
- [通过命令行设置DNS](https://support.huaweicloud.com/usermanual-cph/zh-cn_topic_0000002483507976.md): 通过ndc resolver命令行动态设置dns域名解析服务器列表。设置当前云手机实例的DNS域名解析服务器列表为8.8.8.8。通过以下方式查看当前云手机实例配置的DNS域名解析服务器列表信息：Android 7版本通过执行adb shell dumpsys netd命令查看。Android 7执行结果Android 11及以上版本通过
- [对接oom高内存应用退出广播](https://support.huaweicloud.com/usermanual-cph/cph_ug_0075.md): 云手机进程占用的内存过高，可能会引发手机容器卡顿。为了防止内存占用过高，系统会在内存占用过高时，会触发oom kill对高内存占用的进程进行查杀，为了使得用户感知到应用被查杀的动作，系统查杀应用后会发送广播进行通知。广播action：android.intent.action.APP_KILLED广播附带信息：查杀原因：key是reaso
- [虚拟设备仿真](https://support.huaweicloud.com/usermanual-cph/cph_ug_0059.md): 云手机不具备物理摄像头、麦克风、传感器等设备，但支持对上述设备进行虚拟仿真，使云手机能够能更好的与终端手机进行协同。如您需要进一步了解如何使用，请联系您的客户经理来获取相关文档。虚拟摄像头支持调用云手机侧音视频接口启动虚拟摄像头，获取摄像头信息，配置摄像头参数，关闭虚拟摄像头等。支持调用云手机侧音视频接口启动虚拟摄像头，获取摄像头信息，配
- [云手机音视频](https://support.huaweicloud.com/usermanual-cph/cph_ug_0060.md): 云手机提供音视频媒体引擎，支持用户基于云手机完成云手机音频、视频的采集和编码，并灵活设置音视频编码参数，匹配不同场景业务诉求。如您需要进一步了解如何使用，请参见《SDK参考》。初始化音频服务初始化音频服务，设置音频初始化参数，包括音频类型、采样率、采样深度、采样间隔等。初始化音频服务，设置音频初始化参数，包括音频类型、采样率、采样深度、采
- [路由配置](https://support.huaweicloud.com/usermanual-cph/cph_ug_0030.md): 路由配置可以将您租户下所有云手机的出网流量全部转发到您所选择的对等连接上。本节仅适用于使用系统定义网络的云手机服务器，购买云手机服务器时选择自定义网络，服务器所在VPC为租户名下指定的VPC，路由配置方式参考创建同一账户下的对等连接。一旦路由配置成功，您所有云手机出网流量的下一跳将会直接到对等连接上；如果您的云手机想访问公网，只能通过您所
- [创建用户并授权使用CPH](https://support.huaweicloud.com/usermanual-cph/cph_ug_0016.md): 如果您需要对您所拥有的云手机资源进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）。通过IAM，您可以：根据企业的业务组织，在您的账号中，给企业中不同职能部门的员工创建IAM用户，让员工拥有唯一安全凭证，并使用云资源。根据企业用户的职能，设置不同的访问权限，以达到用户
- [权限配置示例](https://support.huaweicloud.com/usermanual-cph/cph_ug_0065.md): 根据您的权限需求，可以选择自己适用的角色以及策略组合，本章节为您介绍常用的权限配置示例。关于权限配置流程请参考创建用户并授权使用CPH。权限配置示例如下：授权“所有”权限授权“操作”权限授权“只读”权限授权“指定操作”权限如果您给IAM用户授予CPH“所有”权限，需要授予CPH FullAccess 策略、DEW KeypairFullA
- [调整资源配额](https://support.huaweicloud.com/usermanual-cph/cph_ug_0009.md): 为防止资源滥用，平台限定了各服务资源的配额，对用户的资源数量和容量做了限制。如您最多可以创建多少台弹性云服务器、多少块云硬盘。如果当前资源配额无法满足使用需要，您可以申请扩大配额。登录管理控制台。单击管理控制台左上角的，选择区域和项目。在页面右上角，选择“资源 > 我的配额”。系统进入“服务配额”页面。我的配额系统进入“服务配额”页面。您
- [CPH支持的监控指标](https://support.huaweicloud.com/usermanual-cph/cph_ug_0028.md): 本节定义了云手机服务器（CPH）上报云监控的监控指标的命名空间、监控指标列表和维度定义，用户可以通过云监控提供的管理控制台或API接口来检索云手机服务产生的监控指标和告警信息。云监控服务最大支持4个层级维度，维度编号从0开始，编号3为最深层级。例如监控指标中的维度信息为“instance_id,cph_id”时，表示对应的监控指标的维度存
- [CPH支持的事件监控](https://support.huaweicloud.com/usermanual-cph/cph_ug_0064.md): 事件监控提供了事件类型数据上报、查询和告警的功能。方便您将业务中的各类重要事件或对云资源的操作事件收集到云监控服务，并在事件发生时进行告警。SYS.CPH
- [查看监控指标](https://support.huaweicloud.com/usermanual-cph/cph_ug_0029.md): 本节介绍查看云手机服务器、云手机、磁盘、GPU卡的使用情况。登录CES控制台.单击左侧导航栏的“云服务监控 > 云手机服务器”。选择一台云手机服务器，单击操作列的“查看监控指标”，查看云手机服务器的监控指标详情。返回云手机服务器列表，单击图标，展开云手机服务器，查看云手机、磁盘、GPU卡对应的监控信息。
- [创建告警规则](https://support.huaweicloud.com/usermanual-cph/cph_faq_0006.md): 告警功能为您提供监控数据的告警服务。您可以通过创建告警规则来定义告警系统如何检查监控数据，并在监控数据满足告警策略时发送报警通知。对重要监控指标创建告警规则后，便可在第一时间得知指标数据发生异常，迅速处理故障。如果在创建告警规则时关闭“发送通知”开关，则不会收到告警通知。可以通过云监控服务的告警记录功能查看告警规则的状态变化。本章节介绍如
- [支持审计的关键操作列表](https://support.huaweicloud.com/usermanual-cph/cph_ug_0032.md): 云审计服务（Cloud Trace Service，CTS），是华为云安全解决方案中专业的日志审计服务，提供对各种云资源操作记录的收集、存储和查询功能，可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。通过云审计服务，您可以记录与云手机相关的操作事件，便于日后的查询、审计和回溯。使用云审计服务前需要先开通云审计服务，如果不开
- [查询CPH审计事件](https://support.huaweicloud.com/usermanual-cph/cph_ug_0033.md): 云审计服务能够为您提供云服务资源的操作记录，记录的信息包括发起操作的用户身份、IP地址、具体的操作内容的信息，以及操作返回的响应信息。根据这些操作记录，您可以很方便地实现安全审计、问题跟踪、资源定位，帮助您更好地规划和利用已有资源、甄别违规或高危操作。本节介绍如何在云审计服务控制台查看或导出最近7天的操作记录。事件即云审计服务追踪并保存的
- [语言标签列表](https://support.huaweicloud.com/usermanual-cph/cph_ug_0063.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 最佳实践

- [创建云手机服务器](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0008.md): 登录CPH控制台，进入购买云手机服务器页面。根据界面提示，完成基础配置，如表1。基础配置参数说明参数参数说明样例计费模式服务器仅支持一种计费类型：包年/包月。包年/包月区域不同区域的云服务产品之间内网互不相通。建议您选择最靠近您业务的区域，这样可以减少网络时延、提高访问速度。需要注意：服务器购买成功后不能更换区域。华东-上海一可用区指在同
- [连接云手机并获取云手机画面](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0001.md): Airtest是跨平台UI自动化编译器，可使用Airtest工具快速获取云手机画面。已购买并通过ADB方式登录云手机。详细操作请参见“购买云手机服务器”。已在本地PC安装Airtest工具。登录Airtest官网（https://airtest.netease.com/），下载符合您操作系统的版本并安装。登录Airtest官网（https
- [云手机内管理程序保活方案](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0038.md): 在云手机内的管理程序，基本分为两类：Android APK Service 形态，即以Android无UI的Service的形式在云手机后台运行。Android JNI Native 形态，即用Android JNI开发的Executable的二进制可执行程序。两种形态的管理程序保活方案都依赖一个关键点：extend_custom.sh，
- [获取云手机列表](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0009.md): 参考《云手机服务器API参考》的“查询云手机列表”章节获取云手机列表。其中，CPH Endpoint为Endpoint列表中CPH对应区域的终端节点，如华北-北京四为cph.cn-north-4.myhuaweicloud.com。project_id为云手游服务器所属区域对应的项目ID，如083e9f825e80f50c2f96c004
- [为单台云手机安装应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0020.md): 参考《云手机服务器API参考》的“安装apk”章节为单台云手机安装应用。云手机服务器所在Region的OBS桶中已经存放好对应的APK安装包。否则，需要上传安装包，可参考场景二：快速通过OBS Browser+上传下载文件进行上传。确保已经配置好OBS桶的授权策略，若未配置请参考委托CPH操作OBS桶章节来完成配置。其中，CPH Endp
- [生成应用版本tar包并推至OBS桶](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0021.md): 需确保云手机已安装对应的应用。确保已配置好OBS桶的授权策略，具体操作请参考委托CPH操作OBS桶章节。其中，CPH Endpoint、project_id、${token}、bucket_name、object_path等参数可以参考为单台云手机安装应用章节的说明获取。phone_id为安装了对应应用的云手机ID。include_fil
- [部署应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0022.md): 推送tar包至服务器，即将文件“apk/${package_name}_${version_name}.tar”推送到服务器（${server_id1}和${server_id2}）的共享应用中。接口示例POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share
- [更新应用版本](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0026.md): 确保手机已经卸载应用推送最新的应用随后，在需要时调用appctrl start会启动最新版本应用更新应用版本，需要先删除服务器上的旧版本应用，然后重新部署新版本应用。接口示例：POST https://{CPH Endpoint}/v1/{project_id}/cloud-phone/phones/share-files Header:
- [共享应用特性综述](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0041.md): 云手机服务器提供一块共享应用存储区（简称共享空间），服务器所属用户只需要下载/更新一次应用，然后将应用数据打包上传至指定服务器的共享空间，即可以实现该服务器上所有的云手机实例共享该应用。对于云手机服务器用户而言，共享应用可以避免同样的应用数据在多台云手机里重复下载、存储、更新，降低存储和网络成本。除此之外，共享应用还有以下优点：部署方式灵
- [配置共享空间](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0044.md): 在购买服务器实例页面，选定区域、服务器类型、实例规格后，配置共享空间大小。建议在实际业务共享应用所需空间大小的基础上，上浮30%来配置共享空间的大小，以满足后续应用更新对共享空间的需求。
- [获取云手机列表](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0046.md): 参考《云手机服务器API参考》的“查询云手机列表”章节获取云手机列表。其中，CPH Endpoint为Endpoint列表中CPH对应区域的终端节点，如华北-北京四为cph.cn-north-4.myhuaweicloud.com。project_id为云手游服务器所属区域对应的项目ID，如083e9f825e80f50c2f96c004
- [为单台云手机安装应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0047.md): 参考《云手机服务器API参考》的“安装apk”章节为单台云手机安装应用。云手机服务器所在Region的OBS桶中已经存放好对应的APK安装包。否则，需要上传安装包，可参考场景二：快速通过OBS Browser+上传下载文件进行上传。确保已经配置好OBS桶的授权策略，若未配置请参考委托CPH操作OBS桶章节来完成配置。其中，CPH Endp
- [生成应用版本tar包并推至OBS桶](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0048.md): 需确保云手机已安装对应的应用。确保已配置好OBS桶的授权策略，具体操作请参考委托CPH操作OBS桶章节。其中，CPH Endpoint、project_id、${token}、bucket_name、object_path等参数可以参考为单台云手机安装应用章节的说明获取。phone_id为安装了对应应用的云手机ID。include_fil
- [推送应用tar包至服务器共享空间](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0049.md): 调用接口将OBS桶内的应用tar包推送至云手机服务器共享空间。调用示例其中，${bucket_name}为对象存储服务OBS的桶名，object_path为应用tar包在OBS桶中的存放路径。pre_install_app 为1表示将待推送的应用设置为预装应用，0表示该应用为非预装。（预装应用的具体说明请参考云手机预装应用）。如果应用被设
- [从服务器共享空间删除应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0074.md): 当云手机服务器上的所有云手机均不再使用某一共享应用时，需要从云手机服务器的共享空间中删除该共享应用，以释放存储空间。云手机服务器上所有云手机均已卸载该共享应用。其中，package_name 为应用的真实包名，server_ids为服务器ID列表，可以指定多个服务器ID。详细步骤请参考删除共享应用。在删除共享应用前，请确认服务器上所有云手
- [应用安装](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0053.md): 云游戏场景：用户接入后直接进入某款游戏。个人云手机场景：用户接入后先看到云手机画面，按需选择安装共享空间中已有的应用。在云手机中执行appctrl命令（参考appctrl命令）。使用appctrl install命令安装应用使用指导：appctrl install {包名}调用示例：appctrl install com.huawei.x
- [应用更新](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0054.md): 当某款应用发布新版本，需对共享应用版本进行更新。当某款游戏发布了新的在线资源更新，需对共享应用中的资源提前进行更新，避免云游戏场景下用户等待在线资源的下载和安装。参考获取云手机列表、为单台云手机安装应用在单台手机上安装应用最新的版本。如果应用存在资源更新，请启动应用并完成资源文件的下载和更新。参考生成应用版本tar包并推至OBS桶和推送应
- [应用卸载](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0055.md): 在云手机中执行appctrl命令，对已安装在云手机中的共享应用进行卸载（参考appctrl命令）。使用指导：在云手机中执行appctrl uninstall {包名}例如：卸载应用appctrl uninstall com.huawei.xxxxappctrl uninstall命令，仅适用于共享应用，通过原生接口安装的应用无法使用该命令
- [应用批量卸载](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0056.md): 客户分配的云手机时间到期，需要回收进入待分配区，并进行共享应用批量卸载，卸载上一个玩家安装的共享应用。在云手机中执行appctrl命令，对使用appctrl命令安装的所有共享应用进行卸载（参考appctrl命令）。使用指导：在云手机中执行appctrl clearappctrl clear命令，仅适用于使用appctrl install和
- [预装应用安装](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0058.md): 服务器上所有云手机都要安装某些应用，并且云手机重置后默认安装这些应用。参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。重置云手机，所有预装应用会自动安装。预装应用的安装过程会占用一定的手机重置时间。若云手机正在使用中，无法重置进行重置，也可使用appctrl in
- [预装应用更新](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0059.md): 参考为单台云手机安装应用，安装新的应用版本。启动应用更新下载资源。参考生成应用版本tar包并推至OBS桶，生成共享应用tar包并推送到OBS桶中。参考推送应用tar包至服务器共享空间，推送需要预装的应用tar包到服务器共享空间，将pre_install_app设置为1。重启或重置云手机，所有预装应用会自动更新。预装应用的更新过程会占用一定
- [预装应用卸载](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0060.md): 单台或部分手机不再使用预装的应用。参考应用卸载，卸载手机上的对应应用。卸载应用后，重置手机应用会重新自动安装。卸载应用后，重置手机应用会重新自动安装。服务器上所有的手机都不再使用预装的应用。参考应用卸载，卸载服务器上所有手机的对应应用。参考从服务器共享空间删除应用，从服务器共享应用区域删除应用。
- [文件预置](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0062.md): 需要在服务器上的所有云手机中预置文件。例如：推流二进制文件、保活脚本文件、应用行为监控文件等。参考获取云手机列表，从列表中选定一台云手机，将需要打包的文件放入到该云手机的目标路径下。例如：服务器上云手机需要在/data/local/huawei/、/data/local/tmp/路径下分别部署test.txt和test.sh文件。将tes
- [文件按需部署](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0063.md): 服务器上只有某些云手机需要部署文件，云手机正在运行状态，直接部署文件到云手机。参考文件预置的1和2，将配置文件打成配置文件tar包并上传到OBS桶。参考推送应用tar包至服务器共享空间，将配置文件tar包推送到目标云手机服务器。推送时将"package_name"配置为支持的配置文件包包名，将"pre_install_app"配置为0。推
- [已部署文件更新](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0064.md): 该服务器上云手机需要更新已部署过的文件。如：/data/local/tmp/test.sh脚本有更新，云手机需要部署最新的脚本。参考文件预置的1、2、3，将新配置文件打成tar包并推送到服务器共享空间。更新文件。方式一：重启云手机，自动更新文件。方式二：执行appctrl applyConfig命令更新文件（参考appctrl命令）。如果
- [取消文件预置](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0065.md): 服务器上的所有云手机重置时均不再需要部署文件。参考文件预置的1、2、3，将配置文件tar包推送到目标云手机服务器。推送时将3中的"pre_install_app"参数设置为0。推送时将3中的"pre_install_app"参数设置为0。重置云手机，该包中文件将不再部署。
- [使用多个配置文件包部署文件](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0066.md): 所有服务器需要预置公共文件，某些服务器需要预置特殊配置文件，处理不同业务。例如：1.txt、2.txt为公共配置文件，需要预置到所有服务器的云手机中。同时需要预置特定配置文件a.txt，仅对服务器组A生效；特定配置文件b.txt，仅对服务器组B生效。此时需将1.txt、2.txt打包，并以com.cph.config为包名推送到所有服务器
- [appctrl 命令的执行方法](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0068.md): 可通过以下三种方式在云手机中执行appctrl命令：通过ADB连接云手机执行命令，请参考一键式ADB连接 。调用API接口在云手机中执行命令，请参考执行异步adb命令 。云手机中的业务程序或脚本直接调用appctrl命令。针对AOSP11 v10.0.0及AOSP14 v5.0.0之后的自定义镜像版本，appctrl已实现免root运行。
- [appctrl install 安装应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0069.md): 安装应用到云手机。应用的tar包已经推送到云手机服务器。多用户场景，需要先创建多用户。单用户模式语法：appctrl install <package> [-v {共享应用版本号}]参数：<package>：应用包名。-v ：可选，指定应用版本号。示例：# 安装指定包名的应用（默认版本） appctrl install com.huawe
- [appctrl start 安装并启动应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0070.md): 安装应用到云手机，并启动应用。应用的tar包已经推送到云手机服务器。多用户场景，需要创建并启动多用户。单用户模式语法：appctrl start <package>参数：<package>：应用包名。示例：# 安装并启动指定包名应用 appctrl start com.huawei.xxxx语法：appctrl start <packag
- [appctrl uninstall 卸载应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0071.md): 云手机中卸载应用。单用户模式语法：appctrl uninstall <package>参数：<package>：应用包名。示例：# 卸载指定应用 appctrl uninstall com.huawei.xxxx语法：appctrl uninstall <package>参数：<package>：应用包名。示例：# 卸载指定应用 app
- [appctrl clear 批量卸载应用](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0072.md): 批量卸载所有非预安装的共享应用。单用户模式语法：appctrl clear说明：批量卸载用户0的非预装共享应用。语法：appctrl clear说明：批量卸载用户0的非预装共享应用。多用户模式（适用于AOSP11共享应用环境）语法：appctrl clear [--user <id> | -a]参数：--user <id>：可选，指定用户
- [appctrl applyConfig 部署文件](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0073.md): 直接部署文件至云手机。配置文件tar包已经推送到云手机服务器，并且为固定支持的包名。仅支持包名为com.cph.config、com.cph.config.level1、com.cph.config.level2。调用appctrl applyConfig {配置文件包名}例如：appctrl applyConfig com.cph.co
- [批量安装应用至云手机](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0016.md): 在一台云手机内安装APP后，可以通过调用接口的方式将此APP共享安装至多台云手机，省去重复安装的时间。假设这台安装了APP的云手机为种子云手机。该方案仅适用于非qemu规格的云手机，即实例规格名称中不包含“qemu”字样。实例规格存储1.0和存储2.0服务器可通过控制台的服务器详情页面查看区分。服务器详情种子云手机必须为一台未进行过任何操
- [修改云手机定位](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0002.md): 影响手机定位功能的信息分为四类，分别为GPS经纬度数据、基站信息数据、WiFi信息及IP地址，云手机支持其中的GPS经纬度数据和WiFi信息模拟，用户可根据业务场景，选择其中一种或多种进行定位模拟。已购买并通过ADB方式登录云手机。详细操作请参见“购买云手机服务器”。GPS经纬度获取云手机GPS经纬度数据模拟基于WGS84坐标系，使用其它
- [使用云手机摄像头](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0006.md): 查看云手机镜像最新动态，选择一个2020年10月9日（包含）之后的镜像，复制镜像ID。登录CPH控制台，切换到您的资源所在region。单击服务器管理，查看云手机服务器列表。进入云手机服务器详情页，选择其中一台云手机，单击重启按钮。勾选更新手机镜像复选框，然后填入第一步所选的镜像ID。单击“确定”，完成单台云手机更新镜像操作。上传一张图片
- [国内云手机服务器导流海外](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0039.md): 导流方案整体结构如图：该方案仅适用于没有EIP的云手机服务器，即实例规格中EIP个数为0的规格（VIP个数不限）。参考云连接服务的“跨境申请管理”章节申请跨境专线资质。待审批通过后，执行后续步骤。登录CPH控制台，进入云手机服务器管理，单击需要导流的云手机服务器，进入详情页面，找到“子网网段”。单击子网名称，进入子网页面，找到“子网IPv
- [委托CPH操作OBS桶](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0050.md): 管理员可以通过IAM创建自定义策略，给OBS桶授予自定义策略来进行精细的访问控制，并将此策略委托给CPH服务，以完成云手机数据备份恢复、应用安装等功能。创建自定义策略登录IAM控制台。在左侧导航树中，选择“权限管理 > 权限”，单击右上方的“创建自定义策略”。创建自定义策略输入“策略名称”。“策略配置方式”选择“可视化视图”。可视化视图“
- [云手机AOSP版本切换](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0051.md): 本文将指导您如何切换云手机AOSP镜像版本。仅手机镜像为AOSP7的服务器支持切换AOSP镜像版本。版本切换是高风险操作，切换前请参考导出云手机数据备份用户数据。如需回退，重置原有镜像后参考恢复云手机数据恢复数据即可。版本切换时，Android版本号相关的属性值（如ro.build.version.release属性和ro.build.f
- [Vulkan最佳实践](https://support.huaweicloud.com/bestpractice-cph/cph_bp_0081.md): Vulkan是一个低开销、跨平台的二维、三维图形与计算的应用程序接口（API），由于部分应用依赖Vulkan环境才能正常运行，云手机通过白名单控制应用是否可以使用Vulkan。 本文档主要介绍云手机中如何使能Vulkan。判断方式如下：在云手机中打开应用，存在闪退/黑屏等问题，logcat日志存在“vulkan : searching f

## API参考

- [使用前必读](https://support.huaweicloud.com/api-cph/cph_api_0101.md): 欢迎使用云手机服务器服务（Cloud Phone Host，CPH）。云手机服务器是基于华为云裸金属服务器，虚拟出带有原生安卓操作系统，同时具有虚拟手机功能的云服务器。您可以使用本文档提供的API对云手机服务器服务进行相关操作，如购买云手机服务器、查询云手机列表、查询云手机上部署的应用、修改共享带宽、重启云手机等。支持的全部操作请参见AP
- [API概览](https://support.huaweicloud.com/api-cph/cph_api_0200.md): 通过调用云手机服务器服务提供的接口，您可以完整地使用云手机的所有功能。例如查询云手机列表、重启云手机、为云手机推送文件。
- [构造请求](https://support.huaweicloud.com/api-cph/cph_api_0301.md): 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987。请求URI由如下部分组成：{URI-scheme}://{Endpoint}/{resource-pat
- [认证鉴权](https://support.huaweicloud.com/api-cph/cph_api_0302.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。推荐使用AK/SK认证，其安全性比Token认证要高。Token认证：通过Token认证调用请求。AK/SK认证：通过AK（
- [返回结果](https://support.huaweicloud.com/api-cph/cph_api_0303.md): 请求发送以后，您会收到响应，其中包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见返回值。对于管理员创建IAM用户接口，如果调用后返回状态码为201，则表示请求成功。对应请求消息头，响应同样也有消息头，如Content-type。对于管理员创建IAM用户接口，返回如图
- [快速入门](https://support.huaweicloud.com/api-cph/cph_api_0400.md): 本节通过调用一系列云手机服务器服务的API管理云手机。通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。当您使用Token认证方式完成认证鉴权时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。IAM获取token的API查询
- [查询云手机服务器列表 - ListCloudPhoneServers](https://support.huaweicloud.com/api-cph/cph_api_0502.md): 分页查询云手机服务器，云手机服务器列表按照创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在云手机服务器，则返回空列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的I
- [查询云手机服务器详情 - ShowCloudPhoneServerDetail](https://support.huaweicloud.com/api-cph/cph_api_0540.md): 根据server_id查询云手机服务器的详细信息。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限
- [查询云手机服务器规格列表 - ListCloudPhoneServerModels](https://support.huaweicloud.com/api-cph/cph_api_0505.md): 查询云手机服务器的规格列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项
- [购买云手机服务器 - CreateNet2CloudPhoneServer](https://support.huaweicloud.com/api-cph/cph_api_0550.md): 购买云手机服务器，支持您复用已有的VPC网络管理云手机服务器，支持云手机服务器复用您已购买的共享带宽等资源。请确保您使用的账号具有CPH AgencyDependencyAccess权限。请确保您使用的账号具有CPH AgencyDependencyAccess权限。请确保您有足够的服务器及网络配额，配额校验不通过将导致创建失败。请确保您
- [重启云手机服务器 - RestartCloudPhoneServer](https://support.huaweicloud.com/api-cph/cph_api_0517.md): 批量重启云手机服务器。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果
- [切换云手机服务器 - ChangeCloudPhoneServer](https://support.huaweicloud.com/api-cph/ChangeCloudPhoneServer.md): 切换云手机服务器, 支持您换一台新的云手机服务器。切换后服务器名称、服务器ID与原服务器相同, 服务器计费保持不变。服务器切换的同时服务器上的手机重新创建，不保留用户数据。切换需要额外的资源和资源配额。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调
- [推送共享存储文件 - PushShareFiles](https://support.huaweicloud.com/api-cph/cph_api_0534.md): 推送文件至共享存储目录中，该功能仅在支持共享存储的云手机规格上可实现。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有A
- [查询共享存储文件 - ListShareFiles](https://support.huaweicloud.com/api-cph/cph_api_0541.md): 查询共享存储指定路径下的文件列表，该功能仅在支持共享存储的云手机规格上可实现。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果
- [删除共享存储文件 - DeleteShareFiles](https://support.huaweicloud.com/api-cph/cph_api_0535.md): 删除共享存储目录中文件，该功能仅在支持共享存储的云手机规格上可实现。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与
- [删除共享应用 - DeleteShareApps](https://support.huaweicloud.com/api-cph/cph_api_0547.md): 在共享应用存储目录中删除共享应用，该功能仅在支持共享应用的云手机规格上可实现。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果
- [推送共享应用 - PushShareApps](https://support.huaweicloud.com/api-cph/cph_api_0546.md): 推送应用tar文件至共享应用存储目录中，该功能仅在支持共享应用的云手机服务器上可实现。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。注意：不能向存在低安卓版本云手机的服务器推送高安卓版本手机导出的应用包，否则可能会造成手机数据兼容性问题。如果您使用的是physical.kg1
- [变更云手机服务器规格 - ChangeCloudPhoneServerModel](https://support.huaweicloud.com/api-cph/cph_api_0545.md): 变更云手机服务器规格。接口调用成功后，大约2分钟左右规格会变更结束，在订单中心可以查看到变更的订单状态为成功，且查询服务器的详细信息，可以查看到服务器规格名称已经变成新的规格名称。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有A
- [修改云手机服务器名称 - UpdateServerName](https://support.huaweicloud.com/api-cph/cph_api_0551.md): 根据serverId修改serverName。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求
- [查询云手机服务器规格售卖状态列表 - ListCloudPhoneServerModelOfferings](https://support.huaweicloud.com/api-cph/ListCloudPhoneServerModelOfferings.md): 查询客户有权限的可用区，及可用区内支持的服务器规格售卖状态列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略
- [查询服务器已安装共享应用列表 - ListShareAppsSnapshot](https://support.huaweicloud.com/api-cph/ListShareAppsSnapshot.md): 该接口查询云手机服务器上最新采集的已安装的共享应用快照，采集在云手机服务器上定时每两小时执行一次。注意存在以下限制：1.云手机服务器安装不同的共享应用数量不能超过10000个，超过限制不会采集该服务器数据。2.推送安装的共享应用包名只包含大小写字母、数字、下划线、点，不能以数字和下划线开头，点不能作为结尾且包名中至少有一个点，点后必须以字
- [创建云手机裸服务器 - CreateCloudPhoneSingleServer](https://support.huaweicloud.com/api-cph/CreateCloudPhoneSingleServer.md): 该接口创建的服务器仅包含服务器和服务器的镜像，不包含云手机实例和镜像等内容。若需创建包含云手机实例的服务器，请使用创建云手机服务器接口。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调
- [查询带宽信息 - ShowBandwidthDetail](https://support.huaweicloud.com/api-cph/cph_api_0511.md): 查询云手机使用的带宽信息，本接口只适用于使用系统定义网络的服务器。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策
- [修改共享带宽 - UpdateBandwidth](https://support.huaweicloud.com/api-cph/cph_api_0512.md): 修改云手机使用的共享带宽大小，本接口只适用于使用系统定义网络的服务器。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色
- [查询云手机列表 - ListCloudPhones](https://support.huaweicloud.com/api-cph/cph_api_0503.md): 分页查询云手机，云手机列表按照创建时间进行降序排列。分页查询可以指定offset以及limit。如果不存在云手机，则返回空列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前A
- [查询云手机详情 - ShowCloudPhoneDetail](https://support.huaweicloud.com/api-cph/cph_api_0504.md): 查询云手机的详细信息。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果
- [获取云手机连接信息 - BatchShowPhoneConnectInfos](https://support.huaweicloud.com/api-cph/cph_api_0565.md): 获取云手机连接信息。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使
- [查询云手机规格列表 - ListCloudPhoneModels](https://support.huaweicloud.com/api-cph/cph_api_0506.md): 查询或统计云手机的规格列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项
- [查询手机镜像 - ListCloudPhoneImages](https://support.huaweicloud.com/api-cph/cph_api_0519.md): 根据项目ID查询可用的手机镜像。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授
- [重置云手机 - ResetCloudPhone](https://support.huaweicloud.com/api-cph/cph_api_0514.md): 批量重置云手机，将云手机恢复出厂设置。该接口为异步接口。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具
- [重启云手机 - RestartCloudPhone](https://support.huaweicloud.com/api-cph/cph_api_0515.md): 批量重启云手机，也可用于开启云手机。该接口为异步接口。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体
- [关闭云手机 - StopCloudPhone](https://support.huaweicloud.com/api-cph/cph_api_0516.md): 批量关闭云手机。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用身
- [修改云手机名称 - UpdatePhoneName](https://support.huaweicloud.com/api-cph/cph_api_0508.md): 根据phoneId修改phoneName。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参
- [更新云手机属性 - UpdateCloudPhoneProperty](https://support.huaweicloud.com/api-cph/cph_api_0536.md): 部分云手机属性开放更新能力，部分属性无法更新，部分属性需要重启手机生效，属性约束请云手机属性列表。如果手机处于异常状态，属性更新后需恢复手机状态为运行中才可生效。该接口为异步接口。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有A
- [导出云手机数据 - BatchExportCloudPhoneData](https://support.huaweicloud.com/api-cph/cph_api_0538.md): 批量导出云手机中的数据，不支持导出共享应用及其数据文件。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所
- [恢复云手机数据 - BatchImportCloudPhoneData](https://support.huaweicloud.com/api-cph/cph_api_0539.md): 批量恢复数据到云手机中。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。高版本手机导出的数据无法在低版本手机内恢复。低版本手机导出的数据可以在高版本手机内恢复，但可能会在极少数场景下有不兼容的风险。因此推荐您在同版本手机间进行导出与恢复。手机在运行状态会有数据
- [云手机流量导流 - ImportTraffic](https://support.huaweicloud.com/api-cph/cph_api_0549.md): 手机流量路由修改。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用
- [扩容云手机数据盘大小 - ExpandPhoneDataVolumeSize](https://support.huaweicloud.com/api-cph/ExpandPhoneDataVolumeSize.md): 扩容云手机数据盘大小您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使
- [查询任务执行状态 - ShowJob](https://support.huaweicloud.com/api-cph/cph_api_0521.md): 查询任务的执行状态。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使
- [查询任务执行状态列表 - ListJobs](https://support.huaweicloud.com/api-cph/cph_api_0522.md): 查询同一个request id下的任务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见
- [更改密钥对 - UpdateKeypair](https://support.huaweicloud.com/api-cph/cph_api_0524.md): 修改连接云手机的密钥对。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如
- [查询编码服务 - ListEncodeServers](https://support.huaweicloud.com/api-cph/cph_api_0526.md): 查询编码服务列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用
- [重启编码服务 - RestartEncodeServer](https://support.huaweicloud.com/api-cph/cph_api_0527.md): 批量重启编码服务。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用
- [推送文件 - PushFile](https://support.huaweicloud.com/api-cph/cph_api_0529.md): 推送文件到云手机文件系统中。系统会将所指定的文件下载解压后，将解压后的内容全部推送到云手机的根目录下。只支持指定tar格式的文件进行推送，您需要将tar文件提前上传至您的OBS桶中。该接口为异步接口。接口调用前请先确保已完成CPH服务操作OBS桶的委托授权。委托CPH操作OBS桶请参见委托CPH操作OBS桶。管理面性能有限，对相同服务器批
- [安装apk - InstallApk](https://support.huaweicloud.com/api-cph/cph_api_0530.md): 在云手机中安装apk。系统会将指定的apk文件下载后直接安装到云手机中。支持安装单apk应用和多apk应用。可使用install命令安装单apk应用，一次只支持安装一个apk，只能传一个apk；可使用install-multiple命令安装多apk应用（多apk应用为单个应用拆分成多个apk），一次只支持同一个应用的多个apk。该接口为异
- [卸载apk - UninstallApk](https://support.huaweicloud.com/api-cph/cph_api_0531.md): 在云手机中卸载apk。该接口为异步接口。管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能
- [异步执行adb命令 - RunShellCommand](https://support.huaweicloud.com/api-cph/cph_api_0532.md): 在云手机中执行shell命令。该接口为异步接口。管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。管理面性能有限，对相同服务器批量执行的ADB命令，将会阻塞云手机其他任务执行。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例
- [同步执行adb命令 - RunSyncCommand](https://support.huaweicloud.com/api-cph/cph_api_0537.md): 在云手机中同步执行命令并返回命令执行的输出信息，该接口仅支持adb shell命令的执行。1分钟内每个用户调用接口次数上限为6次，每个云手机允许执行命令超时时间为2秒，接口时间不超过30秒，执行云手机数越多，接口耗时相应越长。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例
- [查询项目标签 - ListProjectTags](https://support.huaweicloud.com/api-cph/cph_api_0557.md): 查询租户在指定区域和资源类型的所有标签集合。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请
- [查询资源标签 - ListResourceTags](https://support.huaweicloud.com/api-cph/cph_api_0556.md): 查询资源标签列表。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用
- [查询资源实例 - ListResourceInstances](https://support.huaweicloud.com/api-cph/cph_api_0555.md): 查询资源实例。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用身份
- [批量添加标签 - BatchCreateTags](https://support.huaweicloud.com/api-cph/cph_api_0553.md): 批量添加标签。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用身份
- [批量删除标签 - BatchDeleteTags](https://support.huaweicloud.com/api-cph/cph_api_0554.md): 批量删除标签。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用身份
- [查询自定义镜像列表 - ListImages](https://support.huaweicloud.com/api-cph/cph_api_0583.md): 查询自定义镜像列表您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用
- [删除镜像 - DeleteImage](https://support.huaweicloud.com/api-cph/cph_api_0560.md): 删除自定义镜像您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用身份
- [共享镜像给指定账号 - AddImageMember](https://support.huaweicloud.com/api-cph/cph_api_0561.md): 镜像共享,共享镜像给指定账号。镜像只能共享给同region下的其他华为云账号(project_id)。镜像只能共享给同region下的其他华为云账号(project_id)。同一镜像最多只能共享给10个其他账号。同一镜像最多只能共享给10个其他账号。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可
- [获取镜像已共享账号列表 - ListImageMembers](https://support.huaweicloud.com/api-cph/cph_api_0562.md): 获取镜像已共享账号列表路径中的project_id为共享账号的租户id路径中的project_id为共享账号的租户id路径中的image_id为共享账号的镜像id路径中的image_id为共享账号的镜像id您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示
- [更新共享镜像接受信息 - UpdateImageMember](https://support.huaweicloud.com/api-cph/cph_api_0564.md): 用户收到共享镜像后，选择接受或者拒绝共享镜像。未接受的共享镜像无法使用。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角
- [删除共享镜像 - DeleteImageMember](https://support.huaweicloud.com/api-cph/cph_api_0563.md): 删除共享镜像您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果使用身份策
- [查询计划事件列表 - ListScheduledEvents](https://support.huaweicloud.com/api-cph/cph_api_0507.md): 查询服务器计划事件列表您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项。如果
- [授权计划事件 - AuthorizeScheduledEvent](https://support.huaweicloud.com/api-cph/cph_api_0509.md): 授权计划事件。当系统上报计划事件时，需要对服务器进行“授权维护”操作。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色
- [修改计划事件预约时间 - UpdateScheduledEvent](https://support.huaweicloud.com/api-cph/cph_api_0518.md): 更新计划事件的执行开始时间。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授权项
- [云手机数据备份与恢复](https://support.huaweicloud.com/api-cph/cph_api_0801.md): 当需要对云手机数据进行备份和恢复时，可以调用接口进行数据备份，在需要时再进行恢复，同时也可用于将一台云手机的数据恢复到其他云手机。数据备份与恢复涉及的接口如下：调用导出云手机数据接口进行数据备份。调用恢复云手机数据接口进行数据恢复。请求示例{endpoint}信息请从地区和终端节点获取。POST https://{endpoint}/v1
- [权限及授权项说明](https://support.huaweicloud.com/api-cph/cph_api_06001.md): 如果您需要对您所拥有的CPH进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用CPH服务的其它功能。默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组
- [异常响应](https://support.huaweicloud.com/api-cph/cph_api_0602.md): 响应参数参数参数类型描述request_idString请求的唯一标识ID。error_codeString错误码，详情请参见错误码。error_msgString错误描述信息。响应样例{ "request_id": "aad0860d089c482b943971f802a6718e", "error_code": "
- [返回值](https://support.huaweicloud.com/api-cph/cph_api_0603.md): 正常返回值说明200 OKGET和PUT操作正常返回。201 CreatedPOST操作正常返回。204No Content异常返回值说明400 Bad Request请求参数错误403 Forbidden没有权限对资源访问404 Not Found请求的资源不存在500 Internal Server Error请求未完成，服务异常50
- [错误码](https://support.huaweicloud.com/api-cph/ErrorCode.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。
- [获取项目ID](https://support.huaweicloud.com/api-cph/cph_api_0605.md): 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。有如下两种获取方式：调用API获取项目ID从控制台获取项目ID项目ID可以通过调用查询指定条件下的项目列表API获取。获取项目ID的接口为“GET https://{Endpoint}/v3/projects”，其中{Endpoint}为IAM的终端节点，可以从地区和
- [云手机属性列表](https://support.huaweicloud.com/api-cph/cph_api_appendix_03.md): 属性参数都为非必选且可以修改，说明如下：以aphs1开头和rx1.cp.c60.d32.e1v1.qemu规格的云手机仅支持少量属性的修改。部分属性可能需要最新的镜像才能支持，如有需要请您更新手机镜像。CPUI镜像部分属性不支持修改。
- [云手机规格列表](https://support.huaweicloud.com/api-cph/cph_api_appendix_04.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。
- [服务器规格列表](https://support.huaweicloud.com/api-cph/cph_api_appendix_05.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## SDK参考

- [简介](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0001.md): 本文档描述云手机libCPHMediaEngine.so提供的触控和音视频接口，方便您调用云手机的媒体能力，结合您的业务进行二次开发。出于安全考虑，云手机提供的音视频服务不支持真机侧SDK多实例连接；如果有同屏互动需求，请在端云协同的云侧接入引擎进行视频流分发。本文档SetPhysicalResolution接口不能在出流过程中设置物理分
- [触控注入](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0004.md): int InjectTouchData(const InputTouch &inputTouch);触控数据注入。真机端触控事件的采集方式，详见端云协同的端侧SDK开源代码：端云协同的端侧SDK。真机端触控事件采集相关代码，请参考：onTouch方法。无0：成功小于0：数据注入失败请参见错误码。
- [按键注入](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0005.md): int InjectKeyData(const InputKey &inputKey);按键数据注入。无0：成功小于0：数据注入失败请参见错误码。
- [启动音频服务](https://support.huaweicloud.com/sdkreference-cph/zh-cn_topic_0000001618303425.md): int OpenAudio(const char *jsonConfig, AudioCallback callback);打开音频采集服务。基于AOSP音频的实现原理，同时使用scrcpy等监控软件时，OpenAudio出现没有出流数据的情况属于正常现象。无0：成功小于0：音频服务初始化失败请参见错误码。
- [停止音频服务](https://support.huaweicloud.com/sdkreference-cph/zh-cn_topic_0000001618182969.md): int CloseAudio(void);关闭音频采集服务。无无0：成功小于0：停止音频服务失败请参见错误码。
- [启动视频服务](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0008.md): int OpenVideo(const char* jsonConfig, VideoCallback callback);启动视频采集服务。如需视频编码后出流，推荐使用外置编码方案，有助于降低编码时延和云手机资源消耗，并且外置编码可支持h265编码出流。外置编码是采用与云手机服务器同VPC下的ECS为云手机提供编码能力的技术方案，支持H
- [停止视频服务](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0009.md): int CloseVideo(void);关闭视频采集服务。无无0：成功小于0：停止视频服务失败请参见错误码。
- [设置物理分辨率或屏幕密度](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0010.md): 设置物理分辨率：int SetPhysicalResolution (int width, int height);设置物理分辨率和屏幕密度：int SetPhysicalResolution(int width, int height, int dpi);设置云手机的物理分辨率或屏幕密度（在出流过程中调用该接口设置物理分辨率会失败）。无
- [动态设置视频参数](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0011.md): int SetParams(const char* jsonConfig);动态设置视频服务参数配置。无0：成功小于0：设置视频参数失败请参见错误码。
- [强制I帧](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0012.md): int GenerateKeyFrame(void);强制下一帧为I帧。无无0：成功小于0：设置I帧失败请参见错误码。
- [获取版本号](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0014.md): const char * GetVersion();获得当前版本号。无无版本号字符串。请参见错误码。
- [获取媒体服务支持能力](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0015.md): const char * GetCPHMediaFeatures();获得当前云手机媒体服务的支持能力。无无云手机支持能力json串请参见错误码。
- [错误码](https://support.huaweicloud.com/sdkreference-cph/cph_sdk_0016.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## CLI参考

- [如何使用CLI](https://support.huaweicloud.com/clir-cph/cph_cli_01.md): 华为云命令行工具服务（Koo Command Line Interface，KooCLI，原名HCloud CLI）是为发布在API Explorer上的云服务API提供的命令行管理工具。您可以通过此工具调用API Explorer中CPH开放的API，管理和使用您的CPH资源。关于KooCLI的详细信息，请参见什么是KooCLI。在使用
- [CLI命令参考](https://support.huaweicloud.com/clir-cph/cph_cli_02.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。

## 常见问题

- [华为云云手机相较于其他方案有什么优势？](https://support.huaweicloud.com/cph_faq/cph_faq_0001.md): 当前市场上常见的手机模拟方案有x86模拟器方案和真手机方案，优劣对比如表1所示。
- [云手机支持IOS系统吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0002.md): 若您是咨询云手机是否可安装IOS系统，答案是不可以。目前只支持安装开源的谷歌AOSP版本，其他手机系统出于商业授权缘故、架构不一致等缘由，我们不能提供。若您是咨询是否可以通过IOS系统连接云手机，答案是可以。我们支持通过任何系统连接云手机。
- [云手机有root权限吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0021.md): 云手机默认是有root权限的，即您可以获得云手机的最高权限。
- [云手机都有独立的公网IP吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0026.md): 公网IP绑定在服务器上，服务器虚拟出的所有云手机共用一个服务器的公网IP，但是每台云手机都拥有独立的私有IP。
- [如何获取项目ID？](https://support.huaweicloud.com/cph_faq/cph_faq_0004.md): 登录管理控制台。在右上角用户名的下拉列表中，单击“我的凭证”。在“项目列表”中获取各区域对应的“项目ID”。项目ID
- [如何在单台云手机中安装APP？](https://support.huaweicloud.com/cph_faq/cph_faq_0013.md): 云手机目前没有自带浏览器或相关应用市场，如果您想要在云手机内安装APP，可以自行找一个APP的apk包使用ADB命令传递至云手机上去安装。ADB连接云手机。详细指导请参考“连接方式简介”。详细指导请参考“连接方式简介”。将待安装APP的apk包保存在本地设备目录下。执行以下命令，安装APP的apk包至云手机SD卡。adb -s 127.0
- [购买服务器后，需要多久开通成功？](https://support.huaweicloud.com/cph_faq/cph_ug_0015.md): 通常需要30分钟左右。如果长时间没有开通成功，请联系客服寻求技术支持。
- [在管理控制台找不到我的服务器资源怎么办？](https://support.huaweicloud.com/cph_faq/cph_faq_0014.md): 已经购买成功的云手机或云手游服务器资源，管理控制台上却没有显示。资源不在当前所选区域或项目。登录云手机管理控制台。确认自己购买的服务器所属区域，然后在控制台左上角切换区域后，即可查看已购买的资源。切换区域如果您的服务器是在某个区域的子项目下购买的，请切换至该子项目下查看资源。如果您的服务器是在某个区域的子项目下购买的，请切换至该子项目下查
- [私钥文件丢失，怎么办？](https://support.huaweicloud.com/cph_faq/cph_faq_0010.md): 如果私钥文件丢失了，可以为服务器替换新的密钥对，并使用新的私钥文件连接云手机。以下为替换服务器密钥对的操作指导，请提前在云服务器控制台创建密钥对，并将密钥对对应的私钥文件下载至本地。登录CPH控制台，进入服务器管理页面。选择需要修改密钥对的服务器，在操作列单击“更多 > 修改密钥对”。在“修改密钥对”对话框，选择新的密钥对，单击“确定”。
- [如何确认本地设备是否安装SSH服务及SSH服务的安装版本？](https://support.huaweicloud.com/cph_faq/cph_faq_0020.md): 在本地设备上打开命令提示符窗口，以Windows 10操作系统为例，方法如下：同时按下“Win + R”，在打开的“运行”对话框中输入cmd，按“Enter”。同时按下“Win + R”，在打开的“运行”对话框中输入cmd，按“Enter”。输入ssh命令，按“Enter”。如果没有报错，出现下图内容，说明系统自带SSH。如果出现下图报错
- [常用ADB命令有哪些？](https://support.huaweicloud.com/cph_faq/cph_faq_0027.md): 本小节提供常用的ADB命令，方便您日常使用。安装APPadb install -rxxx.apk //重新安装现有应用，保留其数据和缓存文件 adb install -sxxx.apk //安装apk到SD卡 adb install -fxxx.apk //安装apk到内部系统内存获取安装位置adb shell pm get-ins
- [云手机支持摄像头吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0033.md): 云手机支持虚拟SIM卡、虚拟手机号码、虚拟摄像头等相关功能。
- [云手机支持人脸识别吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0034.md): 因云手机不支持物理摄像头功能，所以无法人脸识别。
- [云手机使用自定义网络的安全组授权规则](https://support.huaweicloud.com/cph_faq/cph_faq_0035.md): 使用自定义网络创建云手机服务器时，云手机服务将为您创建一个“cph_admin_trust”委托，该委托包含的权限为：“CPH AgencyDependencyAccess”。云手机服务将使用该委托完成如下操作：为云手机/云游戏实例创建弹性网卡，分配弹性公网IP、虚拟IP。为云手机/云手游服务器创建默认名称为system-cph-sg的安
- [华为云云手机相较于其他方案有什么优势？](https://support.huaweicloud.com/cph_faq/cph_faq_0001.md): 当前市场上常见的手机模拟方案有x86模拟器方案和真手机方案，优劣对比如表1所示。
- [云手机支持IOS系统吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0002.md): 若您是咨询云手机是否可安装IOS系统，答案是不可以。目前只支持安装开源的谷歌AOSP版本，其他手机系统出于商业授权缘故、架构不一致等缘由，我们不能提供。若您是咨询是否可以通过IOS系统连接云手机，答案是可以。我们支持通过任何系统连接云手机。
- [云手机有root权限吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0021.md): 云手机默认是有root权限的，即您可以获得云手机的最高权限。
- [云手机都有独立的公网IP吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0026.md): 公网IP绑定在服务器上，服务器虚拟出的所有云手机共用一个服务器的公网IP，但是每台云手机都拥有独立的私有IP。
- [如何获取项目ID？](https://support.huaweicloud.com/cph_faq/cph_faq_0004.md): 登录管理控制台。在右上角用户名的下拉列表中，单击“我的凭证”。在“项目列表”中获取各区域对应的“项目ID”。项目ID
- [如何在单台云手机中安装APP？](https://support.huaweicloud.com/cph_faq/cph_faq_0013.md): 云手机目前没有自带浏览器或相关应用市场，如果您想要在云手机内安装APP，可以自行找一个APP的apk包使用ADB命令传递至云手机上去安装。ADB连接云手机。详细指导请参考“连接方式简介”。详细指导请参考“连接方式简介”。将待安装APP的apk包保存在本地设备目录下。执行以下命令，安装APP的apk包至云手机SD卡。adb -s 127.0
- [购买服务器后，需要多久开通成功？](https://support.huaweicloud.com/cph_faq/cph_ug_0015.md): 通常需要30分钟左右。如果长时间没有开通成功，请联系客服寻求技术支持。
- [在管理控制台找不到我的服务器资源怎么办？](https://support.huaweicloud.com/cph_faq/cph_faq_0014.md): 已经购买成功的云手机或云手游服务器资源，管理控制台上却没有显示。资源不在当前所选区域或项目。登录云手机管理控制台。确认自己购买的服务器所属区域，然后在控制台左上角切换区域后，即可查看已购买的资源。切换区域如果您的服务器是在某个区域的子项目下购买的，请切换至该子项目下查看资源。如果您的服务器是在某个区域的子项目下购买的，请切换至该子项目下查
- [私钥文件丢失，怎么办？](https://support.huaweicloud.com/cph_faq/cph_faq_0010.md): 如果私钥文件丢失了，可以为服务器替换新的密钥对，并使用新的私钥文件连接云手机。以下为替换服务器密钥对的操作指导，请提前在云服务器控制台创建密钥对，并将密钥对对应的私钥文件下载至本地。登录CPH控制台，进入服务器管理页面。选择需要修改密钥对的服务器，在操作列单击“更多 > 修改密钥对”。在“修改密钥对”对话框，选择新的密钥对，单击“确定”。
- [如何确认本地设备是否安装SSH服务及SSH服务的安装版本？](https://support.huaweicloud.com/cph_faq/cph_faq_0020.md): 在本地设备上打开命令提示符窗口，以Windows 10操作系统为例，方法如下：同时按下“Win + R”，在打开的“运行”对话框中输入cmd，按“Enter”。同时按下“Win + R”，在打开的“运行”对话框中输入cmd，按“Enter”。输入ssh命令，按“Enter”。如果没有报错，出现下图内容，说明系统自带SSH。如果出现下图报错
- [常用ADB命令有哪些？](https://support.huaweicloud.com/cph_faq/cph_faq_0027.md): 本小节提供常用的ADB命令，方便您日常使用。安装APPadb install -rxxx.apk //重新安装现有应用，保留其数据和缓存文件 adb install -sxxx.apk //安装apk到SD卡 adb install -fxxx.apk //安装apk到内部系统内存获取安装位置adb shell pm get-ins
- [云手机支持摄像头吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0033.md): 云手机支持虚拟SIM卡、虚拟手机号码、虚拟摄像头等相关功能。
- [云手机支持人脸识别吗？](https://support.huaweicloud.com/cph_faq/cph_faq_0034.md): 因云手机不支持物理摄像头功能，所以无法人脸识别。
- [云手机使用自定义网络的安全组授权规则](https://support.huaweicloud.com/cph_faq/cph_faq_0035.md): 使用自定义网络创建云手机服务器时，云手机服务将为您创建一个“cph_admin_trust”委托，该委托包含的权限为：“CPH AgencyDependencyAccess”。云手机服务将使用该委托完成如下操作：为云手机/云游戏实例创建弹性网卡，分配弹性公网IP、虚拟IP。为云手机/云手游服务器创建默认名称为system-cph-sg的安
- [云手机服务器的收费标准是什么？](https://support.huaweicloud.com/cph_faq/cph_faq_0003.md): CPH计费项如图1所示，各计费项的详细说明请参见表1。服务器计费模式为包年包月付费，不支持按量付费。对于长期使用者，推荐包年购买。
- [服务器到期了，多久会释放资源？](https://support.huaweicloud.com/cph_faq/cph_faq_0012.md): 包年/包月方式购买的服务器到期后，如果没有按时续费，华为云会提供一定的保留期。保留期的时长由客户等级而定，具体请参见“保留期”。客户等级查看方式：登录管理控制台，在右上角用户名下单击“基本信息”，查看账号名后的级别，如图1所示。
- [云手机服务器资源冻结/释放/退订常见问题](https://support.huaweicloud.com/cph_faq/cph_faq_0039.md): 资源冻结的类型包括欠费冻结、违规冻结、公安冻结。单击了解资源冻结的类型、冻结后对续费、退订的影响、资源冻结后，什么时候可以解冻。欠费冻结：用户可通过续费或充值来解冻资源，恢复云手机服务器正常使用。欠费冻结的云手机服务器允许续费、释放；已经到期的包年/包月云手机服务器不能发起退订，未到期的包年/包月云手机服务器可以退订。违规冻结：违规冻结的
- [云手机服务器的收费标准是什么？](https://support.huaweicloud.com/cph_faq/cph_faq_0003.md): CPH计费项如图1所示，各计费项的详细说明请参见表1。服务器计费模式为包年包月付费，不支持按量付费。对于长期使用者，推荐包年购买。
- [服务器到期了，多久会释放资源？](https://support.huaweicloud.com/cph_faq/cph_faq_0012.md): 包年/包月方式购买的服务器到期后，如果没有按时续费，华为云会提供一定的保留期。保留期的时长由客户等级而定，具体请参见“保留期”。客户等级查看方式：登录管理控制台，在右上角用户名下单击“基本信息”，查看账号名后的级别，如图1所示。
- [云手机服务器资源冻结/释放/退订常见问题](https://support.huaweicloud.com/cph_faq/cph_faq_0039.md): 资源冻结的类型包括欠费冻结、违规冻结、公安冻结。单击了解资源冻结的类型、冻结后对续费、退订的影响、资源冻结后，什么时候可以解冻。欠费冻结：用户可通过续费或充值来解冻资源，恢复云手机服务器正常使用。欠费冻结的云手机服务器允许续费、释放；已经到期的包年/包月云手机服务器不能发起退订，未到期的包年/包月云手机服务器可以退订。违规冻结：违规冻结的
- [通过公网访问云手机时，建立SSH隧道失败了，如何解决？](https://support.huaweicloud.com/cph_faq/cph_faq_0005.md): 若您建立SSH隧道失败，请重点排查以下命令的参数是否正确。ssh -L 本地空闲端口:云手机监听IP:云手机监听端口 SSH隧道用户名@公网IP地址 -i 私钥文件路径 -Nf检查参数“本地空闲端口”是否被占用了。确保您获取的是“实例监听端口”而非“服务器监听端口”。检查“SSH隧道用户名”使用的是项目ID，请参考如何获取项目ID？。创建
- [建立SSH隧道时提示“Authorized users only. All activities may be monitored and reported.”，是什么意思？](https://support.huaweicloud.com/cph_faq/cph_faq_0007.md): “Authorized users only. All activities may be monitored and reported.”是SSH隧道建立成功的提示，如图1所示。如果SSH隧道建立失败，会在这个提示下显示“Permission denied”、“Connection closed”等报错信息。
- [建立SSH隧道时报错“too open”？](https://support.huaweicloud.com/cph_faq/cph_faq_0008.md): 在连接云手机时，建立SSH隧道报“too open”的错误，具体如图1所示。用户的私钥文件权限过于开放，所以建立SSH隧道时被拒绝了。按以下操作修改私钥文件的权限：如果用户的本地设备为Linux操作系统，可以在Linux环境执行chmod 600 KeyPair-test.pem来设置。如果用户的本地设备为Windows操作系统，请按照如
- [建立SSH隧道时报错“Permission denied”？](https://support.huaweicloud.com/cph_faq/cph_faq_0016.md): 在连接云手机时，建立SSH隧道报“Permission denied”的错误，具体如图1所示。检查建立SSH隧道的命令中，SSH隧道用户名（即项目ID），是否与云手机所在区域相匹配。ssh -L 本地空闲端口:云手机监听地址 SSH隧道用户名@公网IP地址 -i 私钥文件路径 -Nf如果问题仍未解决，请执行2继续排查。ssh -L 本地空
- [建立SSH隧道时报错“no match mac found”？](https://support.huaweicloud.com/cph_faq/cph_faq_0017.md): 本地使用macOS系统连接云手机时，建立SSH隧道报“no match mac found”的错误，具体如下所示：这个问题一般是由OpenSSH引起的，可能因为下载了多个版本的OpenSSH，或者下载的OpenSSH不兼容。对于系统自带SSH的场景较少出现此问题。以Windows 10 为例:打开“控制面板 > 程序 > 卸载程序”，单击
- [建立SSH隧道时报错“no matching key exchange method found”？](https://support.huaweicloud.com/cph_faq/cph_faq_0036.md): 在连接云手机时，建立SSH隧道报“no matching key exchange method found”的错误，具体如下所示：这个问题一般是由SSH客户端与SSH服务端建立连接时找不到匹配的KexAlgorithms算法引起的，在云手机场景下，通常是SSH客户端的版本过低导致的。以Windows 10 为例:将OpenSSH程序升级
- [如何保持SSH会话不中断？](https://support.huaweicloud.com/cph_faq/cph_faq_0011.md): 在连接云手机时，可能会因为长时间不操作，导致SSH会话超时退出。如果已经通过ADB连接上云手机，那么超时退出后，将无法继续执行adb shell相关命令。在建立SSH隧道时，命令中添加“ -o ServerAliveInterval=30”参数。那么完整的命令为：ssh -L 本地空闲端口:云手机监听地址 SSH隧道用户名@公网IP地址 
- [建立隧道连接失败如何处理？](https://support.huaweicloud.com/cph_faq/cph_faq_0030.md): 建立隧道连接失败或adb devices显示对应设备状态为offline，将表示建连云手机设备实例失败，首先尝试使用adb connect重新建连，若依旧无法建连，则执行以下操作：检查访问密钥文件是否为相应服务器的访问密钥。前往云手机控制台页面，检查相应云手机实例运行状态是否正常。重新配置config.json的必要字段，尝试重新连接恢复
- [云手机查询接口调用出错如何处理？](https://support.huaweicloud.com/cph_faq/cph_faq_0031.md): 接口调用出错将无法获取建立相应隧道连接的必要信息，将无法正常连接云手机设备实例，具体报错示例如下：首先，尝试使用adb connect重新建立连接，依旧报错可通过查看安装目录下的日志adb.tunnel.log中的输出获得进一步的信息，通常可以通过检查下面内容进行规避错误检查配置文件中AK/SK是否正确，服务器所在region是否正确。检
- [通过公网访问云手机时，建立SSH隧道失败了，如何解决？](https://support.huaweicloud.com/cph_faq/cph_faq_0005.md): 若您建立SSH隧道失败，请重点排查以下命令的参数是否正确。ssh -L 本地空闲端口:云手机监听IP:云手机监听端口 SSH隧道用户名@公网IP地址 -i 私钥文件路径 -Nf检查参数“本地空闲端口”是否被占用了。确保您获取的是“实例监听端口”而非“服务器监听端口”。检查“SSH隧道用户名”使用的是项目ID，请参考如何获取项目ID？。创建
- [建立SSH隧道时提示“Authorized users only. All activities may be monitored and reported.”，是什么意思？](https://support.huaweicloud.com/cph_faq/cph_faq_0007.md): “Authorized users only. All activities may be monitored and reported.”是SSH隧道建立成功的提示，如图1所示。如果SSH隧道建立失败，会在这个提示下显示“Permission denied”、“Connection closed”等报错信息。
- [建立SSH隧道时报错“too open”？](https://support.huaweicloud.com/cph_faq/cph_faq_0008.md): 在连接云手机时，建立SSH隧道报“too open”的错误，具体如图1所示。用户的私钥文件权限过于开放，所以建立SSH隧道时被拒绝了。按以下操作修改私钥文件的权限：如果用户的本地设备为Linux操作系统，可以在Linux环境执行chmod 600 KeyPair-test.pem来设置。如果用户的本地设备为Windows操作系统，请按照如
- [建立SSH隧道时报错“Permission denied”？](https://support.huaweicloud.com/cph_faq/cph_faq_0016.md): 在连接云手机时，建立SSH隧道报“Permission denied”的错误，具体如图1所示。检查建立SSH隧道的命令中，SSH隧道用户名（即项目ID），是否与云手机所在区域相匹配。ssh -L 本地空闲端口:云手机监听地址 SSH隧道用户名@公网IP地址 -i 私钥文件路径 -Nf如果问题仍未解决，请执行2继续排查。ssh -L 本地空
- [建立SSH隧道时报错“no match mac found”？](https://support.huaweicloud.com/cph_faq/cph_faq_0017.md): 本地使用macOS系统连接云手机时，建立SSH隧道报“no match mac found”的错误，具体如下所示：这个问题一般是由OpenSSH引起的，可能因为下载了多个版本的OpenSSH，或者下载的OpenSSH不兼容。对于系统自带SSH的场景较少出现此问题。以Windows 10 为例:打开“控制面板 > 程序 > 卸载程序”，单击
- [建立SSH隧道时报错“no matching key exchange method found”？](https://support.huaweicloud.com/cph_faq/cph_faq_0036.md): 在连接云手机时，建立SSH隧道报“no matching key exchange method found”的错误，具体如下所示：这个问题一般是由SSH客户端与SSH服务端建立连接时找不到匹配的KexAlgorithms算法引起的，在云手机场景下，通常是SSH客户端的版本过低导致的。以Windows 10 为例:将OpenSSH程序升级
- [如何保持SSH会话不中断？](https://support.huaweicloud.com/cph_faq/cph_faq_0011.md): 在连接云手机时，可能会因为长时间不操作，导致SSH会话超时退出。如果已经通过ADB连接上云手机，那么超时退出后，将无法继续执行adb shell相关命令。在建立SSH隧道时，命令中添加“ -o ServerAliveInterval=30”参数。那么完整的命令为：ssh -L 本地空闲端口:云手机监听地址 SSH隧道用户名@公网IP地址 
- [建立隧道连接失败如何处理？](https://support.huaweicloud.com/cph_faq/cph_faq_0030.md): 建立隧道连接失败或adb devices显示对应设备状态为offline，将表示建连云手机设备实例失败，首先尝试使用adb connect重新建连，若依旧无法建连，则执行以下操作：检查访问密钥文件是否为相应服务器的访问密钥。前往云手机控制台页面，检查相应云手机实例运行状态是否正常。重新配置config.json的必要字段，尝试重新连接恢复
- [云手机查询接口调用出错如何处理？](https://support.huaweicloud.com/cph_faq/cph_faq_0031.md): 接口调用出错将无法获取建立相应隧道连接的必要信息，将无法正常连接云手机设备实例，具体报错示例如下：首先，尝试使用adb connect重新建立连接，依旧报错可通过查看安装目录下的日志adb.tunnel.log中的输出获得进一步的信息，通常可以通过检查下面内容进行规避错误检查配置文件中AK/SK是否正确，服务器所在region是否正确。检
- [ADB连接云手机时报错“unable to connect to :5555”？](https://support.huaweicloud.com/cph_faq/cph_faq_0024.md): 在连接云手机时，建立SSH隧道成功后，执行ADB连接命令时报“unable to connect to :5555”的错误，具体如图1所示。ADB调试模式为USB，需要切换到无线调试模式。在命令行窗口执行adb tcpip 本地空闲端口后，再使用adb connect 127.0.0.1:本地空闲端口命令重新连接。
- [ADB连接突然中断，如何解决？](https://support.huaweicloud.com/cph_faq/cph_faq_0025.md): ADB连接突然中断，且执行adb devices无已连接设备显示。ADB连接突然中断，可能是因为用户本地物理设备网络闪断，或者ADB工具本身的原因。采用重启adb服务的方式恢复，操作步骤如下：关闭adb服务。adb kill-serveradb kill-server启动adb服务。adb start-serveradb start-se
- [云手机ADB连接出错如何处理？](https://support.huaweicloud.com/cph_faq/cph_faq_0032.md): 云手机ADB工具集成隧道连接服务，所有的云手机建连过程都依赖隧道服务能够正常运行，您可使用adb kill-server和adb start-server命令重启ADB及云手机隧道连接服务。同时，您需要检查系统环境变量PATH中是否存在其它版本ADB工具所在路径，若存在，需要将其它版本ADB工具移除。其他常见配置错误如下：错误: Erro
- [ADB连接云手机时报错“unable to connect to :5555”？](https://support.huaweicloud.com/cph_faq/cph_faq_0024.md): 在连接云手机时，建立SSH隧道成功后，执行ADB连接命令时报“unable to connect to :5555”的错误，具体如图1所示。ADB调试模式为USB，需要切换到无线调试模式。在命令行窗口执行adb tcpip 本地空闲端口后，再使用adb connect 127.0.0.1:本地空闲端口命令重新连接。
- [ADB连接突然中断，如何解决？](https://support.huaweicloud.com/cph_faq/cph_faq_0025.md): ADB连接突然中断，且执行adb devices无已连接设备显示。ADB连接突然中断，可能是因为用户本地物理设备网络闪断，或者ADB工具本身的原因。采用重启adb服务的方式恢复，操作步骤如下：关闭adb服务。adb kill-serveradb kill-server启动adb服务。adb start-serveradb start-se
- [云手机ADB连接出错如何处理？](https://support.huaweicloud.com/cph_faq/cph_faq_0032.md): 云手机ADB工具集成隧道连接服务，所有的云手机建连过程都依赖隧道服务能够正常运行，您可使用adb kill-server和adb start-server命令重启ADB及云手机隧道连接服务。同时，您需要检查系统环境变量PATH中是否存在其它版本ADB工具所在路径，若存在，需要将其它版本ADB工具移除。其他常见配置错误如下：错误: Erro