# 云手机服务 KooPhone > 优体验、高安全的政企云手机服务 ## 产品介绍 - [图解云手机服务](https://support.huaweicloud.com/productdesc-koophone/kp_03_0016.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [什么是云手机服务](https://support.huaweicloud.com/productdesc-koophone/kp_03_0001.md): 云手机服务（KooPhone）是华为云面向政企、互联网等客户推出的一款优体验、高安全的云手机服务，融合了ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，并引入华为丰富的应用生态，为更多带屏联网设备提供云算力和云应用的能力。KooPhone充分发挥端云协同的优势，提供端云交互、麦克风和摄像头等各类传感器的模拟仿真，以及应用和数据权 - [业务模式介绍](https://support.huaweicloud.com/productdesc-koophone/kp_03_0019.md): 在使用云手机服务之前，需要先选择业务模式。云手机服务提供以下业务模式：节点版：整台物理ARM服务器、逻辑资源池，是实例的底层载体。一个节点可虚拟化出多个实例，实例共享节点的CPU、内存、GPU、网络等资源。实例版：云端创建的独立虚拟手机单元，每个实例等同于一台完整的虚拟手机，有独立的OS、CPU/内存/存储、IP、设备指纹，可独立启停、管 - [产品优势](https://support.huaweicloud.com/productdesc-koophone/kp_03_0002.md): 端到端操作响应时延减少到百毫秒以内，操控无延迟感知。面向场景进行针对性优化，实现高清画质流畅体验。在网络丢包、错包和冲突不可避免情况下，实现弱网对抗。开机即云机，覆盖多类云OS。支持多系统便捷切换，云手机、云PC，原生系统任意切换。统一账号体系，满足办公、娱乐等多场景用户诉求。支持多系统便捷切换，云手机、云PC，原生系统任意切换。统一账号 - [应用场景](https://support.huaweicloud.com/productdesc-koophone/kp_03_0003.md): 企业的传统实体办公手机缺少防截屏、应用管控及监控等统一防护手段，信息安全防护困难；数据资产分散到各实体手机本地，难以沉淀、统计和管理；手机硬件资产易丢失和毁损，应用和数据更新周期长、维护成本高。KooPhone在端侧提供防截屏、防拍照录像、加实时水印等安全特性，严格管控数据外泄；在云侧具备数据统一监控、安全加固，应用集中管理、一键分发、统 - [节点版](https://support.huaweicloud.com/productdesc-koophone/kp_03_0009.md): 云手机提供以下产品功能：支持在控制台的应用库界面将应用软件包上传至应用库，应用上传成功可将应用部署到镜像中。有关更多信息，请参阅管理云手机应用库。管理员购买节点后，在控制台的资源管理页面：支持创建节点组统一管理实例，提升系统的稳定性、效率和灵活性，降低管理成本。支持查询节点的规格、已购开数/开数、状态等，对异常节点进行维护。支持查询实例规 - [实例版](https://support.huaweicloud.com/productdesc-koophone/kp_03_0007.md): 云手机提供以下产品功能：管理员购买实例后，在控制台的实例管理页面：支持实例关机、开机、重启、删除、应用卸载。支持查询实例运行、备份状态、到期时间等。有关更多信息，请参阅实例管理。支持在控制台的应用部署界面将应用软件包上传至应用库，应用上传成功可将应用部署到购买的实例中。有关更多信息，请参阅管理云手机应用库。云手机支持在安全管控策略页面对购 - [节点版](https://support.huaweicloud.com/productdesc-koophone/kp_03_0018.md): 云手机服务当前仅提供一种节点规格和实例规格，详细介绍请参考表1。 - [实例版](https://support.huaweicloud.com/productdesc-koophone/kp_03_0010.md): 云手机服务分为基础版、专业版和企业版，每个版本提供不同规格的实例，详细介绍请参考表1。 - [原理介绍](https://support.huaweicloud.com/productdesc-koophone/kp_03_0006.md): KooPhone手机端与云端之间的协同工作。手机端和云端各自承担不同的工作，共同完成手机的功能。手机端负责处理用户的输入、显示和操作等任务，而云端则负责处理大量的数据存储、处理和运算等工作。通过KooPhone端云协同，用户可以体验到近似真机的流畅操作体验。KooPhone使用独有的编码技术，如纠错码、压缩算法等，来保证数据在传输过程中的 - [权限管理](https://support.huaweicloud.com/productdesc-koophone/kp_03_0011.md): 如果您需要对华为云上购买的KooPhone资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全地控制华为云资源的访问。如果华为账号已经能 - [约束与限制](https://support.huaweicloud.com/productdesc-koophone/kp_03_0012.md): KooPhone服务使用时存在如下约束与限制：仅限已通过华为云企业认证的用户购买使用。用户不能使用KooPhone进行挂机、刷单等灰产，违法以及违反安全要求等行为。违反相关要求，用户云机会被受限/冻结。实例暂不支持规格变更（比如：变更云机CPU核数、内存、存储空间大小），如果需要调整规格，请将实例退订后重新购买符合要求的规格。华为云账户受 - [基本概念](https://support.huaweicloud.com/productdesc-koophone/kp_03_0014.md): 实例是一台包含手机操作系统以及基础系统应用，并在云端运行的虚拟手机。您可以在实体终端通过App、H5等方式登录并操控实例，得到与实体手机相同的使用体验，包括运行应用、玩游戏、拍照、移动办公等。节点是容器集群组成的基本元素。节点取决于业务，既可以是虚拟机，也可以是物理机。每个节点都包含运行Pod所需要的基本组件，包括Kubelet、Kube ## 计费说明 - [计费概述](https://support.huaweicloud.com/price-koophone/kp_00_0001.md): 通过阅读本文，您可以快速了解云手机服务（KooPhone）的计费模式、计费项、续费、欠费等主要计费信息。计费模式云手机服务的节点版提供了包年/包月的计费模式，实例版提供包年/包月、按需计费两种计费模式，以满足不同场景下的用户需求。包年/包月是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算，因此在购买之前，您必须确保账户余额充足 - [计费模式概述](https://support.huaweicloud.com/price-koophone/kp_00_0003.md): 云手机服务的节点版提供了包年/包月的计费模式，实例版提供包年/包月、按需计费两种计费模式，以满足不同场景下的用户需求。包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。一般适用于设备需求量长期稳定的成熟业务。按需计费：一种后付费模式，即先使用再付费，按照云手机的实际使用时长计费，秒级计费，按小时结算。计费的起点以实例 - [包年/包月](https://support.huaweicloud.com/price-koophone/kp_00_0004.md): 包年/包月是一种先付费再使用的计费模式，适用于对资源需求稳定且希望降低成本的用户。本文将介绍包年/包月云手机服务的计费规则。包年/包月计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年/包月计费模式的业务场景：稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业客服远程协同、日常办公等，包年/包 - [按需计费](https://support.huaweicloud.com/price-koophone/kp_00_0005.md): 按需计费是一种先使用再付费的计费模式，适用于无需任何预付款或长期承诺的用户。本文将介绍按需计费KooPhone资源的计费规则。目前仅云手机的实例版支持按需计费。按需计费适用于具有不能中断的短期、突增或不可预测的应用或服务，例如电商抢购、临时测试。KooPhone根据您购买的实例规格、购买数量、购买时长进行计费。以下计费项支持按需计费。按需 - [计费项](https://support.huaweicloud.com/price-koophone/kp_00_0006.md): 云手机服务的节点版计费项由节点规格、实例规格、购买数量、购买时长进行计费，实例版计费项由实例规格、购买数量、购买时长或使用时长进行计费。具体内容如表2所示。以包年/包月（实例版）计费模式为例，假设您在2023/02/08 15:09:56购买了一台包年/包月的云手机资源。购买时长为一个月，并在到期前手动续费1个月，则：第一个计费周期为：2 - [计费样例](https://support.huaweicloud.com/price-koophone/kp_00_0007.md): 某用户于2023/06/16 00:00:00购买了一台包年/包月（实例版）计费的云手机资源，规格配置如下：规格：专业版 4核 8GB内存 64GB存储用了一段时间后，用户发现云手机当前规格无法满足业务需要，于2023/6/28 8:58:30退订云手机。因为业务需要继续使用高存储的云手机，于2023/06/29 00:00:00重新订 - [变更计费模式概述](https://support.huaweicloud.com/price-koophone/kp_00_0022.md): 在购买实例版资源后，如果发现当前计费模式无法满足业务需求，您可以变更计费模式。目前仅实例版资源支持变更计费模式，变更计费模式的规格如表1所示。 - [包年/包月转按需](https://support.huaweicloud.com/price-koophone/zh-cn_topic_0000002158545545.md): 创建一个包年/包月实例后，您可以将该实例的计费模式转为按需计费，回收部分成本，同时更加灵活地按需使用实例。包年/包月立即转按需会退还当前周期的剩余费用，订单完成后，按需的计费模式立即生效。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。对包年/包月实例设置到期转按需，设置后包年/包月计费模式到期后，按需的计费模式生效。如果 - [续费概述](https://support.huaweicloud.com/price-koophone/kp_00_0009.md): 包年/包月云手机到期后会影响云手机正常运行。如果您想继续使用，需要在指定的时间内为云手机续费，否则实例等资源会自动释放，数据丢失且不可恢复。续费操作仅适用于包年/包月的云手机，按需计费的云手机不需要续费，只需要保证账户余额充足即可。云手机在到期前续费成功，所有资源得以保留，且云手机的运行不受影响。云手机到期后的状态说明，请参见到期后影响。 - [手动续费](https://support.huaweicloud.com/price-koophone/kp_00_0010.md): 仅实例版资源支持在云服务控制台续费。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。单个续费：在实例列表选择一个需要续费的实例，在右侧操作列选择“更多 > 续费”。批量续费：在实例列表选择一个或多个需要续费的实例，在列表左上方选择“续费”。可在“手动续费项”“自动续费项”“到期转按需项”“到期不续费项”页签查询全部待续费资 - [自动续费](https://support.huaweicloud.com/price-koophone/kp_00_0011.md): 自动续费可以减少手动续费的管理成本，避免因忘记手动续费而导致云手机被自动删除。自动续费的规则如下所述：以云手机的到期日计算第一次自动续费日期和计费周期。云手机自动续费周期根据以您选择的续费时长为准。按月购买：自动续费周期为1个月。（若购买时长为3个月，云手机将在到期前自动续费1个月。）按年购买：自动续费周期为1年。（若购买时长为2年，云手 - [费用账单](https://support.huaweicloud.com/price-koophone/kp_00_0012.md): 用户可以在费用费用账单界面，查看服务使用的费用账单情况，以便了解在某个时间段的使用量和计费信息。包年包月计费模式的资源完成支付后，会实时上报一条账单到计费系统进行结算。按需计费模式按小时结算。示例：用户在8:00~9:00期间订购云手机，通常会在10:00左右才进行扣费。在“费用中心 > 账单管理 > 流水和明细账单 > 流水账单”中，“ - [欠费说明](https://support.huaweicloud.com/price-koophone/kp_00_0013.md): 用户在使用云手机服务时，账户的可用额度小于待结算的账单，即被判定为账户欠费。在按需计费模式下账户的余额不足。包年/包月对于包年/包月计费模式KooPhone，用户已经预先支付了云手机费用，因此在账户出现欠费的情况下，已有的包年/包月计费模式KooPhone仍可正常使用。然而，对于涉及费用的操作，如续费订单等，用户将无法正常进行。对于包年/ - [停止计费](https://support.huaweicloud.com/price-koophone/kp_00_0014.md): 对于包年/包月计费模式的云手机，用户在购买时会一次性付费，服务将在到期后自动停止使用。如果在计费周期内不再使用包年/包月资源，您可以执行退订操作，系统将根据资源是否属于五天无理由退订、是否使用代金券和折扣券等条件返还一定金额到您的账户。详细的退订规则请参见云服务退订规则概览。对于按需计费模式的云手机，若不再使用且需停止计费，请删除相应资源 - [成本管理](https://support.huaweicloud.com/price-koophone/kp_00_0015.md): KooPhone提供节点版和实例版，每个版本包含不同规格的资源，对应不同的官网价。节点版以节点/整台服务器为单位购买，实例共享节点资源，适用于企业批量多开、手游工作室、APP自动化测试、大规模群控与运维。实例版以实例为单位购买，实例间强隔离，互不抢占资源，适用于小团队、轻量测试、独立办公环境。目前只提供了一种规格和实例，提供端云协同，设备 - [KooPhone计费模式是什么？](https://support.huaweicloud.com/price-koophone/kp_00_0017.md): KooPhone的节点版提供了包年/包月的计费模式，实例版提供包年/包月、按需计费两种计费模式，供您灵活选择。按包年/包月计费：提供包年/包月的购买模式。按需计费：即开即停，支持秒级计费。 - [包年/包月和按需计费模式有什么区别？](https://support.huaweicloud.com/price-koophone/kp_00_0018.md): 包年/包月的计费模式是一种预付费方式，按订单的购买周期计费，适用于可预估云手机使用周期的场景，价格比按需计费模式更优惠。包年/包月计费模式的KooPhone使用说明：“包年/包月”的云手机购买后不能删除，如需停止使用，请执行退订操作。节点版：在云手机的节点版页面，选择“资源管理 > 节点组”进入节点组页面，单击页面的“续费/退订”，跳转至 - [如何支付云手机费用？](https://support.huaweicloud.com/price-koophone/kp_00_0019.md): 用户使用前可通过在线支付、转账汇款等支付方式完成华为云账号充值。详细操作请参见账户充值。包年/包月的计费模式为预付费，按照订单的购买周期结算。按需计费为后付费，按照云手机的实际使用时长计费。 ## 快速入门 - [快速上手云手机（节点版）](https://support.huaweicloud.com/qs-koophone/kp_04_0014.md): 首次使用云手机服务的流程如图1所示，通过该章节您可以了解云手机的基本操作流程，帮助您更快上手操作。注册华为账号并开通华为云具体操作请参考注册华为账号并开通华为云。具体操作请参考注册华为账号并开通华为云。完成实名认证参考实名认证完成企业账号实名认证。参考实名认证完成企业账号实名认证。（可选）为账户充值请为账户充值，也可当在线订单生成后，根据 - [快速上手云手机（实例版）](https://support.huaweicloud.com/qs-koophone/kp_04_0001.md): 首次使用云手机服务的流程如图1所示，通过该章节您可以了解云手机的基本操作流程，帮助您更快上手操作。注册华为账号并开通华为云具体操作请参考注册华为账号并开通华为云。具体操作请参考注册华为账号并开通华为云。完成实名认证参考实名认证完成企业账号实名认证。参考实名认证完成企业账号实名认证。（可选）为账户充值请为账户充值，也可当在线订单生成后，根据 ## 用户指南 - [云手机服务概述](https://support.huaweicloud.com/usermanual-koophone/kp_05_0001.md): 云手机服务（KooPhone）是华为云基于ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，通过引入华为终端丰富的应用生态，面向政企、互联网等客户推出的一款优体验、高安全云服务。云手机服务提供以下业务模式：实例版：云端创建的独立虚拟手机单元，每个实例等同于一台完整虚拟手机，有独立的OS、CPU/内存/存储、IP、设备指纹，可独立启 - [通过IAM角色和策略授予使用KooPhone的权限](https://support.huaweicloud.com/usermanual-koophone/kp_05_0083.md): 如果您需要对您所拥有的KooPhone资源进行角色与策略的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以：根据企业的业务组织，在您的华为账号中，给企业中不同职能部门的员工创建用户或用户组，让员工拥有唯一安全凭证，并使用KooPhone资源。根据企业用户的 - [通过IAM身份策略授予使用KooPhone的权限](https://support.huaweicloud.com/usermanual-koophone/kp_05_0017.md): 如果您需要对您所拥有的KooPhone资源进行身份策略的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以：根据企业的业务组织，在您的华为账号中，给企业中不同职能部门的员工创建用户或用户组，让员工拥有唯一安全凭证，并使用KooPhone资源。根据企业用户的职 - [云手机业务流程介绍](https://support.huaweicloud.com/usermanual-koophone/kp_05_0035.md): 使用云手机的业务流程如图1所示。通过IAM授予使用KooPhone的权限通过IAM用户，并授权控制对华为云资源的访问和操作权限，以达到用户之间权限的隔离。通过IAM用户，并授权控制对华为云资源的访问和操作权限，以达到用户之间权限的隔离。创建节点组节点组是具有相同配置的一组节点，一个节点组包含一个或多个节点，可以帮助用户更好地管理云手机内的 - [购买云手机](https://support.huaweicloud.com/usermanual-koophone/kp_05_0009.md): 在开展云手机业务之前，需要先购买云手机。已完成注册华为账号并开通华为云。参考实名认证完成企业账号实名认证。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。也可以在“云手机快速入门”下单击“购买资源”跳转至购买页。耐心等待几分钟，待“云手机服务 >资源管理 > 节点”的列表中出现购买的节点，即订购成功。节点版云手机购买成功后 - [管理云手机应用库](https://support.huaweicloud.com/usermanual-koophone/kp_05_0010.md): 在应用库管理页面，展示租户已创建的应用，并支持租户创建新应用，对已创建的应用进行管理。在应用库管理页面，支持创建普通应用和共享应用。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。创建普通应用参数说明参数说明应用包单击上传文件，选择本地应用apk文件。上传的apk文件不能超过4GB。上传过程中支持显示解析过程。如果检测存在 - [创建和管理云手机自定义镜像](https://support.huaweicloud.com/usermanual-koophone/kp_05_0012.md): 云手机服务提供了自定义镜像功能，用户可以根据需求创建自定义镜像。创建成功后，自定义镜像页面展示镜像名称/ID、应用数、部署数等信息。当前节点版和实例版总计最多可创建10个自定义镜像，若达到上限，请先删除不必要的镜像再进行操作。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。默认提供10个系统原生应用。当前版本仅支持从应用库 - [查看云手机公共镜像详情](https://support.huaweicloud.com/usermanual-koophone/kp_05_0014.md): 公共镜像页面展示系统预置公共镜像的详细信息，可在左侧导航栏选择“镜像中心 > 公共镜像”进入公共镜像页面查看。如果当前版本为实例版，请先单击“切换至节点版”以切换到节点版页面。在搜索栏输入镜像名称/ID等关键词可进行筛选。单击列表右上方设置按钮，可配置基础设置。单击“超长文本完整显示”下的，可开启超长文本完整显示。开启后文本会自动换行显示 - [配置云手机节点组](https://support.huaweicloud.com/usermanual-koophone/kp_05_0018.md): 租户在控制台创建节点组，可以更好地管理云手机内的节点，一个节点组包含一个节点或多个节点。租户可以选择在控制台创建空节点组，或在创建节点组后并立即购买云手机。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。创建成功后，可在节点组列表中查看已创建的节点组。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。购买页中 - [管理云手机节点](https://support.huaweicloud.com/usermanual-koophone/kp_05_0019.md): 节点页面展示已购节点的详细信息和异常/初始化中/维护中的节点数据，您可以对节点进行维护，或重启异常节点。初始化：购买后，节点将自动进行初始化，即状态显示为“初始化中”，还未开始初始化的节点状态显示为“未初始化”，镜像或策略变更中的节点状态显示为“初始化中”。就绪：初始化完成后，状态切换至“就绪”。维护中：进入维护的节点状态显示“维护中”。 - [查看实例详情](https://support.huaweicloud.com/usermanual-koophone/kp_05_0020.md): 实例页面展示已购实例的详细信息，可在左侧导航栏选择“云手机 > 资源管理 > 实例”进入实例页面查看。如果当前版本为实例版，请先单击“切换至节点版”以切换到节点版页面。在搜索栏输入实例ID、区域等关键词可进行筛选。实例列表默认展示信息包括实例名称/ID、实例规格、区域、所属节点组名称/ID、创建时间、更新时间、计费模式。单击列表右上方设置 - [配置云手机策略](https://support.huaweicloud.com/usermanual-koophone/kp_05_0022.md): 云手机支持对节点组中的实例进行防截屏、视频水印、数据流传输加密、显示规则等功能的配置，用户还可根据需求创建策略，以满足高安全、高可靠性业务场景需求。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。创建完成并在节点组使用该策略后，该节点组下的所有实例都将应用此策略。创建策略后，您可还以进行以下操作。克隆策略适用于需要快速复制 - [配置CORS实现跨域访问云手机](https://support.huaweicloud.com/usermanual-koophone/kp_05_0023.md): 您可以通过设置CORS，允许跨域请求访问云手机中的资源。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。添加成功后，允许来自该域名下的请求访问云手机中的资源。添加CORS来源后，您还可以进行以下操作。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。修改成功后，CORS规则管理的列表中展示修改后的信息。如果当 - [设置云手机应用管控规则](https://support.huaweicloud.com/usermanual-koophone/kp_05_0024.md): 在应用管控规则页面，您可以创建应用黑名单和白名单，以便对云手机的使用进行应用级安全管控。创建应用黑白名单后，关联了黑名单的云手机无法安装该黑名单中的应用，关联了白名单的云手机仅支持安装该白名单中的应用。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。创建完成后，可在应用管控规则的列表中查看该规则。创建应用管控规则后，您可还 - [设置云手机显示规则](https://support.huaweicloud.com/usermanual-koophone/kp_05_0025.md): 在显示规则页面，支持配置云手机的视频编码格式和画质浮动范围等。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。创建完成后，可在显示规则的列表中查看该规则。创建显示规则后，您可还以进行以下操作。克隆应用管控规则适用于需要快速复制已创建好的规则的场景。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。提交完成后， - [查询云手机任务](https://support.huaweicloud.com/usermanual-koophone/kp_05_0027.md): 任务页面展示正在执行的、已完成的以及执行失败的任务的详细信息，可在左侧导航栏选择“云手机服务 > 运维与监控 > 任务”进入任务页面查看。如果当前版本为实例版，请先单击“切换至节点版”以切换到节点版页面。可通过选择日期、任务类型筛选任务。任务列表默认展示信息包括任务ID、任务类型、执行进展、执行结果、执行开始时间、执行结束时间。单击列表右 - [云手机业务流程介绍](https://support.huaweicloud.com/usermanual-koophone/kp_05_0036.md): 使用云手机的业务流程如图1所示。通过IAM授予使用KooPhone的权限通过IAM用户，并授权控制对华为云资源的访问和操作权限，以达到用户之间权限的隔离。通过IAM用户，并授权控制对华为云资源的访问和操作权限，以达到用户之间权限的隔离。购买云手机云手机当前有基础版、专业版和企业版，详细版本类型介绍请参考实例规格。云手机当前有基础版、专业版 - [购买云手机](https://support.huaweicloud.com/usermanual-koophone/kp_05_0005.md): 云手机服务提供不同规格的实例，请结合需要进行购买。已完成注册华为账号并开通华为云。参考实名认证完成企业账号实名认证。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。也可以通过以下两种方式跳转至购买页：在“云手机快速入门”的“云手机”下单击“去购买”跳转至购买页。在“云手机推荐”下选择对应规格单击“立即购买”跳转至购买页。选 - [查看实例详细信息](https://support.huaweicloud.com/usermanual-koophone/kp_05_0007.md): 在实例管理页面，实例列表区域可以查看到实例详细信息。单击实例列表右上方设置按钮，可自定义实例列表展示参数，必选与可选项详见表1。参数说明参数是否必选参数说明实例名称/ID是实例名称：购买云手机时的实例名称。实例ID：系统会给实例分配一个实例ID，用于标记该实例。区域是云手机的物理数据中心所在的位置，区域不同即物理数据中心距离用户的物理距离 - [管理实例](https://support.huaweicloud.com/usermanual-koophone/kp_05_0002.md): 在实例管理页面，您可以进行重启实例、开/关机实例、对实例进行续费等操作。运行状态为“运行中”的实例可以操作重启。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。在实例列表中选择一个或多个需要重启的实例，单击列表左上方的“重启”。在实例列表中选择一个需要重启的实例，在右侧操作列中选择“重启”。实例重启后，进入运行中状态。运行 - [管理云手机应用库](https://support.huaweicloud.com/usermanual-koophone/kp_05_0041.md): 应用库管理页面提供了上传应用包、删除应用包、指定实例安装应用等功能。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。上传应用参数说明参数参数说明应用名称用户上传应用时填写的应用名称。只能由英文字母、数字、中文字符、短横线（-）、下划线（_）和点（.）组成，且长度为1-20个字符。应用描述用户上传应用时填写的应用描述。只能由 - [查询云手机应用部署详情](https://support.huaweicloud.com/usermanual-koophone/kp_05_0042.md): 应用部署查询页面展示用户进行应用安装、卸载的任务。在搜索栏输入应用包名可进行任务筛选，或者单击任务类型、执行状态旁的筛选按钮进行筛选。任务列表默认展示信息包括任务ID、任务类型、应用包名、实例数、下发时间、执行状态等。单击任务列表右上方设置按钮，可自定义任务列表展示参数，必选与可选项详见表1。参数说明参数参数说明任务ID必选项，系统自动生 - [为云手机设置防截屏](https://support.huaweicloud.com/usermanual-koophone/kp_05_0061.md): 云手机提供了防截屏功能，您可以通过控制台为已购买的实例设置开启或关闭防截屏功能，以增强安全性和保护隐私。开启后，用户在客户端使用时不允许截屏。通过控制台开启防截屏功能后，使用该云手机的用户无法截取页面。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。用户可以为云手机关闭防截屏功能。 - [为云手机设置视频水印](https://support.huaweicloud.com/usermanual-koophone/kp_05_0062.md): 云手机提供了视频水印功能，您可以通过控制台为已购买的实例设置开启或关闭视频水印功能，以增强安全性和保护隐私。开启后，云手机客户端画面将嵌入可见的ID的水印。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。开启视频水印后，云手机客户端画面将嵌入可见的ID信息水印。用户可以为云手机关闭视频水印功能。 - [为云手机设置应用黑白名单](https://support.huaweicloud.com/usermanual-koophone/kp_05_0063.md): 在应用黑白名单页面，您可以创建应用黑名单和白名单，以便对云手机的使用进行应用级安全管控。创建应用黑白名单后，关联了黑名单的云手机无法安装该黑名单应用，关联了白名单的云手机仅支持安装该白名单应用。黑白名单列表区域显示其他所有租户创建好的名单。如果当前应用列表区域没有适合的黑白名单，您可以选择创建新的黑白名单。如果当前版本为节点版，请单击“切 - [为云手机设置数据流传输加密](https://support.huaweicloud.com/usermanual-koophone/kp_05_0064.md): 云手机支持开启数据流传输加密，开启后即可保护云手机云侧和端侧的交互数据。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。 - [创建和管理云手机自定义镜像](https://support.huaweicloud.com/usermanual-koophone/kp_05_0070.md): 云手机服务提供了自定义镜像功能，用户可以通过控制台创建镜像。创建成功后，自定义镜像页面展示镜像名称/ID、镜像描述、预装应用等信息。当前实例版和节点版总计最多可创建10个自定义镜像，若达到上限，请先删除不必要的镜像再进行操作。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。当前仅支持从应用库中选择应用，若未找到想要预装的应 - [配置CORS实现跨域访问云手机](https://support.huaweicloud.com/usermanual-koophone/kp_05_0105.md): 您可以通过设置CORS，允许跨域请求访问云手机中的资源。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。添加成功后，允许来自该域名下的请求访问云手机中的资源。添加来源后，您还可以进行以下操作。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。删除 - [管理云手机回调事件](https://support.huaweicloud.com/usermanual-koophone/kp_05_0106.md): 您可以通过控制台，设置接收回调事件通知的事件类型和回调地址。如果当前版本为节点版，请单击“切换至实例版”以切换到实例版页面。获取后，请记录您的密钥。密钥仅可查看一次，遗忘需单击“重置密钥”重新生成。添加完成后，在“回调事件管理”页面可查看已添加的回调事件。添加并配置回调事件后，您还可以进行以下操作。如果当前版本为节点版，请单击“切换至实例 ## 开发指南 - [Android SDK开发概述](https://support.huaweicloud.com/devg-koophone/kp-00_00002.md): KooPhone端SDK结合云OS自定义镜像能力，融合ARM服务器虚拟化、音视频编解码与实时传输等核心技术，为各类带屏联网设备提供统一的云算力和云应用赋能框架。KooPhone Android SDK开发指南将指导您如何在APP客户端中，快速集成端SDK的基线能力，充分发挥端侧与云侧的协同优势。通过标准化的SDK架构，提供端云交互、传感器 - [总体开发思路](https://support.huaweicloud.com/devg-koophone/kp-00_00003.md): Android SDK提供的全量接口能力及调用须知详见SDK参考。本开发指导以及后续代码示例将分别面向初阶和中阶Android开发者，提供最基础的以及相对功能完善、健全的APP开发示例。已经非常熟悉Android工程开发和Android aar SDK调用的开发者，可以直接基于包含全量功能介绍的SDK参考进行自定义Android APP的 - [快速开始](https://support.huaweicloud.com/devg-koophone/kp-00_00004.md): 本章节以开发Android客户端为例，帮助用户理解基础的Android客户端开发流程以及如何集成KooPhone Android端SDK，主要包含两个基本功能，发起云手机连接与断开云手机连接。本章节所有开发示例均为展示基本功能的实现，仅供参考。准备开发Android客户端的环境/工具。开发工具：Android Studio （推荐最新版本 - [开发概述](https://support.huaweicloud.com/devg-koophone/kp-00_00006.md): 本开发示例展示了如何在Android应用中集成并使用KooPhone端SDK，通过调用SDK提供的API接口，开发者可以快速实现云手机串流控制、设备管理、音视频配置、远程操作等功能。示例代码结构清晰，包含初始化SDK、连接控制、回调注册等核心流程，便于开发者快速上手并嵌入到实际项目中。所有接口调用均遵循SDK的标准规范，开发者可根据实际需 - [准备工作](https://support.huaweicloud.com/devg-koophone/kp-00_00007.md): 在基于Android SDK开发客户端之前，需要了解相关开发基础知识，准备Android开发环境。熟悉Java开发语言基础。熟悉基本的Android客户端开发知识。开发工具：Android Studio （推荐最新版本）JDK版本：>= 1.8最小SDK：API 23或更高下载KooPhone端aar SDK包 - [开发指导](https://support.huaweicloud.com/devg-koophone/kp-00_00008.md): 本章节通过一个典型客户端应用的接入示例，介绍如何集成SDK并完成最小可运行环境搭建。示例包含初始化SDK、获取鉴权信息、启动主界面串流以及基础配置等内容，帮助开发者完成快速接入。开发者在阅读本章节前，默认已经完成快速开始中的步骤一~步骤三，包含以下内容：创建Android工程、集成aar SDK包、配置Gradle依赖、配置BuildCo - [代码示例](https://support.huaweicloud.com/devg-koophone/kp-00_00009.md): 以下代码仅为示例之一， 用户也可通过调用其他API方法实现获取设备的device_token接口，可参考租户实例串流前获取设备的device_token，用于串流前身份鉴权。工程目录结构代码示例最小化实现了云手机串流、断流的能力。关键文件实现代码示例：模块级构建配置app/build.gradle代码示例：apply plugin: 'c - [注意事项](https://support.huaweicloud.com/devg-koophone/kp-00_00010.md): 开发过程中，需要注意：Activity配置：必须设置为singleTask启动模式，并处理相关配置变更。Fragment管理：确保PlayerFragment正确绑定和显示。异常处理：使用try-catch包裹start方法调用。资源清理：在Activity销毁时调用clearBundle清理资源。UI线程：回调方法中需要切换到UI线程进 - [JavaScript SDK开发概述](https://support.huaweicloud.com/devg-koophone/kp-00_00012.md): KooPhone JavaScript SDK，配合云OS自定义镜像能力，融合ARM服务器虚拟化、音视频编解码与实时传输等核心技术，为各类带屏联网设备提供统一的云算力和云应用赋能框架。KooPhone JavaScript SDK开发指南将指导您如何在Html页面中，快速集成JavaScript SDK的基线能力，充分发挥端侧与云侧的协同 - [总体开发思路](https://support.huaweicloud.com/devg-koophone/kp-00_00013.md): JavaScript SDK提供的全量接口能力及调用须知详见SDK参考。本开发指导以及后续代码示例将分别面向初阶和中阶JavaScript开发者，提供最基础的以及相对功能完善、健全的H5开发示例。已经非常熟悉H5工程调用的开发者，可以直接基于包含全量功能介绍的SDK参考进行自定义H5工程的组合开发。准备工作准备H5网页端开发的环境和工具。 - [快速开始](https://support.huaweicloud.com/devg-koophone/kp-00_00014.md): 本章节以H5串流开发为例，提供一个简单开发示例帮助用户理解Html开发流程以及如何集成KooPhone JavaScript SDK，主要包含2两个基本功能，发起（云手机/云应用）连接与断开（云手机/云应用）连接。准备H5网页端开发的环境和工具。开发工具：WebStorm （推荐最新版本）NodeJs版本：>=18JavaScript版本 - [准备工作](https://support.huaweicloud.com/devg-koophone/kp-00_00016.md): 在基于JavaScript SDK开发串流页面之前，需要了解相关开发基础知识，准备JavaScript开发环境。熟悉Html，JavaScript开发语言基础。熟悉基本的H5开发知识。开发工具：WebStorm （推荐最新版本）NodeJs版本：>=18JavaScript版本：ES8及以上版本下载KooPhone JS SDK包 - [开发指导](https://support.huaweicloud.com/devg-koophone/kp-00_00017.md): 该开发场景主要面向普通云手机客户端开发者，旨在帮助开发者通过集成和调用KooPhone端SDK的部分基本功能，初步理解和实现一个面向云手机用户的功能完善的H5客户端。本章节所有开发示例均为展示基本功能的实现，仅供参考。绘制H5串流页面时，首先需要配置页面样式。主要分如下三类：配置基础样式。准备html、body基础样式，支持全屏播放。=110，低版本可能存在兼容性问题。事件监听：串流结束之后，使用player.off()清理监听事件。实例销毁：串流结束之后，使用destroyMediaStream()销毁串流实例。 ## API参考 - [使用前必读](https://support.huaweicloud.com/api-koophone/kp_01_0001.md): 欢迎使用云手机服务（KooPhone），云手机服务依靠智慧引擎的调度能力、端云协同的高效云机交互和云OS的丰富应用，提供优成本、丰富应用生态和优致用户体验。您可以使用本文档提供的API对云手机服务进行相关操作。如视频设置、批量重置等。支持的全部操作请参见API概览。在调用云手机服务API之前，请确保已经充分了解云手机服务相关概念。详细信息 - [API概览](https://support.huaweicloud.com/api-koophone/kp_01_0002.md): 云手机服务接口的分类与说明如表1所示。 - [构造请求](https://support.huaweicloud.com/api-koophone/kp_01_0004.md): 本节介绍REST API请求的组成，并以调用IAM服务的管理员创建IAM用户接口说明如何调用API。您还可以通过这个视频教程了解如何构造请求调用API：https://bbs.huaweicloud.com/videos/102987 。请求URI由如下部分组成。{URI-scheme} :// {Endpoint} / {resourc - [认证鉴权](https://support.huaweicloud.com/api-koophone/kp_01_0005.md): 调用接口有如下两种认证方式，您可以选择其中一种进行认证鉴权。Token认证：通过Token认证调用请求。AK/SK认证：通过AK (Access Key ID)/SK (Secret Access Key)加密调用请求。Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。使用Token前请确保Toke - [返回结果](https://support.huaweicloud.com/api-koophone/kp_01_0006.md): 请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。对于管理员创建IAM用户接口，如果调用后返回状态码为“201”，则表示请求成功。对应请求消息头，响应同样也有消息头，如“Content-type”。对于管理员创建IAM用户接口，返回 - [实例执行同步命令 - SyncCommand](https://support.huaweicloud.com/api-koophone/SyncCommand.md): 实例执行同步命令接口。调用此api的前提条件是租户需要先购买实例。可以通过调用该接口实现对自己的实例进行adb指令操作。该接口是同步操作接口，如果有耗时adb操作建议使用实例执行异步命令接口。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账 - [实例执行异步命令 - AsyncCommand](https://support.huaweicloud.com/api-koophone/AsyncCommand.md): 实例执行异步命令接口。调用此api的前提条件是租户需要先购买实例。可以通过调用该接口实现对自己的实例进行异步adb指令操作。调用完该接口后携带该接口返回的task_id去调用实例执行任务查询接口。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能 - [实例执行任务查询 - GetTask](https://support.huaweicloud.com/api-koophone/GetTask.md): 实例执行任务批量查询。调用此api的前提条件是租户需要先购买实例。该接口需要和实例执行异步命令接口一起使用，使用实例执行异步命令接口返回的task_id作为路径上的参数以此获取异步命令执行的结果。同时，该接口也可以和实例安装app接口一起使用，使用实例安装app接口返回的task_id作为路径上的参数，以此获取实例安装app的执行结果。实 - [实例视频设置 - SetVideoConfig](https://support.huaweicloud.com/api-koophone/SetVideoConfig.md): 实例视频设置。调用此api的前提条件是租户需要先购买实例。使用该接口可以设置实例每一个清晰度对应的码率和出流的帧率。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IA - [实例状态批量查询 - BatchQueryStatus](https://support.huaweicloud.com/api-koophone/BatchQueryStatus.md): 实例状态批量查询。调用此api的前提条件是租户需要先购买实例。接口返回实例当前的状态。云机状态，0：未知，1：已停止，2：运行中，3：下线中，4：启动中，5：已关机。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限 - [实例批量重置 - BatchReset](https://support.huaweicloud.com/api-koophone/BatchReset.md): 实例批量重置。调用此api的前提条件是租户需要先购买实例。调用该接口后，当前实例会被初始化。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所 - [租户实例串流前获取设备的device_token - GetDeviceToken](https://support.huaweicloud.com/api-koophone/GetDeviceToken.md): 租户实例串流前获取设备的device_token。调用此api的前提条件是租户需要先购买实例。调用该接口获取云机实例的device_token后作为鉴权信息，并携带云机实例的device_id去调用返参中的信令地址（signaling_url）。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自 - [实例分配 - AssignInstance](https://support.huaweicloud.com/api-koophone/AssignInstance.md): 调用此api的前提条件是租户需要先购买实例。将云机分配给租户指定的用户，需要指定用户userId。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用A - [实例取消分配 - UnassignInstance](https://support.huaweicloud.com/api-koophone/UnassignInstance.md): 调用此api的前提条件是租户需要先购买实例。将云机取消分配给租户指定的用户，调用后会清除用户云机使用数据。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具 - [实例批量查询 - ListInstances](https://support.huaweicloud.com/api-koophone/ListInstances.md): 实例批量查询。调用此api的前提条件是租户需要先购买实例。接口返回租户下所有实例信息。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权 - [应用列表查询 - ListInstanceApp](https://support.huaweicloud.com/api-koophone/ListInstanceApp.md): 实例安装应用列表查询。调用此api的前提条件是租户需要先购买实例。接口返回租户实例中安装的应用列表信息。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备 - [实例重启 - BatchRebootInstance](https://support.huaweicloud.com/api-koophone/BatchRebootInstance.md): 调用此接口可以批量重启云机实例。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参见权限和授 - [可售实例sku批量查询 - BatchShowSku](https://support.huaweicloud.com/api-koophone/BatchShowSku.md): 实例sku批量查询。接口返回租户下所有可售实例的规格信息。根据query参数去查询具体的商品的sku信息。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具 - [实例开通接口 - CreateInstance](https://support.huaweicloud.com/api-koophone/CreateInstance.md): 租户可以通过调用该接口生成实例。该接口需要结合BatchShowSku接口一起使用，在BatchShowSku接口中获取全量的可售的sku。租户根据自己需要去选择相应规格进行订购。调用该接口时如果想要直接购买成功，请您先在账户上充值并在订购参数中选择isAutoPay为自动付费。如果没有选择自动付费，在调完接口后请拿对应的订单号去您账号的 - [实例删除 - DeleteInstance](https://support.huaweicloud.com/api-koophone/DeleteInstance.md): 调用此api的前提条件是租户需要先购买实例。租户可以调用该openapi退订已经订购的包周期实例，不可以退订按需的实例。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该 - [实例批量准备 - BatchPrepareInstances](https://support.huaweicloud.com/api-koophone/BatchPrepareInstances.md): 实例批量准备。调用此api的前提条件是租户需要先购买实例。调用该接口后，当前实例会被准备到可以串流的状态。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具 - [实例准备进度 - ShowProgress](https://support.huaweicloud.com/api-koophone/ShowProgress.md): 实例准备进度。调用此api的前提条件是需要先调用prepare接口。循环调用此接口直到云机状态为正常则可开启串流。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM - [实例备份 - BatchBackupInstances](https://support.huaweicloud.com/api-koophone/BatchBackupInstances.md): 实例数据批量备份到OBS，然后释放物理实例。调用此api的前提条件是实例数据已还原到物理机。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所 - [实例停止串流 - StopInstancesStreaming](https://support.huaweicloud.com/api-koophone/StopInstancesStreaming.md): 停止实例串流，若不在串流中的实例则无效果。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限要求请参 - [实例释放会话 - ReleaseInstancesSession](https://support.huaweicloud.com/api-koophone/ReleaseInstancesSession.md): 串流停止后会话还会存续一段时间，此接口可提供释放。您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。如果使用角色与策略授权，具体权限 - [实例安装app - InstallApp](https://support.huaweicloud.com/api-koophone/InstallApp.md): 调用此接口可以向云机实例批量安装app。调用此接口时，根据入参fast_install的取值，决定是普通安装还是快速安装。接口返回当前安装任务的task_id，此task_id有固定前缀“ZGCA”。用户根据返回的task_id，调用GetTask实例执行任务查询接口去查询执行结果。您可以在API Explorer中调试该接口，支持自动认 - [权限和授权项说明](https://support.huaweicloud.com/api-koophone/kp_01_0010.md): 如果您需要对您所拥有的KooPhone进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果华为云账号已经能满足您的要求，您可以跳过本章节，不影响您使用KooPhone服务的其它功能。通过IAM，您可以通过授权控制主体（IAM用户、用户组、IAM委托或信任委托）对华 - [策略授权参考](https://support.huaweicloud.com/api-koophone/kp_01_0011.md): 本章节介绍KooPhone策略授权场景下支持的策略授权项。策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下：权限：允许或拒绝某项操作。对应API接口：自定义策略实际调用的API接口。授权项：自定义策略中支持 - [身份策略授权参考](https://support.huaweicloud.com/api-koophone/Permission.md): 云服务在IAM预置了常用的权限，称为系统身份策略。如果IAM系统身份策略无法满足授权要求，管理员可以根据各服务支持的授权项，创建IAM自定义身份策略来进行精细的访问控制，IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外，Organizations服务中的服务控制策略（Service Control Policy，以下简称S - [状态码](https://support.huaweicloud.com/api-koophone/kp_01_0014.md): 常用状态码请参见表1。 - [错误码](https://support.huaweicloud.com/api-koophone/ErrorCode.md): 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 - [Detais错误码](https://support.huaweicloud.com/api-koophone/kp_01_0017.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [获取项目ID](https://support.huaweicloud.com/api-koophone/kp_01_0016.md): 在调用接口的时候，部分URL中需要填入项目ID，所以需要获取到项目ID。项目ID获取步骤如下：在API凭证页面的项目列表中查看项目ID。 ## SDK参考 - [KooPhone端侧SDK概述](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0001.md): KooPhone端侧SDK是为开发者提供的云手机能力集成工具包，包含Android原生SDK（AAR）和H5 Web SDK（JS）两种形式，使开发者能够快速在移动应用或Web应用中接入云手机的核心功能。通过标准化接口，开发者可轻松实现云手机连接、音视频控制、指令交互等全场景能力。多平台支持Android SDK：以AAR包形式提供，适用 - [KooPhone端侧SDK功能矩阵](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0002.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [初始化SDK](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0006.md): void init(Context appContext, Callback callback, boolean logger，CertInfo[] certs)初始化云手机SDK，在启动进程时调用。无注意事项：该方法需要在应用启动时调用。只需要调用一次，多次调用会被忽略。建议在Application类的onCreate()方法中调用。 - [启动云手机串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0007.md): boolean start(PlayerFragment fragment, final Bundle bundle)启动云手机串流。该方法用于启动云手机的串流功能，将云机画面和音频传输到本地设备。以下参数可通过Bundle对象在启动云手机串流时进行自定义配置：基础连接参数（必填）参数键类型说明LAUNCH_KEY_ADDRESSStri - [停止云手机串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0008.md): void stop()停止云手机串流，退出云机。该方法用于结束当前的云机串流会话，释放相关资源。无无 - [重新发起串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0009.md): boolean reconnect()重新连接云机。该方法用于在串流中断后重新连接云机，恢复串流功能。无无 - [切换流类型](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0010.md): void switchStreamType(CloudPhoneConst.CLOUD_APP_SWITCH_STREAM_TYPE type)切换流类型。该方法用于在云机上切换流类型。无 - [设置日志文件夹路径](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0012.md): void setLogFolder(String path)设置日志文件夹路径。该方法用于指定SDK日志的存储路径，便于日志管理和问题排查。无 - [注册基础回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0014.md): void setPlayerCallback(Callback callback)注册基础回调接口。该方法用于注册实现了基础回调方法的接口实例。更多回调接口使用详见回调及监听模块。无 - [取消注册基础回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0015.md): void UnsetPlayerCallback(Callback callback)取消注册基础回调接口。该方法用于取消注册已注册的基础回调接口实例。 更多回调接口使用详见回调及监听模块。无 - [配置剪贴板功能](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0018.md): void enableClipBoard(boolean enableClipBoard)启用或禁用剪贴板功能。该方法用于控制云机上的剪贴板功能。无无 - [获取SDK版本号](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0020.md): String version()获取当前SDK版本号。该方法用于获取SDK的版本信息，便于调试和版本管理。无String：版本信息。 - [检查云机是否在串流状态](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0022.md): boolean isPlaying()检查云机是否在串流状态。该方法用于判断当前云机是否正在串流，便于开发者进行状态管理。无boolean：是否正在串流。 - [设置云机横竖屏方向](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0025.md): void setDirection(Boolean direction)强制设置云机的横竖屏方向。该方法用于在特定场景下锁定云机的屏幕方向，例如游戏或视频播放时。无 - [动态设置云机画面比例](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0026.md): void setCloudScreenAspect(int screenWidth, int screenHeight)动态设置云机的画面比例（自定义尺寸）。该方法允许开发者根据实际需求设置云机的分辨率，以适配特定场景。无 - [调整云手机亮度](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0027.md): void changeBrightness(Double brightness)向云机发送亮度变化指令。该方法用于调整云机屏幕的亮度，以适应不同环境下的显示需求。无 - [设置质量偏好](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0029.md): void setQualityPreference(int level)设置云手机的质量偏好。该方法用于在画质和性能之间进行权衡，适用于不同网络环境下的自适应调整。无无 - [设置画质](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0172.md): void setProfile(int level)设置云手机的画质。boolean，设置成功返回true，设置失败返回false无 - [视频配置查询接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0174.md): void getProfileList()获取视频质量配置列表（结果通过onProfileList接口回调）。无无 - [设置静音状态](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0033.md): void mute(boolean mute)设置云机的静音状态。该方法用于在需要时静音云机的音频输出，例如在会议或视频播放时。无 - [设置云机音量](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0034.md): void changeVolume(MediaVolume volume)向云机发送音量变化指令。该方法用于远程调整云机的音量，适用于需要远程控制的场景。无 - [通知云机音频焦点状态变化](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0035.md): void deviceAudioFocusChange(String state)通知云机音频焦点状态变化。该方法用于在设备音频焦点变化时通知云机，以调整音频播放行为。无 - [设置播放器当前音频流的音量大小](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0173.md): void setAudioTrackVolume(float volume)该方法用于调整端侧播放器音量。无 - [启动音频焦点监听](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0038.md): void startAudioFocusChangeListener()启动音频焦点监听。该方法用于监听设备音频焦点的变化，以便及时调整云机的音频播放行为。无无 - [启用/禁用音频保持](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0039.md): void enableAudioKeeping(boolean isKeep)启用或禁用音频保持功能。该方法用于在云机断开连接时保持音频播放，适用于需要连续播放的场景。无 - [获取磁盘使用情况](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0043.md): void getDiskUsage()获取云机磁盘使用情况。该方法用于查询云机的磁盘使用情况。无无AppOperateResponse结构字段类型说明error_codeString状态码，0表示成功error_msgString错误详情dataDiskUsageInfo磁盘使用数据对象DiskUsageInfo结构字段类型计算关系说明t - [获取媒体元数据](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0044.md): void getMediaMetaData()获取云机媒体元数据。该方法用于查询云机的媒体元数据信息。无无MediaMetaData对象，包含以下字段： - [获取播放状态](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0045.md): void getPlayBackState()获取云机播放状态。该方法用于查询云机的播放状态。无无MediaPlayState对象，包含以下字段：成功获取媒体播放状态时，参数中的response.getData()内容如下： - [切换夜间模式](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0046.md): void nightModeChange(NightModeStateEnum nightModeChangeState)通知云机切换夜间模式。该方法用于在云机上启用或禁用夜间模式。无 - [恢复音乐播放](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0047.md): void resumeMusic()恢复云机上的音乐播放。该方法用于在云机上恢复音乐播放。无无 - [暂停音乐播放](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0048.md): void pauseMusic()暂停云机上的音乐播放。该方法用于在云机上暂停音乐播放。无无 - [获取云机上已安装的应用列表](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0050.md): void getInstalledApps(GetAppsReq getAppsReq)获取云机上已安装的应用列表。该方法用于查询云机上已安装的应用程序。getAppsReq结构无回调接口通过CloudPhoneClient.setAppCallback(CloudPhoneClient.Callback.AppCallback call - [获取云机上正在运行的应用列表](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0051.md): void getRunningApps(GetAppsReq getAppsReq)获取云机上正在运行的应用列表。该方法用于查询当前在云机上运行的应用程序。getAppsReq结构字段名类型必填说明appTypeAppTypeEnum是应用类型枚举：SYSTEM_APP：系统应用THIRD_APP：第三方应用BOTH：全部qualityI - [启动应用](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0052.md): String startApp(String packageName)启动指定包名的应用。该方法用于在云机上启动指定的应用程序。String：本次startApp指令的请求id。AppOperateResponse结构： - [关闭应用](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0054.md): String closeApp(String packageName)关闭指定包名的应用。该方法用于在云机上关闭指定的应用程序。String：本次closeApp指令的请求id、生成规则时间戳加递增序列。示例：1768987825628_2。AppOperateResponse结构：字段类型说明error_codeString操作结果代码 - [卸载应用](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0056.md): void uninstallApp(String packageName)卸载指定包名的应用。该方法用于在云机上卸载指定的应用程序。无AppOperateResponse结构：字段类型说明error_codeString操作结果代码，0表示成功，其他见错误码说明error_msgString可读性状态描述，成功返回successdataS - [加载应用](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0057.md): void loadApp(String packageName)加载指定包名的应用。该方法用于在云机上加载指定的应用程序。无 - [发送自定义消息到云端App](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0059.md): void sendExtMessageToCloud(String message)向所有云机广播消息。该方法用于向云端App发送自定义消息，消息内容以JSON格式传递。无 - [发送按键事件](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0060.md): void sendKeyEvent(int keyCode, int action)向云机发送按键事件。该方法用于向云机发送指定动作的按键事件。无 - [发送手柄摇杆事件](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0061.md): void sendJoyStickEvent(MotionEvent event)向云机发送手柄摇杆事件。该方法用于在云机上模拟手柄摇杆操作。无 - [发送文件](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0062.md): void sendFile(boolean isAsync, String srcLocalFile, String dstRemoteFile, String jobId, String customMsg)发送文件到云机。该方法用于将本地文件发送到云机。无无 - [启动流成功回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0065.md): void onSuccess()启动流成功回调。该方法在云手机连接成功后触发。无无见回调注册使用建议及示例 - [第一帧画面回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0066.md): void onFirstFrame()第一帧画面回调。该方法在云机画面首次渲染完成时触发。无无 - [会话结束回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0067.md): void onTerminated()会话结束回调。该方法在云手机会话结束时触发，可认为是最后一次回调。无无见回调注册使用建议及示例 - [流异常回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0068.md): void onFailure(int code, String message)流异常回调。该方法在云手机连接或运行过程中出现异常时触发。无见回调注册使用建议及示例 - [扩展消息回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0069.md): void onExtMessageReceived(Activity act, String message)扩展消息回调。该方法在收到扩展消息时触发。无无 - [弱网络回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0070.md): void onWeakNetwork()弱网络回调。该方法在检测到网络质量变差时触发。无无无 - [视频配置回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0175.md): void onProfileList(ProfileList profileList)视频配置回调。该方法在主动调用getProfileList()时触发，回调当前的视频画质配置和支持的视频画质配置列表。ProfileList结构参数名类型说明profileLevelint当前的视频配置级别profilesList appOperateResponse)应用启动回调。该方法在应用启动操作完成时触发。无 - [应用关闭回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0074.md): void onCloseApp(AppOperateResponse appOperateResponse)应用启动回调。该方法在应用关闭操作完成时触发。无 - [获取正在运行的应用回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0075.md): void onGetRunningApps(AppOperateResponse appOperateResponse)获取正在运行的应用回调。该方法在获取正在运行的应用信息完成时触发。无 - [应用卸载回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0077.md): void onUninstallApp(AppOperateResponse appOperateResponse)应用卸载回调。该方法在应用卸载操作完成时触发。无 - [应用加载回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0078.md): void onLoadApp(AppOperateResponse appOperateResponse)应用加载回调。该方法在应用加载操作完成时触发。无 - [获取已安装应用回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0079.md): void onGetInstalledApps(AppOperateResponse appOperateResponse)获取已安装应用回调。该方法在获取已安装应用信息完成时触发。无 - [APK安装状态回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0080.md): void onAPKInstallState(AppOperateResponse appOperateResponse)APK安装状态回调。该方法在APK安装状态更新时触发。AppInfo结构参数名类型说明appNameString应用名称，如“微信”、“设置”packageNameString应用包名（唯一标识），示 - [应用生命周期回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0081.md): void onAppLifeCycle(AppOperateResponse appOperateResponse)应用生命周期回调。该方法在应用生命周期状态更新时触发。AppLifeCycle无 - [获取媒体元数据回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0082.md): void onGetMediaMetadata(AppOperateResponse appOperateResponse)获取媒体元数据回调。该方法在获取媒体元数据完成时触发。无 - [获取播放状态回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0083.md): void onGetPlayBackState(AppOperateResponse appOperateResponse)获取播放状态回调。该方法在获取播放状态完成时触发。无 - [音频监控回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0084.md): void onMonitorAudio(AppOperateResponse appOperateResponse)音频监控回调。该方法在音频监控数据更新时触发。MediaMonitorData对象，包含以下字段：无当音频状态或元数据发生变化时，参数中的response.getData()内容如下： - [音频操作监控回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0085.md): void onMonitorAudioAction(AppOperateResponse appOperateResponse)音频操作监控回调。该方法在音频操作监控数据更新时触发。AudioActionData对象，包含以下字段：无当应用控制媒体切换下一首成功时，参数中的response.getData - [音乐恢复播放回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0086.md): void onResumeMusic(AppOperateResponse appOperateResponse)音乐恢复播放回调。该方法在音乐恢复播放操作完成时触发。无无 - [音乐暂停播放回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0087.md): void onPauseMusic(AppOperateResponse appOperateResponse)音乐暂停播放回调。该方法在音乐暂停播放操作完成时触发。无无 - [音量变化回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0088.md): void onChangeVolume(AppOperateResponse appOperateResponse)音量变化回调。该方法在音量变化操作完成时触发。无无 - [亮度变化回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0089.md): void onChangeBrightness(AppOperateResponse appOperateResponse)亮度变化回调。该方法在亮度变化操作完成时触发。无无 - [返回云桌面回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0091.md): void onReturnLauncher(AppOperateResponse appOperateResponse)用于处理端侧返回桌面（Launcher）后的回调结果，并根据返回原因决定：是否断流是否返回应用墙（MainActivity）是否保持当前云应用界面外层字段LauncherResul - [获取磁盘使用情况回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0092.md): void onGetDiskUsage(AppOperateResponse appOperateResponse)获取磁盘使用情况回调。该方法在获取磁盘使用情况完成时触发。无 - [云设备音频焦点变化回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0093.md): void onCloudDeviceAudioFocusChange(AppOperateResponse appOperateResponse)云设备音频焦点变化回调。该方法在云设备音频焦点状态变化时触发。AudioFocusStateResponse包含以下字段：无 - [音量控制回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0094.md): void onVolumeControl(AppOperateResponse appOperateResponse)音量控制回调。该方法在音量控制操作完成时触发。VolumeDTO包含以下字段：无 - [亮度控制回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0095.md): void onBrightnessControl(AppOperateResponse appOperateResponse)亮度控制回调。该方法在亮度控制操作完成时触发。BrightnessDTO对象，包含以下字段：无 - [概述](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0097.md): Callback是云手机SDK的核心回调接口，所有事件通知都通过该接口的相应方法回调。开发者需要实现该接口来处理各种云手机事件。在CloudPhoneClient中，开发者可以通过回调注册和回调取消注册这两种方法注册和取消注册不同级别的回调接口，以便灵活地管理事件监听。 - [注册基础回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0099.md): void setPlayerCallback(Callback callback)注册基础回调接口。该方法用于注册实现了基础回调方法的接口实例。无 - [注册应用级回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0100.md): void setAppCallback(Callback.AppCallback callback)注册应用级回调接口。该方法用于注册实现了应用级回调方法的接口实例。无 - [注册操作系统级回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0101.md): void setSysCallback(Callback.SysCallBack callback)注册操作系统级回调接口。该方法用于注册实现了操作系统级回调方法的接口实例。无 - [取消注册基础回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0103.md): void UnsetPlayerCallback(Callback callback)取消注册基础回调接口。该方法用于取消注册已注册的基础回调接口实例。无 - [取消注册应用级回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0104.md): void UnsetAppCallback(Callback.AppCallback callback)取消注册应用级回调接口。该方法用于取消注册已注册的应用级回调接口实例。无 - [取消注册操作系统级回调接口](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0105.md): void UnsetSysCallback(Callback.SysCallBack callback)取消注册操作系统级回调接口。该方法用于取消注册已注册的操作系统级回调接口实例。无 - [回调注册使用建议及示例](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0106.md): 按需注册：开发者应根据实际需求注册对应的回调接口，避免不必要的资源占用。避免重复注册：确保同一个回调接口不会被多次注册，防止事件重复触发。及时取消注册：在不再需要监听事件时，及时取消注册回调接口，避免内存泄漏。线程安全：回调注册和取消注册操作应在主线程中执行，确保线程安全。模块化管理：建议将不同级别的回调接口分别管理，提高代码可维护性。注 - [错误码](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0171.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [状态码](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0109.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [网络错误码](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0110.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 - [错误处理](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0111.md): 错误回调处理：在onFailure回调中根据错误码进行相应处理。网络错误重试：对于网络相关错误（110000-110006），建议实现自动重连机制。用户提示：对于用户相关的错误（100008-100011），提供友好的用户提示。日志记录：记录错误码和错误信息，便于问题排查。异常恢复：对于可恢复的错误（如网络断线），实现自动恢复机制。错误处 - [调用Android SDK开放接口注意事项](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0112.md): 所有静态方法都是线程安全的，可以在多线程环境下调用。某些方法需要在start调用之前设置才生效（如setVideoDecoder）。回调方法在主线程中执行，避免耗时操作。文件操作相关方法需要确保文件路径存在且有权限。网络相关操作需要确保网络连接正常。 - [启动串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0116.md): player.initMediaStream(params)启动Streaming，调用此函数之后，后续通过回调函数通知启动结果。无 - [终止串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0117.md): player.closeMediaStream()主动关闭Streaming串流。调用后云机将直接退出串流，不会进入keeping状态等待重连。无无 - [恢复串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0118.md): player.resumeMediaStream()重新激活窗口并恢复Streaming传输。需在statechange回调状态为countdown（关闭倒计时）或keeping（重连等待）时调用。无boolean：仅表示流程是否触发成功（非最终结果），实际结果需通过statechange回调监听（状态变为playing表示成功）。 - [销毁串流player实例](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0119.md): player.destroyMediaStream()销毁CloudPhonePlayer实例，需在window.onbeforeunload()中调用。无无 - [设置回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0121.md): player.on(event, listener)设置回调事件的处理函数。回调函数必须在调用initMediaStream()方法前设置。无 - [取消回调](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0122.md): player.off(event, listener)移除回调事件的处理函数。无 - [配置定位功能](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0124.md): player.setGpsStatus(status)打开或者关闭GPS功能，默认status = disable表示关闭。无 - [获取SDK版本号](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0126.md): version()获取当前JSSDK版本号。该方法用于获取SDK的版本信息，便于调试和版本管理。无成功返回当前SDK版本。 - [检查浏览器是否支持串流](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0127.md): player.isBrowserSupport()检测浏览器是否支持Streaming功能。无支持返回true，不支持返回false。 - [设置云机画面分辨率](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0130.md): player.setCloudScreenAspect(screenHeight, screenWidth)设置云机屏幕分辨率比例。无 - [设置全屏播放](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0131.md): player.setMediaFullScreen()串流media全屏播放。无无 - [退出全屏播放](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0132.md): player.setMediaExitFullScreen()串流media退出全屏播放。无无 - [设置画中画模式](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0133.md): player.setPicInPicStatus(status)设置画中画模式，进入画中画模式或退出画中画模式。无 - [设置质量偏好](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0135.md): player.setVideoQuality(level)设置调整视频/画面质量。无 - [获取云机当前的profile配置列表](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0137.md): player.getProfileList()获取视频质量配置列表（结果通过onProfileList事件回调）。无无 - [获取媒体元素](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0138.md): player.getMediaElement()获取底层video媒体元素。无HTMLVideoElement：视频元素对象。 - [设置静音](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0141.md): player.setMuted(muted)设置串流player静音。无 - [设置云机音量](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0142.md): player.setCloudVolume(volume)设置云机的音量，注意这个音量将作用到云机设备，不是串流player的声音。无 - [设置串流播放器音量](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0143.md): player.setVolume(volume)设置串流Player音量。无 - [获取音量大小](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0145.md): player.getVolume()获取当前音量值。无float：当前音量值。 - [查询云机是否静音](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0146.md): player.isMuted()查询云机串流播放器是否静音。无静音状态返回true，非静音状态返回false。 - [发送手柄按键](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0149.md): sendKeyEvent(keyCode, action, keyType)发送手柄按键事件到云机。无 - [上传文件](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0150.md): player.sendFile(file, dirPath, fileType, localFilePath)文件上传功能。无 - [设置禁止传输的键盘按键事件](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0151.md): player.setDisableKeys(keysArray)设置禁止传输的键盘按键事件。无 - [发送虚拟按键](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0152.md): player.sendVirtualButtonEvent(key)发送虚拟按键到云机。发送成功返回true，发送失败返回false。 - [剪切板同步](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0153.md): player.paste(text)将文本发送至云机剪切板。无 - [发送摇杆轴事件](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0154.md): sendAxesEvent(action,x,y,z,rz,lt,rt,hx,hy)发送摇杆轴事件到云机。无 - [onClose](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0157.md): player播放结束或失败时触发。 - [onError](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0158.md): SDK内错误事件回调。 - [onBadNetwork](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0159.md): 网络不佳时触发。无 - [onStatistics](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0160.md): Streaming质量状态统计，周期性1秒回调一次。 - [onProfileChanged](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0161.md): profile变化时的回调通知。 - [onOrientation](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0162.md): 云机的横竖屏状态回调。 - [onStateChange](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0163.md): Streaming状态变化事件，用于监听播放器状态的改变。 - [onCloudVolumeChange](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0165.md): 云机音量/静音状态改变事件回调，串流成功或云机声音设置改变时回调。 - [onAppMessage](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0166.md): App通知消息，当App发送com.cloudphone.cloud.APP_MESSAGE广播时，将触发该回调。 - [onAutoplayFailed](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0167.md): 自动播放失败回调。无 - [监听事件介绍](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0168.md): JSSDK默认监听浏览器事件，以实现对用户键盘、鼠标、触摸等行为进行反馈。JSSDK目前默认监听如下鼠标事件：JSSDK目前默认监听如下键盘事件：JSSDK目前默认监听如下焦点事件：JSSDK目前默认监听如下触摸事件： - [错误码说明](https://support.huaweicloud.com/sdkreference-koophone/kp_10_0170.md): 华为云帮助中心，为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档，帮助您快速上手使用华为云服务。 ## 常见问题 - [什么是云手机服务？](https://support.huaweicloud.com/koophone_faq/kp_02_0002.md): 云手机服务（KooPhone）是华为云面向政企、互联网等客户推出的一款优体验、高安全的云手机服务。融合ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，并引入华为终端丰富的应用生态，为更多带屏联网设备提供云算力和云应用的能力。KooPhone充分发挥端云协同的优势，提供端云交互、麦克风和摄像头等各类传感器的模拟仿真，以及应用和数据 - [什么是区域和可用区？](https://support.huaweicloud.com/koophone_faq/kp_02_0003.md): 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供云手机服务的Region；专属R - [购买云手机后，需要多久可以开通成功？](https://support.huaweicloud.com/koophone_faq/kp_02_0004.md): 通常情况，购买完成后几分钟内就会开通成功。如果长时间没有开通成功，请联系客服寻求技术支持。 - [云手机在客户端和云端分别支持什么操作系统？](https://support.huaweicloud.com/koophone_faq/kp_02_0005.md): 云手机端侧提供接入客户端，云侧提供实例。客户端APP支持Android系统。客户端支持APP和H5两种形态，非iOS手机可以使用APP或H5，iOS手机支持H5。实例提供Android系统。 - [云手机可以打电话、发短信吗？](https://support.huaweicloud.com/koophone_faq/kp_02_0006.md): 当前支持云机调用真机的电话短信能力，可完成打电话和发短信的操作。云手机可以作为独立于实体手机之外的一部手机，进行玩游戏、看电影等操作。 - [什么是云手机服务？](https://support.huaweicloud.com/koophone_faq/kp_02_0002.md): 云手机服务（KooPhone）是华为云面向政企、互联网等客户推出的一款优体验、高安全的云手机服务。融合ARM服务器虚拟化、音视频编解码、实时传输能力等核心技术，并引入华为终端丰富的应用生态，为更多带屏联网设备提供云算力和云应用的能力。KooPhone充分发挥端云协同的优势，提供端云交互、麦克风和摄像头等各类传感器的模拟仿真，以及应用和数据 - [什么是区域和可用区？](https://support.huaweicloud.com/koophone_faq/kp_02_0003.md): 我们用区域和可用区来描述数据中心的位置，您可以在特定的区域、可用区创建资源。区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供云手机服务的Region；专属R - [购买云手机后，需要多久可以开通成功？](https://support.huaweicloud.com/koophone_faq/kp_02_0004.md): 通常情况，购买完成后几分钟内就会开通成功。如果长时间没有开通成功，请联系客服寻求技术支持。 - [云手机在客户端和云端分别支持什么操作系统？](https://support.huaweicloud.com/koophone_faq/kp_02_0005.md): 云手机端侧提供接入客户端，云侧提供实例。客户端APP支持Android系统。客户端支持APP和H5两种形态，非iOS手机可以使用APP或H5，iOS手机支持H5。实例提供Android系统。 - [云手机可以打电话、发短信吗？](https://support.huaweicloud.com/koophone_faq/kp_02_0006.md): 当前支持云机调用真机的电话短信能力，可完成打电话和发短信的操作。云手机可以作为独立于实体手机之外的一部手机，进行玩游戏、看电影等操作。 - [如何批量购买云手机？](https://support.huaweicloud.com/koophone_faq/kp_02_0009.md): 购买云手机的节点版：包年/包月的计费模式：管理员登录云手机服务控制台，在节点版的总览页单击“立即购买”，选择区域、节点规格、实例规格、节点组、购买时长和购买数量等，确认配置后根据页面提示完成支付。详细操作请参见购买云手机（节点版）。包年/包月的计费模式：管理员登录云手机服务控制台，在节点版的总览页单击“立即购买”，选择区域、节点规格、实例 - [如何支付云手机费用？](https://support.huaweicloud.com/koophone_faq/kp_02_0010.md): 用户使用前可通过在线支付、转账汇款等支付方式完成华为云账号充值。详细操作请参见账户充值。包年/包月的计费模式为预付费，按照订单的购买周期结算。按需计费为后付费，按照云手机的实际使用时长计费。 - [云手机计费模式是什么？](https://support.huaweicloud.com/koophone_faq/kp_02_0011.md): 云手机服务的节点版提供了包年/包月的计费模式，实例版提供包年/包月、按需计费两种计费模式，供您灵活选择。按包年/包月计费：提供包年/包月的购买模式，先付费再使用。按需计费：即开即停，支持秒级计费。 - [包年/包月和按需计费模式有什么区别？](https://support.huaweicloud.com/koophone_faq/kp_02_0016.md): 包年/包月的计费模式是一种预付费方式，按订单的购买周期计费，适用于可预估云手机使用周期的场景，价格比按需计费模式更优惠。包年/包月计费模式的云手机使用说明：“包年/包月”的云手机购买后不能删除，如需停止使用，请执行退订操作。节点版：在云手机的节点版页面，选择“资源管理 > 节点组”进入节点组页面，单击页面的“续费/退订”，跳转至费用中心进 - [充值和续费的区别？](https://support.huaweicloud.com/koophone_faq/kp_02_0012.md): 充值：客户通过在线支付、转账汇款等支付方式向华为云账户增加金额的过程。续费：客户通过在线支付、转账汇款等支付方式延长已购买产品的使用权限。 - [如何批量购买云手机？](https://support.huaweicloud.com/koophone_faq/kp_02_0009.md): 购买云手机的节点版：包年/包月的计费模式：管理员登录云手机服务控制台，在节点版的总览页单击“立即购买”，选择区域、节点规格、实例规格、节点组、购买时长和购买数量等，确认配置后根据页面提示完成支付。详细操作请参见购买云手机（节点版）。包年/包月的计费模式：管理员登录云手机服务控制台，在节点版的总览页单击“立即购买”，选择区域、节点规格、实例 - [如何支付云手机费用？](https://support.huaweicloud.com/koophone_faq/kp_02_0010.md): 用户使用前可通过在线支付、转账汇款等支付方式完成华为云账号充值。详细操作请参见账户充值。包年/包月的计费模式为预付费，按照订单的购买周期结算。按需计费为后付费，按照云手机的实际使用时长计费。 - [云手机计费模式是什么？](https://support.huaweicloud.com/koophone_faq/kp_02_0011.md): 云手机服务的节点版提供了包年/包月的计费模式，实例版提供包年/包月、按需计费两种计费模式，供您灵活选择。按包年/包月计费：提供包年/包月的购买模式，先付费再使用。按需计费：即开即停，支持秒级计费。 - [包年/包月和按需计费模式有什么区别？](https://support.huaweicloud.com/koophone_faq/kp_02_0016.md): 包年/包月的计费模式是一种预付费方式，按订单的购买周期计费，适用于可预估云手机使用周期的场景，价格比按需计费模式更优惠。包年/包月计费模式的云手机使用说明：“包年/包月”的云手机购买后不能删除，如需停止使用，请执行退订操作。节点版：在云手机的节点版页面，选择“资源管理 > 节点组”进入节点组页面，单击页面的“续费/退订”，跳转至费用中心进 - [充值和续费的区别？](https://support.huaweicloud.com/koophone_faq/kp_02_0012.md): 充值：客户通过在线支付、转账汇款等支付方式向华为云账户增加金额的过程。续费：客户通过在线支付、转账汇款等支付方式延长已购买产品的使用权限。 - [云手机支持音视频通话吗？](https://support.huaweicloud.com/koophone_faq/kp_02_0027.md): 云手机可以安装实时通讯软件，安装完成后支持通过软件进行音视频通话。云手机可以作为独立于实体手机之外的一部手机，进行玩游戏、看电影等操作。 - [如何在云机上安装应用？](https://support.huaweicloud.com/koophone_faq/kp_02_0020.md): 购买的云手机为节点版时，云机支持以下方式上传并安装应用：如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。在左侧导航栏选择“应用库”，单击“创建应用”。选择应用类别，上传APK文件后输入应用描述等，单击“确定”。在左侧导航栏选择“镜像中心 > 自定义镜像”，单击“创建镜像”。输入镜像名称并选择基础镜像，配置完成后单击“下一步 - [云手机支持音视频通话吗？](https://support.huaweicloud.com/koophone_faq/kp_02_0027.md): 云手机可以安装实时通讯软件，安装完成后支持通过软件进行音视频通话。云手机可以作为独立于实体手机之外的一部手机，进行玩游戏、看电影等操作。 - [如何在云机上安装应用？](https://support.huaweicloud.com/koophone_faq/kp_02_0020.md): 购买的云手机为节点版时，云机支持以下方式上传并安装应用：如果当前版本为实例版，请单击“切换至节点版”以切换到节点版页面。在左侧导航栏选择“应用库”，单击“创建应用”。选择应用类别，上传APK文件后输入应用描述等，单击“确定”。在左侧导航栏选择“镜像中心 > 自定义镜像”，单击“创建镜像”。输入镜像名称并选择基础镜像，配置完成后单击“下一步 - [APP应用在Pad/车机中是如何自适应的？](https://support.huaweicloud.com/koophone_faq/kp_02_0014.md): APP应用支持全屏或2/3屏显示，并可进行横屏或竖屏切换。安装的APP展示逻辑不同，手机和Pad/车机屏幕中APP展示的效果不同。APP主要有三种展示逻辑：APP强制竖屏、APP自适应、APP强制横屏。APP强制竖屏手机场景（屏幕宽度<600bp）：手机竖屏或横屏时，手机内安装的APP均竖屏（全屏）展示，如图1中1和2所示。Pad/车机场 - [APP应用在Pad/车机中是如何自适应的？](https://support.huaweicloud.com/koophone_faq/kp_02_0014.md): APP应用支持全屏或2/3屏显示，并可进行横屏或竖屏切换。安装的APP展示逻辑不同，手机和Pad/车机屏幕中APP展示的效果不同。APP主要有三种展示逻辑：APP强制竖屏、APP自适应、APP强制横屏。APP强制竖屏手机场景（屏幕宽度<600bp）：手机竖屏或横屏时，手机内安装的APP均竖屏（全屏）展示，如图1中1和2所示。Pad/车机场