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

原创 差异化推送消息能力，助力支付宝腕上消息业务闭环

作为华为生态中的首批标杆应用，支付宝早在2017年就推出了手表支付功能，用户无需掏出手机，即可通过手表完成支付。随着碰支付功能的加入，腕上支付场景变得更加便捷。然而，大多数用户仍习惯使用手机进行支付，尽管支付宝在手表穿戴场景中提供了大量优惠活动，但如何让用户即时感知这些活动并主动使用，依然是一个难题。针对这一场景，HarmonyOS SDK（Push Kit）新增了对Wearable设备的支持。在手表有网络连接且独立使用的场景下，推送服务可直接从云端将消息推送到手表端。

原创 借助游戏预启动提前加载游戏，读条快人一步

互联网游戏已成为大众调节枯燥生活的重要娱乐方式，其即时满足的娱乐属性能够让玩家快速沉浸其中，然而，玩家在启动大部分游戏时，常面临漫长的加载等待，被迫承受多重焦虑，若中途因来电、通知等被打断，更需重新排队加载。耐心耗尽下，不少玩家在启动过程中便选择退出，直接导致游戏应用流失大量玩家。

原创 Account Kit新能力：AI赋能Skill接入“华为账号一键登录”，实现6倍效率飞跃

当前，华为账号已融入生活的方方面面——无论是外卖点餐、购物支付，还是日常出行，只需一键登录即可享受无缝体验。截至目前，华为账号一键登录已实现5000+应用接入，凭借无门槛的体验服务了5200万+用户，累计完成4亿+次一键登录，让便捷登录真正成为生活的自然延伸。随着华为账号一键登录在越来越多场景中普及，如何让更多开发者高效集成这一功能，成为持续优化体验的关键一环。Account Kit 推出了一项全新的 AI 能力——“华为账号一键登录 Skill”。

原创 一次开发，多端高效协同：解码HarmonyOS SDK窗口的响应式设计哲学

在移动应用生态日益碎片化的今天，用户对“无缝、智能、高效”的交互体验提出了前所未有的高要求。从手机到折叠屏，从平板到PC，设备形态的多样化本应带来体验升级，却也给开发者带来了巨大的适配挑战——如何在不同尺寸、不同形态的屏幕上，既保证功能完整，又实现体验一致？如何让服务真正“随人而动”，而非“被设备所困”？HarmonyOS SDK以“一次开发，多端部署”为核心理念，构建了一套系统级的窗口能力体系，涵盖实况窗、闪控窗和多窗协同三大关键能力。这不仅是UI层面的创新，更是一场关于效率重构与体验升维的技术革命。

原创 HarmonyOS SDK 26发布，持续提升鸿蒙应用开发体验与效率

华为开发者大会2026期间，HarmonyOS SDK分论坛展示了最新创新特性与行业实践。作为鸿蒙生态的关键技术底座，SDK在AI、媒体等六大领域持续开放，以更完备的能力集支撑开发者创新，并同步呈现了API优化演进的最新成果。随着鸿蒙生态的稳步发展，鸿蒙终端设备数已突破6600万，HarmonyOS SDK通过开放超过100个Kit，8万多API接口，让1100万+开发者，为用户带来40万+独特好用的鸿蒙生态体验。

原创 应用内隐私信息被窥视？防窥保护自动感知一键防护

面对这一痛点，HarmonyOS SDK（Device Security Kit）提供了机主查看相册，当有非机主偷窥时，拉起系统蒙层遮盖窗口那么，应用内如何能够实现防窥保护功能呢？

原创 鸿蒙生态伙伴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。接口拉起的设置页面，页面关闭的时候没有回调方法可以直接使用，但是该接口拉起的页面关闭的时候，会触发其他页面聚焦的回调，在这个页面的根组件上注册的。申请授权，拉起通知管理弹窗。