入门

基础入门

开发

应用开发准备

应用框架

EmbeddedUIExtensionAbility

使用AppServiceExtensionAbility组件实现后台服务

常见action与entities（不推荐使用）

（可选）使用canOpenLink判断应用是否可访问

获取目标应用的URL信息

使用Deep Linking实现应用间跳转

拉起导航类应用（startAbilityByType）

拉起邮件类应用（startAbilityByType）

拉起邮件类应用（mailto方式）

拉起金融类应用（startAbilityByType）

拉起航班类应用（startAbilityByType）

拉起快递类应用（startAbilityByType）

拉起图片编辑类应用（startAbilityByType）

拉起文件处理类应用（startAbility）

基于ArkTS脚本的应用Skill开发指导

端侧A2A框架开发指导

端侧A2A框架概述

开发端侧智能体

使用AgentExtensionAbility组件实现智能体服务

AgentExtensionAbility配置文件说明

基于ModularObjectExtensionAbility的模块化对象开发指导 (C/C++)

模块化对象模型概述 (C/C++)

使用ModularObjectExtensionAbility实现模块化对象 (C/C++)

使用Taihe实现ModularObjectExtensionAbility的IPC通信 (C/C++)

使用ModularObjectDispatcher实现动态接口调用 (C/C++)

Ability Kit术语

Accessibility Kit（无障碍服务）

通过用户首选项实现数据持久化 (ArkTS)

通过用户首选项实现数据持久化 (C/C++)

通过键值型数据库实现数据持久化 (ArkTS)

通过关系型数据库实现数据持久化 (ArkTS)

通过关系型数据库实现数据持久化 (C/C++)

通过向量数据库实现数据持久化 (ArkTS)

通过向量数据库实现数据持久化 (C/C++)

同应用跨设备数据同步（分布式）

同应用跨设备数据同步概述

键值型数据库跨设备数据同步 (ArkTS)

关系型数据库跨设备数据同步 (ArkTS)

分布式数据对象跨设备数据同步 (ArkTS)

同应用端云数据同步（分布式）

同应用端云数据同步概述

端云数据同步云侧环境部署指导

端云数据同步关系型数据库端侧开发指导 (ArkTS)

基于设备分类和数据分级的访问控制 (ArkTS)

基于设备分类和数据分级的访问控制 (C/C++)

通过标准化数据通路实现数据共享 (ArkTS)

通过标准化数据通路实现数据共享 (C/C++)

应用数据向量化 (ArkTS)

arkdata数据库调试工具

preferences数据库调试工具指导

vector-store数据库调试工具指导

异步并发 (Promise和async/await)

Transferable对象 (NativeBinding对象)

CPU密集型任务开发指导 (TaskPool和Worker)

I/O密集型任务开发指导 (TaskPool)

同步任务开发指导 (TaskPool和Worker)

自定义Native Transferable对象的多线程操作场景

自定义Native Sendable对象的多线程操作场景

Worker常驻线程通过TaskPool进行多任务并发处理

在build-profile.json5中配置arkOptions

@ReusableV2装饰器：V2组件复用

@LocalBuilder装饰器：维持组件关系

@BuilderParam装饰器：引用@Builder函数

wrapBuilder：封装全局@Builder

mutableBuilder：实现全局@Builder动态更新

@Styles装饰器：定义组件重用样式

@Extend装饰器：定义扩展组件样式

stateStyles：多态样式

@AnimatableExtend装饰器：定义可动画属性

@Provide装饰器和@Consume装饰器：与后代组件双向同步

@Observed装饰器和@ObjectLink装饰器：嵌套类对象属性变化

@Watch装饰器：状态变量更改通知

管理数据对象的状态

@Track装饰器：class对象属性级更新

管理应用拥有的状态

管理应用拥有的状态概述

LocalStorage：页面级UI状态存储

AppStorage：应用全局的UI状态存储

PersistentStorage：持久化存储UI状态

@Provider装饰器和@Consumer装饰器：跨组件层级双向同步

管理数据对象的状态

@ObservedV2装饰器和@Trace装饰器：类属性变化观测

@Monitor装饰器：状态变量修改异步监听

@SyncMonitor装饰器：状态变量修改同步监听

@Computed装饰器：计算属性

@Type装饰器：标记类属性的类型

管理应用拥有的状态

AppStorageV2: 应用全局UI状态存储

PersistenceV2: 持久化存储UI状态

辅助接口

getTarget接口：获取状态管理框架代理前的原始对象

makeObserved接口：将非观察数据变为可观察数据

canBeObserved接口：判断对象是否可被观察

addMonitor/clearMonitor接口：动态添加/取消监听

applySync/flushUpdates/flushUIUpdates接口：同步刷新

状态管理V1和V2混用指导（API version 19前）

状态管理V1和V2混用指导（API version 19及之后）

状态变量改变不触发组件刷新问题常用定位方法

组件导航(Navigation) (推荐)

页面路由 (@ohos.router)(不推荐)

相对布局 (RelativeContainer)

栅格布局 (GridRow/GridCol)

动态布局 (DynamicLayout)

容器断点 (ContainerReader)

弧形列表 (ArcList)（圆形屏幕推荐使用）

创建懒加载布局 (LazyColumnLayout/LazyVGridLayout/LazyVWaterFlowLayout)

创建懒加载自定义布局 (LazyDynamicLayout)

文本输入 (TextInput/TextArea/Search)

富文本编辑（RichEditor）

图标小符号 (SymbolGlyph/SymbolSpan)

属性字符串 (StyledString/MutableStyledString)

创建弧形轮播 (ArcSwiper)（圆形屏幕推荐使用）

基于colorFilter实现图片滤镜效果

弧形按钮 (ArcButton)(圆形屏幕推荐使用)

不依赖UI组件的全局自定义弹出框 (openCustomDialog)

基础自定义弹出框 (CustomDialog)

不依赖UI组件的全局菜单 (openMenu)

气泡提示

气泡提示概述

气泡提示（Popup）

不依赖UI组件的全局气泡提示 (openPopup)

绑定模态页面

绑定模态页面概述

绑定半模态页面（bindSheet）

绑定全模态页面（bindContentCover）

自定义声明式节点 (BuilderNode)

自定义绘制修改器 (DrawModifier)

Modifier机制

自定义扩展能力概述

内容修改器 (ContentModifier)

属性修改器 (AttributeModifier)

属性更新器 (AttributeUpdater)

使用UI上下文接口操作界面（UIContext）

使用组件截图（ComponentSnapshot）

长截图

感知组件可见性

检查页面布局

媒体查询 (@ohos.mediaquery)

嵌入式组件

全屏启动元服务 (FullScreenLaunchComponent)

同应用进程嵌入式组件 (EmbeddedComponent)

通过EmbeddedComponent拉起EmbeddedUIExtensionAbility

UI开发 (兼容JS的类Web开发范式)概述

CanvasRenderingContext2D对象

Path2D对象

OffscreenCanvasRenderingContext2D对象

background-position样式动画

使用XComponent实现画中画功能开发 (ArkTS)

使用typeNode实现画中画功能开发 (ArkTS)

使用NDK接口实现画中画功能开发 (C/C++)

使用WindowManager管理多模输入事件 (C/C++)

使用OH_DisplayManager实现屏幕基础信息查询和状态监听 (C/C++)

使用Display实现屏幕属性查询及状态监听 (ArkTS)

优化跳转至新Web组件过程中的页面闪烁现象

建立应用侧与前端页面数据通道(C/C++)

使用Web组件与系统剪贴板交互处理网页内容

使用WebNativeMessagingExtensionAbility组件实现浏览器扩展和应用通信场景

Web调试维测

使用DevTools工具调试前端页面

使用Crashpad收集Web组件崩溃信息

定位与解决Web白屏问题

使用Hypium实现ArkWeb自动化测试

定位网页加载问题

ArkWeb术语

Background Tasks Kit（后台任务开发服务）

Background Tasks Kit简介

Background Tasks Kit接入规范

Background Tasks Kit术语

Content Embed Kit（内容嵌入服务）

Content Embed Kit常见问题

Content Embed Kit术语

Core File Kit（文件基础服务）

Data Augmentation Kit（数据增强服务）

Data Augmentation Kit简介

Data Augmentation Kit术语

卡片拉起应用UIAbility到后台（call事件）

卡片传递消息给应用（message事件）

通过router或call事件刷新卡片内容

在自绘编辑框中使用输入法开发指导 (C/C++)

Localization Kit（本地化开发服务）

UI Design Kit（UI设计套件）

怎么获取layeredDrawableDescriptor对象信息？

系统

Asset Store Kit（关键资产存储服务）

Asset Store Kit开发指导(ArkTS)

Asset Store Kit开发指导(C/C++)

Confidential Space Kit（机密空间服务）

Confidential Space Kit简介

运行数据应用处理数据

Confidential Space Kit术语

Crypto Architecture Kit（加解密算法框架服务）

Crypto Architecture Kit简介

指定二进制数据转换非对称密钥对(ArkTS)

指定二进制数据转换非对称密钥对(C/C++)

指定密钥参数生成非对称密钥对(ArkTS)

指定密钥参数生成非对称密钥对(C/C++)

使用ECC压缩/非压缩公钥格式转换(ArkTS)

使用ECC压缩/非压缩公钥格式转换(C/C++)

使用ECC压缩/非压缩点格式转换(ArkTS)

使用ECC压缩/非压缩点格式转换(C/C++)

指定PEM格式字符串数据转换非对称密钥对(ArkTS)

指定PEM格式字符串数据转换非对称密钥对(C/C++)

使用ChaCha20对称密钥加解密(ArkTS)

使用ChaCha20对称密钥加解密(C/C++)

使用AES-WRAP算法对对称密钥加解密(ArkTS)

使用AES-WRAP算法对对称密钥加解密(C/C++)

使用SM2密文格式转换(ArkTS)

使用SM2密文格式转换(C/C++)

使用RC2对称密钥（CBC模式）加解密(ArkTS)

使用ECDSA密钥对签名验签(ArkTS)

使用ECDSA密钥对签名验签(C/C++)

使用ML-DSA密钥对签名验签(ArkTS)

密钥协商

使用ECDH进行密钥协商(ArkTS)

使用ECDH进行密钥协商(C/C++)

使用X25519进行密钥协商(ArkTS)

使用X25519进行密钥协商(C/C++)

使用DH进行密钥协商(ArkTS)

使用DH进行密钥协商(C/C++)

密钥封装解封装

使用KEM进行密钥封装解封装(ArkTS)

使用PBKDF2进行密钥派生(ArkTS)

使用PBKDF2进行密钥派生(C/C++)

使用HKDF进行密钥派生(ArkTS)

使用HKDF进行密钥派生(C/C++)

使用SCRYPT进行密钥派生(ArkTS)

使用SCRYPT进行密钥派生(C/C++)

使用X963KDF进行密钥派生(ArkTS)

使用X963KDF进行密钥派生(C/C++)

实现跨平台加解密数据兼容性

Crypto Architecture Kit术语

Data Protection Kit（数据保护服务）

Data Protection Kit术语

Device Certificate Kit（设备证书服务）

Device Certificate Kit简介

证书链校验时从PKCS #12文件构造TrustAnchor对象数组

证书链校验器对象的创建和校验

证书集合及证书吊销列表集合对象的创建和获取

Device Certificate Kit术语

Device Security Kit（设备安全服务）

Device Security Kit简介

Enterprise Data Guard Kit（企业数据保护服务）

Enterprise Data Guard Kit简介

订阅或取消订阅KIA文件拷贝、重命名和压缩事件

Enterprise Data Guard Kit常见问题

Enterprise Data Guard Kit权限获取失败

Enterprise Data Guard Kit术语

Enterprise Threat Protection Kit（企业威胁防护服务）

Enterprise Threat Protection Kit简介

Enterprise Threat Protection Kit常见问题

Enterprise Threat Protection Kit术语

Online Authentication Kit（在线认证服务）

Online Authentication Kit简介

Online Authentication Kit术语

Online Authentication Kit常见问题

IFAA常见问题

个人数据处理说明

网站链接免责声明

Universal Keystore Kit（密钥管理服务）

Universal Keystore Kit简介

清除UKey PIN码认证状态(ArkTS)

驱动HAP ExtensionAbility适配指导

CryptoExtensionAbility扩展能力介绍

CryptoExtensionAbility适配开发指导

个人数据处理说明

Universal Keystore Kit术语

User Authentication Kit（用户认证服务）

User Authentication Kit简介

User Authentication Kit常见问题

指纹登录怎么检测设备指纹是否发生变化

如何感知指纹登录中间认证失败结果

User Authentication Kit术语

网络

Accessory Kit（配件接入服务）

Accessory Kit简介

配件接入

Accessory Kit常见问题

API使用过程中流程执行异常，无法完成预期操作

Accessory Kit术语

Connectivity Kit（短距通信服务）

可选属性显式设置为undefined报401无效参数

伙伴设备与HarmonyOS设备互通的开发指南

Distributed Service Kit（分布式管理服务）

Distributed Service Kit简介

使用WebSocket访问网络(C/C++)

Network Boost Kit（网络加速服务）

Network Boost Kit常见问题

在进行多网并发传输时，如何判断当前使用的网络是Wi-Fi还是流量

如果使用多网并发能力超过剩余配额限制，会发生什么

Network Boost Kit术语

Remote Communication Kit（远场通信服务）

Remote Communication Kit简介

Configuration：高效实现定制功能

DnsConfiguration：定制DNS

TransferConfiguration：定制数据传输

ProxyConfiguration：定制代理

SecurityConfiguration：定制安全传输行为

ProcessingConfiguration：定制处理行为

基于TracingConfiguration实现性能维测

通过配置Configuration优化传输性能

Remote Communication Kit术语

Service Collaboration Kit（协同服务）

Service Collaboration Kit简介

Service Collaboration Kit常见问题

接入跨设备互通控件后，设备选择列表没有周围设备

Telephony Kit（蜂窝通信服务）

使用网络报文分析功能实现tcpdump抓包

基础功能

Basic Services Kit（基础服务）

Common Event Service术语

Desktop Extension Kit（桌面拓展服务）

Desktop Extension Kit简介

应用接入状态栏

应用接入快捷栏

Desktop Extension Kit 术语

FAST Kit（算法加速服务）

FAST Kit简介

使用SegmentMap查询维护区间信息

使用RectPartition求解矩形划分

使用PolyRoot求解多项式根

使用ConcurrentHashmap在多线程下完成键值信息的查找维护

使用mathPrediction进行数理预测

perfHint系统性能优化

使用perfHint系统性能优化(ArkTS)

使用perfHint系统性能优化(C/C++)

FAST Kit术语

Function Flow Runtime Kit（任务并发调度服务）

Function Flow Runtime Kit概述

Function Flow Runtime并发范式

Function Flow Runtime开发样例(C)

Function Flow Runtime串行队列(C)

Function Flow Runtime并发队列(C)

Function Flow Runtime图依赖并发(C)

Function Flow Runtime开发样例(C++)

Function Flow Runtime串行队列(C++)

Function Flow Runtime并发队列(C++)

Function Flow Runtime图依赖并发(C++)

Function Flow Runtime任务伙伴(C++)

Function Flow Runtime开发指导

Function Flow Runtime C API

Function Flow Runtime术语

EnterpriseAdminExtensionAbility开发指南

个人数据处理说明

MDM Kit术语

附录

Kernel Enhance Kit（内核增强能力）

Kernel Enhance Kit 简介

QoS 开发指导

格物服务开发指导

内存管理 Purgeable Memory 开发指导

Service Support Kit（服务与支持）

Service Support Kit简介

Driver Development Kit（驱动开发服务）

Driver Development Kit简介

Multimodal Awareness Kit（多模态融合感知服务）

Multimodal Awareness Kit简介

Multimodal Awareness Kit术语

Pen Kit手写套件是否支持自定义笔刷？

Pen Kit手写套件是否支持自定义笔宽？

Pen Kit手写套件是否支持自定义颜色？

Pen Kit手写套件的工具栏是否可以单独提供？

集成了Pen Kit手写套件，还需要集成报点预测吗？

集成了Pen Kit手写套件，还需要集成一笔成形吗？

Pen Kit报点预测功能能够调整预测的程度吗？

为什么一笔成形识别不出来？

Sensor Service Kit（传感器服务）

Sensor Service Kit开发简介

Mechanic Kit（机械设备管理服务）

Mechanic Kit简介

目标拍摄跟踪开发指南

术语

Wear Engine Kit（穿戴服务）

管理应用与Wear Engine服务的连接状态

如果工程已有APP ID，是否需要重新申请，填写新的APP ID

如何获取应用指纹

没有弹出用户授权界面

接口调用时返回App has not applied for the Wear Engine service错误信息

打开HR传感器后，没有立刻上报数据

HR传感器数据中，存在数值为0或255的异常情况

手机和轻量级智能穿戴设备通信，提示错误码206

手机侧应用发送文件给穿戴设备侧应用时，提示错误码1008500011

更多：若以上FAQ仍不能解决，可通过在线提单反馈

个人数据处理说明

Wear Engine Kit术语

AOD Navigation Kit（熄屏导航服务）

Performance Analysis Kit（性能分析服务）

Performance Analysis Kit简介

AddrSanitizer（地址越界）检测

AppFreeze（应用冻屏）检测

Resource Leak（资源泄漏）检测

订阅ArkWeb抛滑丢帧事件（ArkTS）

订阅24h功耗器件分解统计事件（ArkTS）

使用FaultLogExtensionAbility订阅事件

性能跟踪

HiTraceMeter介绍

使用HiTraceMeter跟踪性能（ArkTS）

使用HiTraceMeter跟踪性能（C/C++）

查看HiTraceMeter日志

分布式调用链跟踪

HiTraceChain介绍

使用HiTraceChain打点（ArkTS）

使用HiTraceChain打点（C/C++）

检测模式

使用HiChecker检测问题（ArkTS）

使用HiCollie检测业务线程卡死卡顿问题（C/C++）

使用HiCollie监控函数执行时间超长问题（C/C++）

使用HiRetrieval进行应用灰度采集（ArkTS）

Performance Analysis Kit术语

PrivacyManagerService

js-rawheap-translator工具

媒体

使用OHAudio开发音频会话功能(C/C++)

音频播放

音频播放开发概述

选择合适的播放流类型

推荐使用OHAudio开发音频播放功能(C/C++)

使用AudioRenderer开发音频播放功能(ArkTS)

低时延音频播放(C/C++)

低功耗音频播放

使用AudioHaptic开发音振协同播放功能(ArkTS)

使用SoundPlayer开发系统音效播放功能

推荐使用OHAudio开发音频录制功能(C/C++)

使用AudioCapturer开发音频录制功能(ArkTS)

使用OH_MIDI进行MIDI开发(C/C++)

OpenSL ES开发指导(不再推荐)

从OpenSL ES切换到OHAudio(C/C++)

使用OpenSL ES开发音频播放功能(C/C++)

使用OpenSL ES开发音频录制功能(C/C++)

AVCodec Kit（音视频编解码服务）

HDR Vivid视频转码SDR视频开发实践

基于Buffer模式进行视频转码

基于Surface模式进行视频编码

AVCodec Kit常见问题

创建视频解码器和NativeWindow初始化并行

视频编解码宽高、跨距与裁剪信息说明

AVSession Kit（音视频播控服务）

使用AVCastPickerHelper接口常见问题

通过系统相机拍照和录像(CameraPicker)

适配不同折叠状态的摄像头变更(ArkTS)

在Worker线程中使用相机(ArkTS)

基于AVPlayer播放DRM节目(ArkTS)

基于AVCodec播放DRM节目(C/C++)

使用ImageSource完成多图对象解码

使用ImagePacker完成多图对象编码

图片编辑和处理

使用PixelMap完成图像变换

使用PixelMap完成位图操作

使用VideoProcessingEngine实现图片超分辨率

使用ImageReceiver完成图片接收

图片开发指导(C/C++)

图片解码

使用Image_NativeModule完成图片解码

使用Image_NativeModule完成多图对象解码

图片解码内存优化(C/C++)

图片区域解码与下采样(C/C++)

使用Image_NativeModule完成动图解码

使用Image_NativeModule完成HDR图片解码

图片编码

使用Image_NativeModule完成图片编码

使用Image_NativeModule完成多图对象编码

图片编辑和处理

使用Image_NativeModule完成位图操作

使用ImageEffect编辑图片

使用ImageProcessing处理图片

使用Image_NativeModule读取和编辑图片Exif信息

图片接收

使用Image_NativeModule完成图片接收

使用AVPlayer播放音频(ArkTS)

使用AVPlayer播放视频(ArkTS)

使用AVPlayer设置播放URL(ArkTS)

使用AVPlayer播放流媒体(ArkTS)

使用AVPlayer添加视频外挂字幕(ArkTS)

使用SoundPool播放短音频(ArkTS)

录制

使用AVRecorder录制音频（ArkTS）

使用AVRecorder录制视频(ArkTS)

使用AVScreenCaptureRecorder录屏写文件(ArkTS)

媒体信息查询

使用AVMetadataExtractor提取音视频元数据信息(ArkTS)

使用AVImageGenerator提取视频指定时间图像(ArkTS)

视频转码

使用AVTranscoder实现视频转码(ArkTS)

创建异步线程执行AVTranscoder视频转码(ArkTS)

基于AVScreenCapture实现屏幕录制（ArkTS）

媒体开发指导(C/C++)

播放

使用AVPlayer播放音频(C/C++)

使用AVPlayer播放视频(C/C++)

使用AVPlayer播放流媒体(C/C++)

使用LPP播放器播放视频 (C/C++)

录制

使用AVRecorder录制音频(C/C++)

使用AVRecorder录制视频(C/C++)

使用AVScreenCapture录屏取码流(C/C++)

AVScreenCapture录屏基础流程

AVScreenCapture录屏自定义场景

录屏常见问题

使用AVScreenCapture录屏写文件(C/C++)

使用AVScreenCapture实现窗口级录屏(C/C++)

基于AVScreenCapture实现屏幕录制（C/C++）

屏幕录制支持矩形区域录制

媒体信息查询

使用AVMetadataExtractor获取元数据(C/C++)

使用AVImageGenerator获取视频帧(C/C++)

视频转码

使用AVTranscoder实现视频转码(C/C++)

Media Library Kit（媒体文件管理服务）

Media Library Kit 简介

使用Picker选择媒体库资源

保存媒体库资源

使用PhotoPicker组件访问图片/视频

使用AlbumPicker组件访问相册列表

使用RecentPhoto组件获取最近一张图片

使用PickerController将编辑后的图片替换原图

使用PhotoPicker推荐图片

动态照片

访问和管理动态照片资源

使用MovingPhotoView播放动态照片

使用MediaAssetManager请求媒体资源(C/C++)

图片获取与保存实践

Media Library Kit常见问题

上传软件包时提示“上传的软件包与声明支持设备不一致”

自定义界面扫码同时调用本地图片识码时，应用概率性自动退出

图形

获取检测平面的二维顶点数组时报错：“plane is nullptr!”，返回错误码：401

摄像头被遮挡一段时间后再放开，输出的位姿有跳变

反光、光线暗或者弱纹理场景（输入图像颜色变化小）下无法识别平面

某些特殊场景下（如附近存在磁场干扰、手机发烫或扫描到重复纹理等），出现平面漂移或者位姿数据跳变现象

ArkGraphics 2D（方舟2D图形服务）

NativeDisplaySoloist开发指导 (C/C++)

NativeVSync开发指导 (C/C++)

图形缓冲区

NativeBuffer开发指导 (C/C++)

NativeImage开发指导 (C/C++)

NativeWindow开发指导 (C/C++)

GPU/CPU内存访问同步操作开发指南 (C/C++)

图形缓冲区常见稳定性问题 (C/C++)

ArkGraphics 2D术语

ArkGraphics 3D（方舟3D图形）

ArkGraphics Editor插件及编辑器的下载与安装

Graphics Accelerate Kit（图形加速服务）

Graphics Accelerate Kit简介

Graphics Accelerate Kit常见问题

游戏渲染加速服务

超帧和ABR支持的图形API有哪些

Kit支持的设备类型有哪些

开启超帧外插模式后运动物体边缘出现严重拖影现象，可能的原因是什么

哪些特征的Buffer适合使能ABR

ABR进行Buffer分辨率调整引起其他Pass渲染效果异常，该如何解决

集成ABR后，从游戏引擎获取到的Native纹理内容为空，该如何解决

游戏资源加速服务

上传至华为CDN的资源包文件支持哪些格式类型

集成游戏资源加速ExtensionAbility方法，未配置游戏资源加速ExtensionAbility组件类型信息，导致功能未生效

集成了游戏资源加速ExtensionAbility方法，未配置网络权限，导致功能未生效

游戏资源加速ExtensionAbility方法中使用static静态变量为什么不生效

如何解析华为CDN场景下manifestUrl对应的xml文件

是否可以仅接入下载ExtensionAbility，而不改写原先在游戏引擎内部的下载逻辑或下载中间件

接入资源包后台下载功能后如何使用指定测试设备进行自测

是否可以终止已发布的下载任务，例如游戏出现问题时是否能够及时关闭

是否可以申请长时任务，在游戏前台下载资源包过程中切后台时免冻结并继续下载资源包

若开发者在游戏中使用Unity Addressables资源管理框架，如何集成游戏资源包后台下载功能

游戏启动加速服务

通过加载内存镜像启动的游戏会全屏显示来电提醒，应该如何避免

游戏上划退出后，场景切换阶段存在振动，应该如何避免

快速启动的游戏存在三方SDK功能异常，应该如何排查

游戏调用UnityEngine.Application.Quit侧滑退出时出现黑屏现象，应该如何避免

日志中频繁打印BusinessError: The Worker instance is not running, maybe worker is terminated when PostMessage错误信息，应该如何排查

游戏出现卡死后，应该如何避免下一次秒启后还是卡死场景

秒级启动后，游戏出现类似UIContent is nullptr报错导致登录等异常，应该如何排查

游戏因未实现防沉迷提醒提审被拒，应该如何解决

游戏秒级启动场景中闪屏播放与游戏音频恢复不同步，应该如何解决

游戏接入秒级启动后无法热更应该如何处理

团结引擎1.8.1～1.9.0版本在Tablet设备上调用秒启接口异常应该如何解决

游戏伴随服务

游戏截图回调没有返回的文件描述符如何处理

Graphics Accelerate Kit术语

Spatial Recon Kit（空间建模服务）

XEngine Kit（GPU加速引擎服务）

应用服务

开发者使用Account Kit的登录能力的管理细则

华为账号一键登录（获取手机号和UnionID/OpenID）

华为账号登录（获取UnionID/OpenID）

Account Kit Skill能力开放

Account Kit通知事件

Account Kit常见问题

1001500001 应用指纹证书校验失败的可能原因和解决办法

1001502014 应用未申请scopes或permissions权限的可能原因和解决方法

一键登录场景下无法获取到匿名手机号如何解决

一键登录场景下无法获取到明文手机号如何解决

一键登录场景下，应用已展示一键登录页，此时用户退出、切换或注销华为账号应该如何处理

使用华为账号一键登录功能时，是以华为账号的UnionID/OpenID还是以手机号作为用户的主要标识

HarmonyOS APK应用和HarmonyOS应用在一键登录场景下的用户数据如何互通

无法获取到头像昵称如何解决

OpenID和UnionID的格式说明

Access Token和Refresh Token的有效时长是多久

Access Token和Refresh Token长度限制要求

ID Token的使用场景与使用方法

未成年人模式开启后USB断连如何解决

订阅到系统未成年人模式开启了，这个时候应用要怎么处理

三方开发框架接入华为账号一键登录

不同开发者的应用之间如何实现用户数据互通

401 参数检查失败的可能原因和解决办法

60180007 服务端通过Authorization Code无法获取到华为账号一键登录手机号如何解决

1001502003 输入参数值无效的可能原因和解决办法

PC设备请求或展示广告时返回了801错误码

开放匿名设备标识服务

鲸鸿动能Ads Kit个人数据处理说明

AppGallery Kit（应用市场服务）

通过AppGallery Connect配置数字商品

通过AppGallery Connect动态管理应用图标

实现应用图标动态切换

应用评论服务

AppGallery Kit常见问题

AppGallery Connect中可以配置多个订阅关键事件回调地址吗？

AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？

AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？

在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？

AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6/9等调整？

是否必须使用SHA256的证书才能通过验签？

签名校验是否可以都在服务端执行？

支付界面是否仅有一种UI设计？是否存在其他支付界面方案？

是否能在删除商品后添加具有相同productId的商品？

订阅型商品中的续费周期1个月是指30天、31天还是自然月？同理，2个月、3个月具体包含多少天数？

订阅时长按照自然月计算时，2月份是28天还是29天？

应用市场推荐展示元服务卡片异常

按需加载场景中加载动态模块失败

按需加载模块是否支持单独上架应用市场或单独更新？

按需加载场景中，应用在加载指定模块后重启，还是已加载状态吗？是否需要重新发起按需加载请求？

按需加载场景中，用户在加载指定模块后是否可以卸载，然后重新发起请求？

按需加载场景中，是否支持依赖模块同步加载?

按需加载场景中，是否支持同时存在多个任务？

按需加载成功后，再通过应用市场更新应用，是否需要再次触发按需加载？

按需加载成功后，跳转动态模块页面失败？

未上架应用市场的应用，如何快速接入调试产品特性按需分发功能？

生态查询服务场景中获取自身场景值为空

应用市场更新功能抛出不在前台异常

向用户显示应用更新提示弹框文案能否自定义？

调用应用归因服务登记归因来源接口报错身份检查错误

App Linking Kit（应用链接服务）

通过App Linking应用链接拉起指定应用

通过直达应用市场能力跳转至应用市场下载详情页

Call Service Kit（通话服务）

Cloud Foundation Kit（云开发服务）

Cloud Foundation Kit简介

（可选）通过端云一体化开发工程调试本地云函数

Cloud Foundation Kit常见问题

云存储

使用云存储上传文件失败，提示“404:Product does not exist”

使用云存储上传文件失败，app日志提示“"state":65”，upload进程日志提示“403 Forbidden”

调用云存储业务接口失败，app日志提示“"state":65”，upload进程日志提示“404 Not Found”

预加载

如何通过应用侧日志定位预加载问题

运行应用时提示“appid **** is not in white list, to skip”

运行应用时报“XXX Read timed out”异常

Cloud Foundation Kit术语

Enterprise Space Kit（企业数字空间服务）

Enterprise Space Kit简介

Enterprise Space Kit常见问题

Enterprise Space Kit术语

File Manager Service Kit（文件管理服务）

File Manager Service Kit简介

删除文件到回收站

获取文件图标

解析文件快捷方式

File Manager Service Kit术语

Game Controller Kit（游戏控制器服务）

Game Controller Kit简介

监听设备上下线（C/C++）

监听游戏手柄的轴和按键事件（C/C++）

Game Controller Kit术语

Game Service Kit（游戏服务）

若游戏无HarmonyOS 4及以下系统包时，是否可以不配置APP ID映射关系

使用C#语言开发的游戏是否可以接入游戏场景感知功能？

附录

配置回调地址

获取游戏密钥

Health Service Kit（运动健康服务）

Health Service Kit常见问题

AppGallery Connect中可以配置多个关键事件通知接收地址吗？

AppGallery Connect获取的IAP公钥最大长度是多少？便于用户存储设置的最大长度是多少？

AppGallery Connect商品管理页面，商品价格编辑界面的默认价格表示什么意思？

在AppGallery Connect中单独修改商品在某个地区的价格，以后汇率变动，是否会影响应用内的商品价格？

AppGallery Connect商品管理页面中，价格展示是否做了数字调整？比如小数点第二位6/9等调整？

是否必须使用SHA256的证书才能通过验签？

签名校验是否可以都在服务端执行？

是否能在删除商品后添加具有相同productId的商品？

IAP服务器支持的证书范围

IAP服务器支持的加密套件范围

如何解决证书链不完整？

应用在子窗口中调用createPurchase拉起IAP Kit收银台时，子窗口会被隐藏，此现象正常吗？

在沙盒环境进行测试，但是实际需要真实支付是为什么？

HarmonyOS元服务和HarmonyOS应用是否可以共用同一个API密钥？

purchaseToken和purchaseOrderId这两个参数的最大长度是多少？

subGroupId（订阅组ID）、subGroupGenerationId（订阅组的代ID）和subscriptionId（订阅ID）说明

developerPayload处理机制及使用建议

应用迁移后，JWT密钥验签错误自查方法

自动续期订阅商品，A切换B且立即生效时，新订阅有效期的组成

Game Controller Kit简介

更新时间: 2026-08-21 10:52

本文导读

Game Controller Kit（游戏控制器服务）支持游戏适配控制器外设（当前仅支持手柄），解决玩家操控性问题，保障用户体验。游戏开发者可通过接入该服务轻松实现游戏外设的上下线和按键及轴事件监听等功能。

能力范围

Game Controller Kit支持的能力包括：

监听设备上下线，查询所有在线设备的具体信息
监听游戏手柄的轴和按键事件

约束与限制

支持的国家和地区

当前仅支持在中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）提供服务。

支持的设备

支持Phone、PC/2in1、Tablet、TV

模拟器支持情况

本Kit暂不支持模拟器。

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问 AI 助手提问