HarmonyOS SDK闭源开放能力技术团队

原创 鸿蒙生态伙伴SDK专区上架FAQ

鸿蒙生态伙伴SDK专区是面向SDK提供商伙伴及开发者打造的SDK一站式供给平台，汇聚了行业主流SDK，推动热门优质的SDK与应用开发者高效连接，提升应用开发过程中的SDK获取和集成效率，帮助开发者构建高品质鸿蒙应用。为帮助广大SDK提供商伙伴更高效、顺畅地完成上架，我们梳理了过往伙伴们在实践中频繁遇到的问题，并整理为FAQ，助力伙伴提前预见可能遇到的常见障碍，提前规避、精准准备，从而更快速、更优质地实现上架。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 —Media Library Kit

photoviewpicker只是通过select方法获取uri，并把该资源访问授权给用户，用户需要通过该uri去获得相应资产，即photoAccessHelper.PhotoAsset，获得asset后通过get方法获得对应的属性photoSubtype。受限权限需要在应用市场申请权限，权限申请流程繁琐。“这个api的结果是否支持回传选择图片的类型，比如选择了一个动态图片和静态图片，如何区分是否是动态图片？升级6后，IDE的文件浏览，图库不显示目录名了，都是数字，找图片困难。进行相册图片选择等。

原创 化繁为简：顺丰速运App如何通过 HarmonyOS SDK实现专业级空间测量

AR Engine所提供的高精度语义几何重建技术方案，最显著的特点在于其纯软件实现方案。不同于传统的空间计算往往依赖于LiDAR（激光雷达）或ToF等专用深度硬件，该方案仅通过标准的RGB摄像头即可媲美专业级精度，这意味着更广泛的鸿蒙手机用户能够享受到这一功能。

原创 五指一抓一放，即可实现探屏“取”物、隔空传送

跨端分享是应用常备的基础能力，从有线USB到无线WIFI传输，跨端传输能力在不断发展，然而，传统传输场景受到配对条件、网络速度、文件大小等因素影响，已经无法满足用户在工作、游戏以及生活等场景中的高频传输需求。为此，HarmonyOS SDK 分享服务（Share Kit）新推出了隔空传送分享功能，支持用户使用“一抓一放”的简单手势，通过精准的界面反馈，给予用户强使用感知，并引导用户的每一步操作，从而实现人机交互形式的近距离快速跨端传输。隔空传送照片使用场景。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit

Push token不是有效的token，建议您在应用启动时调用getToken()接口，若设备的Push Token发生变化，及时上报到您的应用服务器更新Push Token，以防由于Push Token失效导致收不到消息。1、如果接收端的设备离线，导致消息重新发送到接收端设备，则应用消息最多可以在Push Kit服务器侧缓存15天，该缓存时间可以在pushOptions中由ttl参数定义。2、如果接收端设备在线，但是应用不在前台，导致推送后台消息时无法推送至应用，则该消息会缓存至端侧，最多可缓存7天。

原创 通过实时竞价能力，重塑广告收益曲线

实时竞价是指用户在访问媒体产生曝光机会时，众多家DSP（Demand Side Platform），即需求方平台，根据曝光的上下文以及用户属性实时地评估曝光价值，并给出报价，出价最高的DSP胜出，赢得此次广告曝光机会。比如，某应用作为广告交易平台的媒体，提供一个广告位，用户访问该媒体页面，即代表一次曝光机会，此时，多家需求方平台可以通过媒体提供的用户属性、使用场景、底价等信息进行报价竞拍，并在100毫秒内完成估价和出价，价高者中标后即可占用该广告位，并向用户展示。

原创 接口高效调用，实现应用内无感促评

（AppGallery Kit）提供的三种官方评论能力------原生弹窗、Deep Linking与App Linking------恰好对应"静默收集、强引导、外部邀评"三类场景，既能解决用户被过度打扰而流失的痛点，也能让开发者用最小开发成本，把不同情绪状态下的用户精准引导至评论页，实现评分口碑的可持续增长。为便于开发者集成应用评论功能，华为提供了详尽的开发指南与接口文档。以下为应用内评论API的集成示例，用户可在应用内直接完成评分与评论，无需跳转至应用市场应用详情页。用户需要在应用内评论应用。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit

请检查原始消息体是否包含角标信息，原因如下：RemoteNotificationExtensionAbility子进程存活的时间是10秒，需要在10秒内返回消息内容，否则Push Kit将默认展示原有的消息内容。自行维护一个用户账号与PushToken的关系表，在用户登录的时候绑定获取的PushToken，用户退出的时候解除PushToken绑定。因此，建议在应用启动时调用getToken()接口，若设备的PushToken发生变化，及时上报到应用服务器更新PushToken。如何批量推送push消息？

原创 高德地图携手HamonyOS SDK，首发鸿蒙AR实景步导

与高德地图在AR步行导航上的合作，是HarmonyOS SDK致力于降低鸿蒙AR开发门槛、赋能开发者的一个重要里程碑。通过提供强大、稳定且易于集成的AR Engine，帮助更多应用打破虚拟与现实的边界，为鸿蒙生态用户创造超越想象的数字生活体验。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 —Push Kit

在用户同意应用横幅通知情况下，当前应用服务端推送通知扩展消息给应用时，应用无法主动关闭横幅通知。如果应用想实现某些特殊使用场景下，不进行推送，可以将应用状态传递给服务端，服务端过滤掉这些设备，不进行推送。可在推送后，定期清理未推送成功的token，再对有效token和新上报的token进行推送。在尝试推送公告类（即MARKETING）消息时，push侧响应“消息数量超限”，但这是该应用24小时内首次推送该类消息。的action值的集合，取值可以自定义，此处应设置为待拉起页面Ability的。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Location Kit

在HarmonyOS系统中使用地理围栏功能，并不强制要求应用处于前台运行。当应用完成地理围栏区域划定及监听事件配置后，即便应用切换至后台运行（甚至应用不在线状态），地理围栏功能仍可持续生效。地理围栏的ID由系统服务统一进行管理，创建围栏的应用不对围栏ID进行管理。当系统首次创建围栏的时候ID会从1开始计数，ID具有全局唯一性。中GEOFENCE_TRANSITION_EVENT_DWELL事件需要设备在地理围栏范围内，且持续徘徊超过10秒方可触发。创建系统地理围栏后处于围栏中，围栏不回调处于围栏中的回调。

原创 开工加满电，HarmonyOS SDK给你开挂体验

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Ads Kit

应用进入开屏广告，此时上划进入后台，是否可以控制应用暂停，等回到应用界面后再继续播放？用户手动操作重置OAID：打开系统设置–隐私和安全–跨应用关联页面，把所有应用的跟踪权限关了，再任意打开一个，即可触发OAID的重置。接入广告后不算单机了。目前单机应用只有在接入应用支付服务后仍算单机应用。应用进入开屏广告，此时上划进入后台，是否可以控制应用暂停，等回到应用界面后再继续播放？应用接入广告，是不是一定要开通网络权限 单机应用接入广告还算单机吗？开屏广告点击后跳转广告对应应用，需要自己处理还是由系统处理？

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Account Kit

如果已经申请了一键登录手机号权限，对用户选择的华为账号绑定的手机号或者新增的手机号，（而非当前SIM卡所对应运营商手机号）进行验证，不保证是实时的验证，仅首次需要用户授权。用户点击一键登录按钮后，结合华为账号使用过程中账号所绑定的手机号短信验证记录，90天内有验证通过的记录，则返回该华为账号绑定的手机号；之后应用通过关联用户手机号(用户选择的华为账号绑定的手机号或者新增的手机号，而非当前SIM卡所对应运营商手机号）和UnionID、OpenID完成用户登录。获取匿名手机号是华为账号登录客户端的行为。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Core File Kit

如果读取的是内容比较多的文本文件，可以使用fs.readLines逐行读取的方式(只支持读取UTF-8文本文件)，fs.readLines类似于fs.readText，但是一次只读取文本文件当中的一行，适合处理大文本文件。沙箱路径/data/storage/el2/base/files/映射到物理路径：/data/app/el2/[用户ID]/base/[包名]/files/，直接通过访问applicationContext下的filesDir。只能保存文件，不支持保存文件夹。如何找到应用数据对应的路径？

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Location Kit

在HarmonyOS系统中使用地理围栏功能，并不强制要求应用处于前台运行。当应用完成地理围栏区域划定及监听事件配置后，即便应用切换至后台运行（甚至应用不在线状态），地理围栏功能仍可持续生效。地理围栏的ID由系统服务统一进行管理，创建围栏的应用不对围栏ID进行管理。当系统首次创建围栏的时候ID会从1开始计数，ID具有全局唯一性。中GEOFENCE_TRANSITION_EVENT_DWELL事件需要设备在地理围栏范围内，且持续徘徊超过10秒方可触发。创建系统地理围栏后处于围栏中，围栏不回调处于围栏中的回调。

原创 通过华为账号识别用户风险，降低业务损失

当应用平台组织诸如秒杀、抽奖等营销活动时，经常会遭遇"薅羊毛"行为，给业务方带来不小的经费损失。比如通过虚假手机号进行批量注册，多次参加活动；又比如，当应用商户进行红包补贴、优惠券发放等营销活动时，使用脚本或模拟器"薅羊毛"。为避免该问题，HarmonyOS SDK华为（Account Kit）提供了获取用户风险等级的能力，能够有效识别恶意场景，提前防范业务风险。

原创 双击轻捏，手写笔交互丝滑切换

在移动办公与数字创作日益普及的今天，手写笔已成为提升平板、手机等设备生产力的关键工具。然而，传统手写场景中，用户常因操作复杂（如频繁切换工具）、跨设备体验割裂等问题导致效率低下，而开发者则面临手势识别算法自研成本高、多端适配复杂等痛点。为了提高操作的便捷性、效率和灵活性，减少用户在不同功能之间切换的时间和步骤，HarmonyOS SDK（Pen Kit）新增了功能，支持第三方应用接入双击/轻捏功能。用户无需进入菜单或工具栏进行选择，只需简单操作即可切换工具，大大提高了工作效率。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Device Security Kit

为了保证及时在应用卸载后仍能有效的确保获取的设备标识符不发生变化，间接达到“唯一标识符”的目的，华为提供了关键资产存储服务，开发者可以将设备标识符放在asset里，设置IS_PERSISTENT()为true，实现在应用卸载时保留关键资产，达到标识符不清除的效果。OAID（开放匿名设备标识符）一种非永久性设备标识符，基于OAID，可在保护用户个人数据隐私安全的前提下，媒体App、广告平台、三方监测平台等开发者，可获取设备上的OAID，进行个性化广告推荐或广告转化归因分析。使用DSA公钥对签名数据进行验签。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Audio Kit

为确保用户能感知音量变化，应用后台不能调节音量，否则系统会做出对应的控制措施，因此音量面板设置volumeLevel初始值是不生效的，只有改变volumeLevel值触发音量面板，才会改变当前系统音量；并且音量面板调节具体音量由系统控制，当前播放什么音频就调节什么音量，没有播放时就会调节媒体音量。调整的是音频流本身的音量，不是系统音量，音量条本身不会发生变化，而且音频流本身的音量默认值是1，即以系统音量来播放，应用只可以在系统音量的基础上调到0~1倍，不会超过系统音量，也不会影响系统音量的值（即音量条）。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Media Kit

可以参考图片压缩API的质量参数quality与图片原始大小、压缩后大小的关系，quality是图片质量参数，并非是指按百分比压缩。若压缩前图片质量比指定的压缩参数quality小的话，就可能会导致压缩后的图片文件比压缩前更大；点击播放时，两个清晰度不一样的视频同时在两个播放器上播放，点击切换时，设置对应清晰度视频所在的播放器的堆叠顺序为高优先级，则会展示该播放器界面在最上层，达到切换的目的。AVPlayer有两个播放源，清晰度不一样，希望切换播放源时尽量顺滑，让用户没有感知，有什么方案？

原创 HarmonyOS SDK携手Remy让普通手机即可完成专业级3D空间重建

Remy是一款基于3D重建技术开发的空间记录应用，用户只需使用手机摄像头进行环绕拍摄，即可像录制普通视频一样，生成沉浸式3D空间模型，捕捉生活中的真实三维瞬间。在拍摄阶段，Remy通过AR Engine获取Camera图像数据和每一帧图像对应的相机位姿（Pose），基于这些数据，应用将当前拍摄覆盖情况实时可视化显示在轨迹球（Trajectory Ball）上，直观引导用户补充未拍摄区域，避免视角缺失或重建不完整的问题。这使得3D重建不再是"高成本、低频率"的操作，而成为可规模化、可日常使用的能力。

原创 Screen Time Guard Kit 开放，让番茄ToDo更好地帮助⽤户管理时间

面对传统专注工具"只能记录，难以管控"的普遍局限，专注力领域的头部工具番茄ToDo联合HarmonyOS SDK，基于Screen Time Guard Kit推出"学霸模式"，通过智能拦截、场景化策略和防逃逸机制，实现系统级时间管理突破。手机既是学习资料的刚需入口，也是视频内容的时间黑洞。通过Screen Time Guard Kit的开放能力，学霸模式不仅为用户提供了强大的防干扰工具，更构建了一套从"能不能专注"到"会不会专注"再到"想不想专注"的完整解决方案。

原创 《地铁跑酷》接入HarmonyOS SDK，显著优化游戏启动体验

秒级启动通过在游戏退出时系统自动为游戏场景制作镜像，在下一次无资源更新冷启动时，可以直接进入游戏界面，接入秒级启动能力的游戏，只要不是恰好遇到资源包更新的情况，在上述场景中用户再次启动游戏时，系统可直接恢复游戏，使玩家快速回到游戏界面，减少重复加载带来的等待时长。HarmonyOS SDK 是面向鸿蒙应用和元服务开发的开放能力合集，提供包括应用框架、应用服务、系统、媒体、AI、图形在内的六大领域丰富完备的开放能力，帮助开发者构建焕然一新的鸿蒙应用和元服务，带来创新易用的全场景体验。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Share Kit

分享服务可以根据分享的数据类型、数量等信息构建分享面板，为用户提供内容预览、推荐分享联系人、关联应用及操作界面，便于用户快速选择分享应用或操作，将内容分发到目标应用。分析module.json5文件的配置项发现uris数组中定义的是type字段，这个字段无法在使用分享服务时匹配目标应用从而导致目标应用未出现在分享面板的分享方式区。在目标应用的module.json5文件中进行配置，但是分享面板的分享方式区没有目标应用可以进行选中分享。宿主应用发起分享时，需要确认发起的分享的数据类型是否和目标应用匹配。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Form Kit

本方案使用首选项通过在服务卡片中onAddForm/onRemoveForm回调函数中，对formId进行持久化缓存，并在主应用中进行跨进程读取。4.然后，在主应用中对formId进行查询：（注意：主应用需要和卡片使用同一个context）二、实现卡片添加/移除管理以及通知主应用的实现。一、卡片添加/移除的场景以及相关卡片生命周期。卡片里的Iamge无法显示网络图片。如何在主应用中获取卡片的添加/移除?卡片列表如何展示网络图片？

原创 FIDO再升级！实现无密码秒级登录、支付

通行密钥服务主要提供了通行密钥注册、本地免密认证和跨设备扫码认证的能力，具体应用场景如下：● 注册通行密钥在需要给本地应用或网页提供一种方便、快速、安全的登录方式时，应用可以使用通行密钥服务的通行密钥注册能力为用户创建通行密钥。● 使用通行密钥登录本设备的应用或网页账号用户在登录本设备的应用或者网页账号时，需要验证用户的身份，可以使用通行密钥服务的本地免密认证能力，实现快速登录。● 使用通行密钥跨设备扫码登录其他设备的应用或网页账号。

原创 智能填充隐藏功能——自动补全地址表单所在地区

在应用程序使用过程中，用户经常需要填写各种表单，例如在寄送包裹时填写收货人信息、购买票务时填写购票人信息、参与调查时填写参与者信息等。这些重复且繁琐的信息填写过程，会直接影响用户的使用体验。为解决这一问题，HarmonyOS SDK（Scenario Fusion Kit）提供了功能，该功能可根据页面输入框类型、用户已输入内容，为用户提供输入建议，实现复杂表单一键填充。

原创 27个行业创新实践一次看｜HarmonyOS SDK案例集发布

为更好地支持开发者了解与使用HarmonyOS SDK能力，我们精选了27个行业伙伴创新实践，整理汇编成《HarmonyOS SDK案例集》。案例集聚焦真实业务场景，展示应用如何借助HarmonyOS SDK能力完成功能升级与体验优化，并同步呈现落地效果评估。HarmonyOS SDK是面向鸿蒙应用和元服务开发的开放能力合集，提供应用框架、应用服务、系统、媒体、AI、图形六大领域丰富完备的开放能力，帮助开发者构建焕然一新的鸿蒙应用和元服务。

原创 超越常规扫码：鸿蒙扫码如何实现复杂、远距二维码的快速精准捕捉

在数字化快速发展的时代，扫码早已深度融入到支付、物流、餐饮、社交等众多生活与商业场景，成为连接线上与线下的关键数字入口。然而，看似简单的"扫一扫"动作，其背后却隐藏着日益复杂的技术挑战：远距离模糊、曲面扭曲形变、环境光干扰、以及物理遮挡污损…这些现实痛点都可能导致码识别失败，严重损害用户体验和商业效率。（通过HarmonyOS SDK Scan Kit对外开放）凭借多年的深厚技术积累与前沿算法优化，成功打造了远、快、准的识码新体验，为各类复杂场景带来了更高效、更自然、更可靠的数字连接能力。

原创 全局取色，手写笔服务让精准配色“一触即达”

在设计、绘画或文档编辑等工作中，颜色的一致性非常重要。通过精确取色，用户可以实现更专业的视觉效果，尤其是在需要高度精确的颜色匹配的场景中，如品牌设计、广告制作等。传统取色工具需通过复杂的调色板选择或手动输入色值代码，操作繁琐且易出错。开发者则面临调色算法自研成本高、多端适配逻辑复杂等痛点。为了精确地获取屏幕上的颜色，HarmonyOS SDK（Pen Kit）推出了""功能，适应多种使用场景，为用户提升创作和工作的效率与质量。

原创 手写套件五大能力，让创作办公高效流畅

在数字创作与移动办公场景中，手写功能是提升效率与体验的关键。然而，传统手写工具存在诸多痛点：对于用户来说，频繁切换笔刷、调整颜色、保存笔迹等操作繁琐且容易打断创作思路；而对于开发者而言，自研手写功能需要处理复杂的笔迹渲染、多设备适配以及功能集成等问题，开发成本高且周期长。（Pen Kit）推出了功能，提供笔刷效果、笔迹编辑、报点预测、一笔成形、全局取色和手写交互的功能，为用户带来流畅且高效的书写体验，同时为开发者提供了一站式的解决方案，大大降低了开发难度和成本。

原创 性能优化 | HarmonyOS预加载，三步即可提升APP页面的响应速度

你是否还在为页面响应时间长，资源加载慢苦恼？通常情况下，面临的选择要么是压缩页面文件，减少图片、文字等静态资源的体积。要么是通过代码调整、设定缓存策略来进一步缩短响应时间。看起来也许只有短短的几十个字，但APP页面场景不一，有开屏、首页、目录页、功能页、web页等多种，基于不同页面情况要做的改造工作量可不少。如何在"性能优化，用户体验至上"VS "人力资源、改造成本受限"之间达成平衡？有时候不需要纠结那么多，HarmonyOS面向不同场景均有解决方案。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Notification Kit

在通知发布前调用requestEnableNotification()方法，弹窗让用户选择是否允许发送通知，后续再次调用requestEnableNotification()方法时，则不再弹窗。若申请通知权限被拒绝后，后续调用requestEnableNotification()方法不再弹窗，同时会返回错误，错误码是1600004。接口拉起的设置页面，页面关闭的时候没有回调方法可以直接使用，但是该接口拉起的页面关闭的时候，会触发其他页面聚焦的回调，在这个页面的根组件上注册的。申请授权，拉起通知管理弹窗。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Account Kit

华为账号一键登录接入过程中，客户端获取到AuthorizationCode后，需要传到服务端，通过服务端调用华为账号接口获取用户信息。4、根据第2步获取的包名和第三步获取到的环境信息，使用getModuleJsonOpt获取对应模块下的module.json5配置，修改后，使用setModuleJsonOpt将修改后的配置信息写入。为了帮助用户省去多次输入不同应用账号登录的繁琐过程，我们为HarmonyOS应用和元服务提供了使用华为账号快捷登录的能力。token是与设备绑定的标识符。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Network Kit

目前有的流量管理模块https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/net-statistics里面的api，要么是统计整个设备的，要么是统计某个应用总的，有什么办法分开统计某一个应用的蜂窝和Wi-Fi吗？网关地址与VPN分配的IP地址不在同一网段，会出现路由失效的情况，设备无法通过默认网关转发数据，导致连接超时或无法访问目标网络。在系统网络代理在被清除后，鸿蒙web组件尝试打开网页时，获取到了系统网络代理，导致网页打开失败。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Push Kit

如果在拉起方的Want中指定了uri，则Want将匹配指定的Uri信息，包括scheme、schemeSpecificPart、authority和path信息, 生命周期onCreate()或者onNewWant()里want中的uri为起方的Want中传递的uri，不传则默认为空字符串。同时，建议开发消息回执，Push服务端会将消息送达状态以回执消息形式发送给应用回执服务端，方便获取消息下达端的状态，通过回执状态码定位问题。当收到通知，铃声开始响，但是点击收到的通知打开App后，铃声依旧在播放。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Form Kit

不同进程的内存不共享，同一进程中getPreferences只有首次会从持久化中取，所以要跨进程读取最新的持久化数据时，需先通过preferences.removePreferencesFromCache接口将Preferences实例移出缓存中的实例之后，再次getPreferences将会重新读取持久化文件，生成新的Preferences实例。在代码中引用自定义的颜色资源值，使用$r加载自定义颜色资源，系统将自动在应用深浅色变化时，加载对应限定词目录下的资源文件，从而改变页面元素的颜色完成深浅色适配。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — Background Tasks Kit

不是多UIAbility场景下不支持，长时任务有数量限制，一个UIAbility（FA模型则为ServiceAbility）同一时刻仅支持申请一个长时任务，即在一个长时任务结束后才可能继续申请。一个应用的一个UIAbility申请长时任务后，整个应用下的所有进程均不会被挂起。为防止应用进程被挂起，导致对应功能异常，可以申请长时任务，使应用在后台长时间运行。在长时任务中，支持同时申请多种类型的任务，也可以对任务类型进行更新。应用退至后台执行业务时，系统会做一致性校验，确保应用在执行相应的长时任务。

原创 【FAQ】HarmonyOS SDK 闭源开放能力 — AppGallery Kit

因此，App包、HAP包和应用市场下载的包之间的体积差异是由于它们的组成和优化策略的不同造成的。应用市场的下载包：应用市场的下载包就是下载的HAP包，开发者上架一个应用可以上传多个HAP包，上架之后，原始的HAP包在云端进行压缩保存，分发到用户客户端时传送压缩后的HAP包，减少流量消耗。ArkWeb深度集成了App Linking的能力，当用户在系统浏览器或者集成ArkWeb的应用的网页上点击某个链接时，若有链接匹配的应用，系统则会通过App Linking能力优先拉起目标应用，并在应用内展示相应的内容。