篇目主题核心内容第一篇概述与开发准备Scan Kit 概念、架构、13种码制式、开发准备第二篇扫码直达服务App Linking 配置、URI 解析、冷热启动处理第三篇默认界面扫码一行代码接入、ScanOptions 配置、多码识别第四篇自定义界面扫码XComponent 渲染、相机控制、动画效果第五篇图像识码与码图生成decode/decodeImage、文本/字节数组生成第六篇高级应用与最佳实

图像识码是 Scan Kit 提供的离线扫码能力，支持对图库中的码图或图像数据进行扫描识别。本地图片识别decode接口）：通过图片路径（URI）输入，识别图片中的码图图像数据识别接口）：通过字节数组（NV21 格式）输入，识别图像数据中的码图码图生成是 Scan Kit 提供的码图创建能力，支持通过文本或字节数组生成码图。目前已支持 13 种码制式（QR Code、Data Matrix、PDF

自定义界面扫码是 Scan Kit 提供的高级扫码能力，开放了相机流控制接口。通过XComponent组件渲染相机预览流自定义扫码界面的视觉风格（颜色、形状、动画）控制相机参数（闪光灯、变焦、对焦）获取每帧 YUV 数据（适合扫码 + 识物综合场景）实现自定义的多码交互逻辑对比维度默认界面扫码自定义界面扫码接入方式一行代码需要完整实现 UI 和交互UI 风格系统统一风格完全自定义相机权限系统预授权

默认界面扫码是 Scan Kit 提供的一种开箱即用的扫码能力，提供与系统体验一致的扫码界面。开发者无需实现任何 UI 代码，直接调用接口即可启动系统扫码界面，扫码完成后自动返回结果。相机预览流：实时显示相机画面，提供流畅的扫码体验相册扫码入口：用户可以从相册选择图片进行扫码识别暗光环境闪光灯提示：在光线不足时自动提示用户开启闪光灯多码识别：支持同时识别画面中的多个码图，用户可选择目标码单码识别：

扫码直达是一种系统级扫码路由服务。开发者将域名注册到扫码直达服务后，用户可通过控制中心等系统级常驻入口扫描应用的二维码或条形码，系统会自动解析码值并直接跳转到应用对应服务页，无需用户手动打开应用。开发者完成域名注册和 App Linking 配置用户通过 HarmonyOS 系统扫码入口发起扫码请求系统调用底层能力解析码值，查询码值对应的应用信息系统自动拉起目标应用，跳转到指定服务页面扫码直达从用

Scan Kit（统一扫码服务）是华为软硬协同的系统级扫码服务，帮助开发者的应用快速构建面向各种场景的码图识别和生成能力，以及扫码直达能力。Scan Kit 应用了多项计算机视觉技术和AI算法技术，不仅实现了远距离自动扫码，同时还针对多种复杂扫码场景（如暗光、污损、模糊、小角度、曲面码等）做了识别优化，提升扫码成功率与用户体验。Scan Kit 的核心设计理念是系统级能力开放，即开发者无需在应用中

防窥保护（dlpAntiPeep）与DLP（Data Loss Prevention，数据防泄漏）维度防窥保护（dlpAntiPeep）DLP 数据防泄漏防护层面物理空间（屏幕窥视）数据层面（文件加密、权限控制）感知方式前置摄像头实时感知文件标签、权限策略响应方式隐藏 UI、拉起蒙层加密分享、访问控制所属 Kit优先级应用类型推荐接入方式防窥策略P0金融类（银行、证券、支付）全量接入敏感数字隐藏

工具类封装统一管理能力检测、状态查询、监听注册和蒙层控制系统蒙层拉起系统级半透明蒙层，每次进入页面只触发一次金融场景完整实战：账户总资产、收益明细、持仓明细的敏感信息隐藏与恢复实况窗提醒发布系统级提醒，控制发布频率权限管理：ACL 权限申请流程，module.json5 配置与权限说明文案生命周期管理：页面可见性控制、防窥保护初始化/销毁的完整状态机防窥保护是 HarmonyOS 安全体系从"系统

防窥保护（dlpAntiPeep）是 HarmonyOS Device Security Kit 提供的物理空间安全防护能力。它通过前置摄像头实时分析屏幕前的人员情况，智能判断是否存在非机主人员窥视屏幕，并将结果以标准 API 形式通知应用。维度说明所属 KitDevice Security Kit（设备安全服务）系统能力起始版本核心模块感知方式前置摄像头实时人脸检测处理位置设备端完成，不泄露用户

首眼沉浸光感：通过标题栏+ 底部导航+ 菜单栏，打造精致的第一印象自适应悬浮导航：MiniBar 折叠展开 + 多设备断点适配，实现从手机到平板的全场景覆盖智感握姿联动：沉浸光感材质 + 智感握姿跟随 + 折叠屏状态感知，三重联动实现顶级空间化体验沉浸光感代表了 HarmonyOS 在空间化视觉设计上的新思考——它不仅仅是"让界面更好看"，而是从底层重构了 UI 的视觉表达方式。通透的视觉层次：毛