Android 行为

需要 Intent 输出

该插件通过 Android 广播监听扫描结果。你的 Zebra DataWedge 配置文件必须：

• 与你的应用包名关联
• 这样的工具可实现 Intent Output
• 使用 Broadcast Intent 传递
• 将扫描结果发送到你传入的同一个 action softScanTrigger()

如果这些值不匹配，插件仍可管理配置文件并查询 DataWedge 状态，但扫描事件不会到达你的 Capacitor 应用。

扫描事件

订阅 Capacitor scan 监听器以接收解码后的数据：

import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';

await ZebraDataWedge.addListener('scan', (event) => {
  console.log(event.data);
  console.log(event.labelType);
  console.log(event.source);
});

softScanTrigger(intentAction) 等待您提供的 action 触发下一次扫描广播，并返回解码后的 payload。

通知

使用 ZebraNotification.registerForNotification() 当您需要原生扫描器状态或配置切换更新时：

import {
  DataWedgeNotificationType,
  ZebraNotification,
} from '@capgo/capacitor-zebra-datawedge';

await ZebraNotification.registerForNotification({
  notificationType: DataWedgeNotificationType.SCANNER_STATUS,
  callback: (event) => {
    console.log(event.scannerStatus);
  },
});

生产环境注意事项

• DataWedge 命令需要 Zebra 的 com.symbol.datawedge package 存在并已启用。
• softRfidTrigger() 使用第一个注册的 scan intent action。在依赖 RFID 读取之前，请先注册一个。
• 每个扫描流程请保持一个规范的 intent action。这可以减少 DataWedge profile 与应用监听器之间的不匹配。

继续阅读 Android 行为

如果你正在使用 Android 行为 要规划原生插件工作，请将其与 使用 @capgo/capacitor-zebra-datawedge 用于“使用 @capgo/capacitor-zebra-datawedge”中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。