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

原创 焕新鸿蒙应用权限管理方案，应用授权体验再升级

作为用户或应用开发者，或许经历过类似的体验场景：使用应用的过程中，触发应用某些功能会需要访问你的位置、麦克风、相机等常用权限，若为了保护隐私拒绝授权后，想要使用功能时，再次打开却找不到设置入口；或开启流程繁琐，需要经过频繁跳转和设置。这一问题不仅影响用户体验，还可能造成应用功能不可用、用户流失，也制约着应用的授权转化与留存表现，是行业普遍存在的体验痛点。

原创 Account Kit 效率提升 ▏自动签名能力上线

自动签名步骤从3步简化为1步，接入效率提升2倍。

原创 从启动到畅玩：HarmonyOS SDK如何重塑一场连续的游戏体验

从ChinaJoy的展示窗口可以看出，HarmonyOS SDK在游戏方面的答卷，并不仅是一系列性能指标的突破，更是一套关于“如何让游戏体验更连续”的系统级回答。通过这种系统级的软硬协同，HarmonyOS正在为游戏开发者提供更具想象力的开发土壤，也为下一代移动游戏生态打开更广阔的想象空间。

原创 从“一屏一态”到“一屏多能”：WPS通过HarmonyOS多窗口能力重塑移动办公体验

多屏协同、自由分屏，正成为移动办公的新常态。面对多样化的设备形态和用户场景，WPS Office与HarmonyOS SDK深度合作，通过全新的窗口管理与响应式布局能力，实现跨设备无缝适配与高效多任务处理。一次开发，多端自适应——这场关于“一屏多用”的体验升级，如何重新定义手机办公？

原创 HarmonyOS SDK API诊断 Skill，一键定位功能故障问题

该能力深度融合 AI大模型与鸿蒙专业知识库，打通全流程自动化排查链路，可智能完成环境探测、日志自动采集、知识库匹配、问题根因追溯，将原本繁琐的问题排查流程简化为“：快速查询模块知识库（错误码含义、API调用链、故障案例），评估诊断置信度，高置信度直接进入项目源码分析，低置信度进入深潜分析。3、体验升级：降低鸿蒙开发门槛，加速问题闭环，结构化报告输出，让人工逐行筛查的传统排障，升级为全自动智能流水线。：输出结构化诊断报告，包含错误码映射、根因候选、源码问题定位、修改建议，可程序化解析，助力快速闭环。

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

这一方案彻底改变了传统手机同步通知模式下，手表端仅能展示纯文本、无法交互跳转的局面，真正打通了消息通知与服务转化的链路，大幅提升腕上支付的使用率和活动转化率。首先，开发者需要先集成推送服务，通过推送服务下发通知到手表端，用户点击消息后，再借助DeepLink拉起应用并跳转至指定页面，即可完成从消息触达到业务处理的完整流程。当手表有网络连接且能够独立使用时，Push Kit可以将重要消息直接推送下发到手表，用户无需打开手机，即可点击消息完成相关业务闭环。从消息查看到进入服务，再到操作完成，形成完整业务闭环。

原创 借助AR Engine人脸识别与跟踪能力，直播不露脸也生动

在通信技术高度发达、短视频与直播全面普及的当下，虚拟形象已成为保护面部隐私的主流手段。部分注重隐私的用户会借助虚拟形象遮挡面部，进行短视频制作或直播互动。然而，现有方案的驱动逻辑仍停留在“预设动画触发”层面，主播的真实动作、姿态变化及情绪起伏无法被实时解析与映射。这种遮挡方式虽保护了隐私，却牺牲了沉浸感与互动性，使主播的真实感大打折扣。为解决这一问题，HarmonyOS SDK（AR Engine）为各类应用提供了人脸识别与跟踪能力。

原创 基于人体骨骼点识别与跟踪，实现低时延体感游戏

早在十余年前，体感游戏已经风靡全球，玩家挥动手柄就能打网球、切水果。然而随着时间的推移，工具依赖式的体感游戏已经无法满足玩家对游戏低时延、高精度的需求。传统体感方案依赖手柄或穿戴设备，动作到屏幕普遍存在反馈延迟，带来强烈的“手眼分离”割裂感，且玩家在每次游戏前都需要携带并校准设备，游戏热情在准备阶段就已消耗大半。为解决该问题，HarmonyOS SDK。

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

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

原创 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再升级！实现无密码秒级登录、支付

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