跳到主要内容

HAP 移动端硬件接入使用指南

功能概述​

HAP 移动端提供扫码、蓝牙打印等硬件能力，可在仓储、生产制造、零售等移动操作场景中实现快速录入数据、打印标签或票据。本指南将帮助你在HAP APP 中完成扫码与蓝牙打印的配置与使用。

支持能力包含：

  • 手持PDA
  • PDA 扫码头/摄像头扫码
  • 蓝牙打印（支持指令集CPCL、TSPL）

一．手持 PDA​

手持 PDA 是移动端业务场景中最常见的工业设备，常用于仓储、制造、物流、零售巡检等需要高频扫码与数据录入的场景。

1.1 支持能力​

手持 PDA 在 HAP 移动端可实现以下能力：

  • 扫码自动输入表单字段：可将扫码结果直接写入文本字段、条码字段。
  • 连续扫码：适合多码录入，如盘点、入库、巡检批量扫描。
  • 快捷键触发操作：支持通过硬件按键执行业务动作（如调用封装业务流程、快速新建记录、打开扫码等）。
  • 系统级硬件调用：可调用 PDA 原生扫码服务，速度与准确率优于摄像头扫码。

1.2 设备概述​

当前主流手持 PDA 广泛采用 Android 系统，并通常具备以下硬件特性：

  • 工业级扫描头：支持一维码、二维码等快速扫码能力。
  • 实体按键：包含扫描键、功能键（F1/F2 等）、音量键，可自定义映射为业务热键。
  • 网络能力：支持 4G/5G、Wi-Fi，适合移动作业环境。
  • 坚固可靠的工业外壳：满足防摔、防尘、防水要求（IP65–IP67）。

1.3 系统限制与注意事项​

HAP 移动端应用支持两类 PDA 接入模式，分别是浏览器模式（H5）与APP。

APP系统版本支持Android5＋，支持扫码服务，APP 支持硬件按键触发业务动作。

APP与浏览器模式功能对比：

项目H5 浏览器模式APP
激光扫码自动输入焦点原生调用，性能更佳，可配置连续扫码
连续扫码不支持原生支持，可配置连续扫码
快捷键映射不支持支持
后台运行可能被系统清理可能被系统清理
权限控制浏览器需授予摄像头/存储等权限需授予摄像头/存储等权限

二．PDA 专用设备（红外扫码）​

红外扫码模块通常集成在工业 PDA 或专用扫描枪中，通过硬件激光头实现高速识别，是移动端业务中最常见的硬件输入方式。

核心能力包括：

  • 高速解码：扫码速度通常在 30 - 100ms 之间，远高于摄像头扫码。
  • 多码制支持：支持一维码（EAN-13、Code128 等）及二维码（QR、DM、PDF417 等）。
  • 高容错能力：可识别皱折、模糊、反光等较难识别的条码。
  • 远距离扫描：部分设备可以支持 30cm–150cm 距离扫描。
  • 系统级输入方式：解码后通常以“输入法”方式将扫码内容写入焦点输入框。

接入方式: HAP 移动端应用支持两类 PDA 接入模式，分别是浏览器模式（H5）与APP。可与企业现有终端环境兼容。

2.1 浏览器模式（H5 模式）​

适用于无需定制 App 的部署方式，直接通过PDA中第三方浏览器访问明道云 H5。

工作原理： PDA 扫码服务通常会将扫码结果自动写入当前焦点输入框，因此 H5 表单无需额外适配即可接收数据。

特点：

  • 无需安装应用，接入门槛低

  • 适合低成本快速部署

2.1 APP 模式​

适用于企业已有自研 App 或 HAP 私有部署 App 版本。

工作方式：

  • 原生开发的功能对接
  • App 通过 JSSDK注入扫码事件
  • 由 App 统一管理硬件资源
  • 启用步骤：APP扫码页面点击右上角设置图标，打开“启用专用扫码装置”

优势：

  • 可深度调用系统级 API
  • 能实现更稳定的扫码性能
  • 连续扫码

三．PDA快捷键设置​

PDA 常配备左右物理扫描键、功能键（F1/F2）、顶部按键等。通过按键映射，可将硬件按键触发明道云中的特定动作，从而实现“按键即操作”的高效体验。

本文以iData机型为例，将以实际配置过程说明功能性。

3.1 快捷键触发逻辑​

PDA 硬件按键通常有两种触发方式：按键启动应用、按键触发广播。

  • 按键启动应用： PDA 支持设置按钮启动应用，并携带参数，APP 接收参数后，执行后续事件。

  • 按键触发广播： 工业 PDA支持按键触发广播，由 APP 接收后，执行后续事件。

3.2 键值映射步骤​

PDA 提供的“按键映射工具”允许将一个硬件按键映射到指定 Action（动作）与参数。

具体映射步骤如下(iData机型为例)：

  1. APP 内找到要触发的按钮，并复制按钮 ID

  2. PDA中新建一个快捷按钮与明道云的按钮进行绑定

  3. 适配低版本 Android系统方案

    按键设置中配置发送广播模式，广播 action的值为：com.mingdao.PDA_Btn_Click_Action

    添加广播参数：键（key）填写 “key”，值（value）填写从 APP 内复制的按钮 ID。

  4. 解决高版本Android系统方案

    Android系统上由于禁止App后台启动 Activity，高版本系统配置低版本方案后，App放置后台按键则无法唤起。

    解决方案：按键配置启动应用模式.

    添加启动应用参数：键（key）填写 “key”，值（value）填写按钮 ID。

  5. 使用时需要先打开 APP 进行广播注册，打开后 APP 放置后台即可

3.3 注意事项​

  • 支持硬件按键映射到 APP 内按钮
  • 支持通过广播触发（高版本机型可能不支持广播唤起，可尝试使用启动应用方式）
  • Action 必须设置为 com.mingdao.PDA_Btn_Click_Action
  • 参数 key 为HAP 按钮 ID
  • APP 必须先打开以完成广播注册
  • APP 放后台后即可正常使用

四．蓝牙打印机​

蓝牙打印能力仅在 HAP APP 中使用，通过 APP 调用终端内置蓝牙模块与打印机建立 SPP（串口协议）连接。H5 页面本身不具备蓝牙通信能力，打印能力由 APP 通过 JSBridge 接管完成。

4.1支持类型​

当前 APP 支持两类主流指令集：CPCL 与 TSPL，可覆盖绝大多数便携式标签打印机。

4.2 HAP APP 中蓝牙打印调用流程（CPCL / TSPL）​

  1. 配置模版

    在 HAP 内根据业务需求配置打印模板。目前蓝牙仅支持条码、二维码打印模版。

    模板通常包含：

    • 标签尺寸
    • 文本布局
    • 条码 / 二维码
    • 变量占位符（如：产品名称、批次号、库位号）

  2. APP端中选择模版

  3. 选择并搜索蓝牙打印机

  4. 点击打印后，实体打印机打印输出文件