扫码功能是移动应用连接物理世界的高频入口，无论是支付核销、信息获取还是设备配网，扫码体验的流畅度直接影响用户留存。Scan Kit（统一扫码服务）作为 HarmonyOS SDK 提供的软硬协同的系统级扫码服务，凭借计算机视觉与 AI 算法，实现了远距离自动扫码，并针对暗光、污损、模糊、小角度、曲面码等复杂场景做了识别优化，全面提升了扫码成功率与用户体验。

• 然而，对于开发者而言，接入扫码能力仍然面临不少挑战：默认扫码需要理解系统接口调用时序，自定义扫码更是涉及相机权限申请、相机预览流渲染、闪光灯/变焦控制、资源生命周期管理等一系列复杂工作。从阅读文档、复制示例到调试编译，整个流程耗时且容易出错。

• 图1：Scan Kit 扫码功能运行效果展示

为了解决这一痛点， Scan Kit 扫码开发 Skill（hmos-scan-kit-defaultscan 默认界面扫码、hmos-scan-kit-customscan 自定义界面扫码）正式推出。两套 Skill 依托鸿蒙扫码官方知识库与 AI 大模型能力，自动完成代码生成、权限配置、资源集成与编译验证，将扫码接入流程简化为"一键式"自动化任务，帮助开发者告别手动编码与调试，让鸿蒙扫码接入效率实现质的飞跃。

一、 双 Skill 协同，全场景覆盖

1. 默认扫码 Skill：hmos-scan-kit-defaultscan

适用于通用的 基础扫码场景，无需开发者申请相机权限，一行代码即可唤起系统级统一扫码界面。其特性包括：

• 系统级扫码 UI：使用统一的系统扫码界面，多端体验一致；

• 相机预授权：无需申请 CAMERA 权限，开箱即用；

• 相册扫码：支持从相册选择图片扫码，可禁用；

• 多码识别：支持同时识别多个码，可禁用；

• 种码制：支持 QR 码、条形码等 13 种全球主流码制，可自由组合。

2. 自定义扫码 Skill：hmos-scan-kit-customscan

适用于对扫码界面有个性化定制需求的 高级扫码场景，支持完全自定义相机预览流 UI 界面。其特性包括：

• 自定义 UI 界面：完全自定义扫码框、扫描线动画等界面样式，支持开发者自主修改；

• 闪光灯控制：支持暗光环境下的闪光灯开关；

• 变焦控制：支持手势或按钮控制相机变焦；

• 多码识别：支持同时识别多个码，可禁用；

• 多种码制：支持 QR 码、条形码等 13 种全球主流码制，可自由组合。

二、两步接入，轻松上手

第一步：下载安装

从Matrix广场中【下载 Skill】，放置到 AI 编码工具（如 DevEco Code、OpenCode 等工具）的 Skill 配置目录下。根据您的扫码场景选择对应的 Skill：

两款 Skill 可按需独立安装，也可同时安装以覆盖全部场景。

• 图2：在工程文件目录下 Skill 的存放位置（使用 AI 编程工具 OpenCode）

第二步：触发 Skill

在 AI 编码工具对话中描述您的扫码需求（如"帮我在按钮上加个扫码功能"），或直接输入 Skill 名称触发能力（如"请使用 hmos-scan-kit-defaultscan 帮我接入默认扫码"），AI 将自动为您：

• 默认扫码 Skill：检测项目状态 → 判断扫码入口 → 提取需求 → 生成扫码代码 → 编译验证

• 自定义扫码 Skill：项目准备 → 复制工具类与资源文件 → 实现扫码页面 → 配置权限与路由 → 编译验证

• 图3：触发 Skill 后的交互内容（使用 AI 编程工具 OpenCode）

三、智能开发，提质增效

• Scan Kit 扫码开发 Skill，聚焦开发者核心诉求，从效率、标准、质量三个维度全面优化扫码开发体验：

1. 效率飞跃：AI 自动生成代码，自动参考并复制示例工程中的工具类与资源文件，自动配置权限与路由，告别手动查文档、复制粘贴与调试；

2. 示例优先：所有 Scan Kit API 调用均直接从官方示例代码中复制，避免手动“翻译”或“简化”导致的接口调用错误，确保代码与官方规范一致；

3. 安全可靠：自动处理相机权限申请、资源生命周期管理（init → start → stop → release）以及多端部署兼容性检测（canIUse），有效避免黑屏、内存泄漏、设备不兼容等常见问题。

即刻体验

AI 赋能鸿蒙扫码开发，让手动配置自动化、让复杂接口标准化、让高频需求轻量化。无论您是快速接入通用扫码，还是深度定制个性化扫码界面，两套 Skill 均可帮助您一键解锁鸿蒙扫码能力，助力开发者高效完成功能落地，聚焦业务创新。欢迎各位开发者即刻体验！