简体中文

输入关键字搜索

开发者能力认证

鸿蒙高校创新赛

HarmonyOS 7

animation

HarmonyOS行业解决方案

layoutWeight

HarmonyOS模板&组件

bindPopup

bindsheet

CTRL+K

文档管理中心

我的

Hello，

欢迎来到开发者联盟

应用框架

系统

媒体

图形

应用服务

Account Kit（华为账号服务）

Account Kit简介

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

申请账号权限

配置签名和指纹

配置Client ID

华为账号一键登录（获取手机号和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 输入参数值无效的可能原因和解决办法

Account Kit术语

个人数据处理说明

支持的国家/地区

Ads Kit（广告服务）

流量变现服务开发

流量变现服务开发概述

流量变现服务常见问题

展示广告时显示白屏

鲸鸿动能媒体服务平台打开受限

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

开放匿名设备标识服务

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

AppGallery Kit（应用市场服务）

AppGallery Kit简介

数字商品服务

启用数字商品服务

开通相关服务和配置参数

配置数字商品

数字商品介绍

通过AppGallery Connect配置数字商品

通过Server API配置数字商品

应用内分发数字商品

展示数字商品

购买数字商品

发放数字商品权益

测试数字商品服务

应用市场推荐

添加元服务卡片至桌面

展示应用详情页面

应用内快捷方式

添加桌面快捷方式

查询应用内快捷方式

删除应用内快捷方式

产品特性按需分发

产品特性按需分发(ArkTS)

产品特性按需分发(C/C++)

生态查询服务

应用市场更新功能

应用归因服务

注册企业账号

管理归因角色

管理转化事件

标准转化事件

自定义转化事件

管理归因策略

登记归因来源及转化

归因结果回传

接入调试功能

隐私管理服务

图标管理服务

通过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天？

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

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

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

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

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

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

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

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

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

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

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

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

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

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

如何过滤应用归因服务的日志？

如何过滤应用内快捷方式加桌的日志？

应用内快捷方式加桌返回401错误码

标准化事件及应用归因签名

支持的国家/地区

AppGallery Kit术语

App Linking Kit（应用链接服务）

App Linking Kit简介

基本准备工作

开通App Linking服务

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

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

通过延迟链接跳转至应用详情页

通过聚合链接按指定方式跳转至应用

App Linking Kit术语

Calendar Kit（日历服务）

Calendar Kit简介

日历账户管理

注册并管理一键服务日程

日历服务实践案例

Call Service Kit（通话服务）

Call Service Kit简介

企业联系人信息来去电页面显示

企业服务信息来去电页面显示

应用跳转陌生号码和信息识别页面

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术语

个人数据处理说明

支持的国家/地区

Contacts Kit（联系人服务）

Contacts Kit简介

使用picker管理联系人

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（游戏服务）

Game Service Kit简介

基础游戏服务（必选）

网络游戏登录

网络游戏登录概述

接入华为账号登录（必选）

接入游戏官方账号登录

单机游戏登录

开发后自检

小游戏登录（必选）

小游戏支付

基础游戏服务术语

游戏场景感知（可选）

开发指导(ArkTS)

开发指导(C/C++)

游戏场景感知术语

游戏近场快传（可选）

传输资源包

传输安装包

游戏近场快传术语

个人数据处理说明

Game Service Kit常见问题

基础游戏服务

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

游戏官方账号图标大小是多少

如何设置游戏登录界面不显示官方账号登录

玩家选错登录账号后如何处理

游戏场景感知

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

配置回调地址

获取游戏密钥

Health Service Kit（运动健康服务）

Health Service Kit简介

应用开发者申请资质说明

数据开放总览

申请运动健康服务

配置Client ID

Phone/Tablet应用开发

拉起运动健康App隐私授权

管理用户授权

管理数据源

管理运动健康数据

运动健康采样数据

实时三环数据

手动数据同步

Wearable应用开发

管理用户授权

管理运动健康数据

读取运动健康采样数据

读取锻炼记录

读取健康记录

实时三环数据

LiteWearable应用开发

管理用户授权

运动联动管理

心率变异性

锻炼记录数据

潜水闭气测试

潜水闭气训练

健康记录数据

申请验证获取正式权限

Health Service Kit常见问题

Health Service Kit术语

个人数据处理说明

标志使用规范

IAP Kit（应用内支付服务）

IAP Kit接入规范

接入Skill（可选）

基本准备工作

开通商户服务

创建项目和应用

开启和激活应用内购买服务

（可选）申请嵌入式收银台开放能力权限

（可选）配置应用内购买服务参数

配置商品信息

配置应用身份信息

消耗型/非消耗型商品购买

自动续期订阅商品购买

自动续期订阅说明

接入自动续期订阅

非续期订阅商品购买

收益分析和报告

IAP 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且立即生效时，新订阅有效期的组成

华为IAP范围覆盖

Live View Kit（实况窗服务）

Live View Kit简介

实况窗设计规范

基本准备工作

开通推送服务权益

设置数据处理位置

开通实况窗服务权益

接入联调测试

申请实况窗正式权限

开发实况窗场景

开发实况窗须知

构建本地实况窗

通过Push Kit更新实况窗

Live View Kit常见问题

更新实况窗被频控的问题

三方开发框架接入的问题

关于实况窗生命周期的问题

关于实况窗模板使用的问题

关于实况窗数量约束的问题

Live View Kit术语

Location Kit（位置服务）

Location Kit简介

申请位置权限开发指导

申请开放能力权限指导

获取设备的位置信息开发指导

获取设备的位置信息开发指导(ArkTS)

获取设备的位置信息开发指导(C/C++)

正地理编码与逆地理编码开发指导

地理围栏开发指导

地理围栏简介

端侧GNSS围栏开发指导

云侧围栏开发指导

个人数据处理说明

Map Kit（地图服务）

切换地图类型

显示我的位置

显示自定义地图

更改地图位置

在地图上绘制

设置地图元素压盖顺序

海量点图层

出行路线规划

地点详情展示

通过地图应用实现导航等能力

地图计算工具

Map Kit常见问题

地图不显示

siteId参数如何获取

手势卡顿或者不生效

设置地图Logo始终显示

场景化控件的language参数生效范围

个人数据处理说明

上架前准备-获取地图服务协议及资质证明

地图数据版权声明

支持的语言

支持的国家/地区

Notification Kit（用户通知服务）

Notification Kit简介

请求通知授权

管理通知角标

管理通知渠道

发布文本类型通知

发布进度条类型通知

为通知添加自定义铃声

为通知添加行为意图

跨设备协同通知

跨设备协同通知概述

清除跨设备场景下的重复通知

通知订阅扩展能力

通知订阅扩展能力概述

通知订阅扩展能力开发步骤

Notification Kit术语

申请优先通知权益

应用内通知设置快捷入口开发指导

Payment Kit（鸿蒙支付服务）

Payment Kit简介

接入规范学习

接入Skill说明

收银台设计规范

商户入网和获取商户号

（可选）特定场景配置操作

开通支付服务

商户号绑定AppID

端侧应用配置

云侧服务准备

（可选）数字人民币接入准备

（可选）用户身份验证服务接入准备

商户基础支付场景

平台类商户合单支付场景

免密支付接入

免密代扣说明

支付并签约场景

签约代扣场景

数字人民币支付场景

通用收银台接入

业务规则说明

混合支付场景

纯外部支付场景

拉起三方支付收银台

基于URL跳转方式

基于接口拉起方式

三方支付问题处理

引导用户绑卡场景

用户身份验证服务

实名信息验证/授权场景

人脸核身实人验证场景

身份验证服务调用记录查看

沙盒环境验证

商家券场景

Payment Kit术语表

服务与支持

Payment Kit常见问题

接入开发时，请求参数的签名、结果验签在什么场景使用？

Payment Kit的签名公私钥怎么获取？

GET请求的bodySign是对谁签名得到的？

拉起收银台无反应或报错？

支付成功后没有收到回调？

同一用户重复签约，会生成多笔签约吗？

华为支付签约的免密代扣在哪里可以解约？

关于支付回调的验签，为什么预下单请求验签的时候使用SHA256，回调验签却使用SM2？只能使用SM2进行验签吗？

接口请求响应“无效的签名”应该如何排查？

收银台报错“服务暂不可用，请稍后重试”？

预下单请求报错“交易订单状态异常”？

预下单一段时间后再支付，能否有接口查到prepayId？

部分提供通知回调的API接口中的callbackUrl参数是否可以自定义？回调通知的报文是否支持商户自定义？

同一次支付请求接收到多次回调通知，怎么解决？

商户提供的回调通知接口在Payment Kit生产环境需要加网络允许清单吗？如何验证提供的回调地址Payment Kit服务器访问是否正常？

商户侧没有传营销信息，支付回调里面为什么会有营销信息？

App和元服务接口入参除了appId不同，其他如商户号、证书、密钥这些可以使用相同的吗？

商户入网后，有商户接入联调环境吗？

请求头PayMercAuth中的callerId和请求体中的mercNo或者combineMercNo是什么关系？

请求接口加签验证中，如果请求头“PayMercAuth”中bodySign字段为空值，会做验签吗？还是会先校验字段？

不更换商户订单号重复发起退款，返回000000，不返回退款金额的原因是什么？

Payment Kit的退款操作，除了通过接入指导中的退款接口退款，还有财务功能相关平台吗？能从这个平台进行退款？

下载账单文件后，应该使用哪种格式来解析日期？

收银台支付报错“应用信息校验不通过，请联系商家处理”？

商户号绑定AppID提示“主体不一致”？

如何联系运营机构或受理服务机构获取开发指引？

找不到“支付服务（非虚拟类）”菜单或AppID关联授权的页面怎么处理？

PDF Kit（PDF服务）

pdfService能力

打开和保存PDF文档

添加、删除PDF页

PDF页面文本、图片和批注

转换PDF文档为图片

转换指定页面或指定区域为图片

转换整个PDF文档为图片

判断PDF文档是否加密及删除加密

添加、删除书签

添加、删除页眉页脚

添加、删除水印

添加、删除背景

PdfView预览组件

预览PDF文档

打开和保存PDF文档

设置PDF文档预览效果

搜索关键字

高亮显示PDF文档

PDF缩略图转换为图片

优化PDF文档切换体验

PDF Kit 常见问题

PDF Kit可以移除具体页面的页眉页脚、水印、背景吗？

PDF文档支持在线预览吗？

Preview Kit（文件预览服务）

Preview Kit简介

文件打开加速（C/C++）

文件打开加速状态感知（已废弃）

通用文件缓存加速（C/C++）

Preview Kit常见问题

openPreview打开显示预览失败

使用DocumentViewPicker拿到的uri通过openPreview打开显示预览失败

Preview Kit术语

Push Kit（推送服务）

学习Push Kit接入规范

开通推送服务

申请推送场景化消息权益

获取Push Token

推送场景化消息

推送通知消息

发送通知消息

撤回通知消息

推送角标刷新消息

推送卡片刷新消息

推送语音播报消息

发送语音播报消息

撤回语音播报消息

推送后台消息

推送实况窗消息

推送应用内通话消息

端云调试概述

基于服务账号生成鉴权令牌

推送场景化消息

（可选）开发消息回执

（可选）推送报告

（可选）接入Skill

场景化消息开发Skill

通知消息自分类权益推荐Skill

Push Kit常见问题

如何处理推送消息时遇到的问题

关于云侧接口推送成功但设备收不到推送消息的问题

如何处理误分类问题

如何处理推送通知消息数量不够用问题

关于通知消息被频控的问题

应用内通话消息在设备重启后的首次锁屏状态问题

如何处理应用内通话消息的来电横幅问题

场景化消息中的请求URL版本问题

应用处于后台时应用内如何接收消息

要实现即时聊天功能应该使用什么类型的场景化消息

如何更换回执服务器证书的问题

个人数据处理说明

通知内容管理细则

通知违规处罚标准

支持的国家/地区

Reader Kit（阅读服务）

Reader Kit简介

书籍内容解析

获取书籍信息

获取目录列表

书籍内容排版

构建阅读器

修改阅读设置

自定义字体

自定义页面背景

修改翻页方式、字体大小及行间距

适配深、浅色模式

监听文本缩放因子变化

书籍内容交互

手动触发翻页

阅读进度通知

Scenario Fusion Kit（融合场景服务）

Scenario Fusion Kit简介

场景化Button

快速验证手机号Button

选择头像Button

打开APP Button

选择收货地址Button

选择发票抬头Button

地图选点Button

权限设置Button

获取手机号和风险等级Button

省市区选择器Input

通过API获取系统信息属性

通过API异步获取系统信息属性

通过API获取系统设置属性

通过API展示关注组件

文件路径转换API

智能填充服务

智能填充概述

典型场景展示

动态修改ContentType值

自动补全地址表单所在地区

推荐车牌号场景

推荐数据源及推荐逻辑说明

ContentType使用场景说明

三方框架+H5接入智能填充

H5接入智能填充

React Native框架+H5接入智能填充

Flutter框架+H5接入智能填充

Taro框架+H5接入智能填充

Weex框架+H5接入智能填充

mPaas框架+H5接入智能填充

H5/三方框架和HarmonyOS配置项映射关系

Scenario Fusion Kit术语

Scenario Fusion Kit常见问题

单击快速验证手机号按钮，无法拉起页面

打开应用功能跳转第三方应用失败

剪贴板粘贴框遮挡智能填充选择框

个人数据处理说明

支持的国家/地区

Screen Time Guard Kit（屏幕时间守护服务）

Screen Time Guard Kit简介

受限ACL权限申请

用户授权管理

请求用户授权

取消用户授权

健康使用设备授权列表页中应用授权开关打开/关闭时触发回调

应用选择页

拉起应用选择页

拉起许可应用跳转页

守护策略管理

查询策略配置数据

查询策略运行数据

应用访问限制

设置应用访问限制

解除应用访问限制

拦截页跳转至管控应用

Screen Time Guard Kit术语

Share Kit（分享服务）

Share Kit简介

Share Kit体验规范

宿主应用发起分享需使用精细化的utd类型

目标设备接收分享数据一步直达体验

宿主应用发起分享

宿主应用接入模式

通过分享面板发起分享

配置目标应用名单（仅对企业应用开放）

自定义配置操作区

获取分享结果

目标应用处理分享内容

应用内处理分享内容

分享详情页处理分享内容

分享详情页关闭分享面板

判断应用是否被系统分享拉起

共享联系人信息到分享推荐区

目标应用设计规范

常见分享场景

碰一碰分享

手机与手机碰一碰分享

手机与PC/2in1碰一碰分享

分享内容直达应用界面

手机与PC/2in1、手机与Tablet间相互分享

打开设备侧隔空传送开关

可信任设备间传输

分享App Linking直达应用

Share Kit常见问题

拉起系统分享框失败

分享数据类型不支持

分享时提示“您选择的文件不支持分享”

Share Kit术语

Wallet Kit（钱包服务）

Wallet Kit简介

Wallet Kit接入Skill说明

数字车钥匙

开通车钥匙

查看车钥匙

更新车钥匙

使用车钥匙

迁移车钥匙

删除车钥匙

上传车端数据到DK服务器

开通交通卡

充值交通卡

更新交通卡

删除交通卡

开通园区卡

查看园区卡

更新园区卡

删除园区卡

生成展示二维码

开通会员卡

查看会员卡

更新会员卡

删除会员卡

开通酒店房卡

查看酒店房卡

更新酒店房卡

删除酒店房卡

开通出行凭证

查看出行凭证

更新出行凭证

删除出行凭证

活动/景点门票

开通活动/景点门票

查看活动/景点门票

更新活动/景点门票

删除活动/景点门票

开通通用凭证

查看通用凭证

更新通用凭证

删除通用凭证

Wallet Kit常见问题

Wallet Kit支持在除手机外的设备中调用吗？

开发者应用使用Wallet Kit，是否需要集成华为Account Kit？

Wallet Kit接口调用注意事项？

现有提供的几种接入方式中，比较常用的是哪种？

如何查看已添加卡券？

用户领取了同一商户的多张卡券，但是打开华为钱包后只显示一张卡券？

用户删卡时会删除哪些信息？

Wallet Kit术语

Weather Service Kit（天气服务）

Weather Service Kit简介

获取天气数据

Weather Service Kit 常见问题

如何获取指定城市的天气数据

Weather Service Kit接口有定位功能吗

请求了分钟级降水预报/天气预警/潮汐，未返回任何数据。

个人数据处理说明

AI

NDK开发

您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。了解新版目录

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

更新时间: 2026-03-09 02:50

复制页面

不会，除非开发者自己修改。

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

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

意见反馈

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

意见反馈

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

社区提问 AI 助手提问