Imported from IsKenKenYa/skills (skills/harmonyos/development/media/scan-kit/hmos-scan-kit-defaultscan/SKILL.md). Install upstream with npx skills add IsKenKenYa/skills --skill hmos-scan-kit-defaultscan. Copyright stays with the author.

Scan Kit - 默认扫码 Skill

功能定位

帮助开发者快速接入华为 Scan Kit 的默认界面扫码功能，无需申请相机权限，一行代码即可实现扫码。

注意：

• 本技能基于 DevEco Studio 原生Agent插件 CodeGenie 开发，依赖其内置工具进行语法检查和代码编译校验。如果在其他 Agent 工具中使用本技能，可能出现无法自动进行代码验证和编译的情况。
• 本技能需要在项目中已有扫码入口的情况下才能正常工作，若当前项目中没有可用的扫码入口(如空项目)，则退出技能工作流程。

核心能力

工作流程（5 步）

0. 待办事项

使用 todowrite 工具创建包含5项任务的待办事项，在完成每一个步骤之后标记为完成

• 项目状态检测
• 扫码入口判断
• 提取需求信息
• 代码开发
• 代码验证

1. 项目状态检测

自动检测当前项目状态：

注意：默认扫码不需要申请 CAMERA 权限（系统预授权），无需检测权限配置。

2. 扫码入口判断

根据项目状态和用户输入，自动判断扫码入口。若无法判断扫码入口位置或相关组件，则退出工作流程。

需要判断的信息：

判断准则：

• 页面判断：用户指定页面 → 使用用户指定的页面；用户未指定 → 推荐新建扫码页面（因为涉及XComponent全屏相机预览）
• 触发方式：页面上已有扫码相关UI组件（如扫一扫按钮）→ 使用现有组件；否则 → 自行添加按钮

**注意：**若根据项目状态和用户输入，无法判断扫码入口位置或相关组件，则退出工作流程，并提醒用户：本技能需要在已有扫码入口的情况下才能正常工作。

3. 提取需求信息

从用户输入中提取需求信息，未明确提到的使用默认值：

示例：用户说"帮我加个扫码功能" → 所有配置使用默认值

4. 代码开发

根据前面提取的需求信息，直接进行代码开发：

扫码后处理：

• 扫码成功后统一使用 promptAction.showToast({ message: result.originalValue }) 显示扫码结果

开发步骤：

1. 在目标页面集成扫码功能（@kit.ScanKit 是系统级 Kit，无需添加依赖），并在扫码成功后处理部分的注释中标注 TODO: 在此处添加扫码成功后的业务逻辑代码

   • 参考：references/guides/scan-scanbarcode.md
   • 示例：references/samples/defaultScan/DefaultScan.ets
   • 需要用到：触发页面、触发方式

   重要：必须在调用扫码 API 之前检测设备兼容性，防止在不支持扫码的设备（PC、手表等）上调用扫码 API：

    import { scanBarcode, scanCore } from '@kit.ScanKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { PromptAction, UIContext } from '@kit.ArkUI';
   
    @Entry
    @Component
    struct Index {
      // 获取当前组件的UIContext
      private uiContext: UIContext = this.getUIContext();
      // 通过UIContext获取PromptAction对象
      private promptAction: PromptAction = this.uiContext.getPromptAction();
   
      build() {
        // ...
        Button('扫码') // 或其他触发控件
          .onClick(() => {
            // 调用扫码 API 前检测设备能力
            const isScanBarCode = canIUse('SystemCapability.Multimedia.Scan.ScanBarcode');
            if (isScanBarCode) {
              scanBarcode.startScanForResult(this.uiContext.getHostContext()).then((result) => {
                // 扫码成功后显示 Toast
                this.promptAction.openToast({
                  message: result.originalValue,
                  duration: 2000,
                }).catch((error: BusinessError) => {
                  console.error(`openToast error code is ${error.code}, message is ${error.message}`);
                })
                // TODO: 在此处添加扫码成功后的业务逻辑代码
                // ...
              }).catch((error: BusinessError) => {
                // 处理错误
                this.promptAction.openToast({
                  message: '扫码失败: ' + error.message,
                  duration: 2000,
                }).catch((error: BusinessError) => {
                  console.error(`openToast error code is ${error.code}, message is ${error.message}`);
                })
              });
            } else {
              this.promptAction.openToast({
                message: '当前设备不支持默认扫码功能',
                duration: 2000,
              }).catch((error: BusinessError) => {
                console.error(`openToast error code is ${error.code}, message is ${error.message}`);
              })
            }
          })
      }
    }

2. 实现结果处理逻辑

   • 参考：references/api/scan-scanbarcode-api.md
   • 类型定义：references/api/scan-scancore.md
   • 错误码：references/api/scan-error-code.md
   • 取消处理：references/guides/scan-faq-12.md
   • 扫码成功后显示 Toast：promptAction.showToast({ message: result.originalValue })

开发原则：

5. 代码验证

验证新增代码的正确性，并在最终的报告中输出验证结果：

1. 使用 builtin_check_editor_errors 工具检查所有修改或新增的代码文件的语法，如果出现错误，则需要修改直到无语法错误。
2. 使用 builtin_execute_build_command 工具对项目进行完整编译，如果出现错误，则需要修改直到编译通过。

参考资料

完成报告格式

开发完成后，输出：