SimulScan 输入

DataWedge 7.4

概述

Zebra SimulScan 应用程序允许在单一操作中同时获取扫描目标的条码、图像、文本、签名、电话号码和其他数据。SimulScan 输入选项将此功能添加到 DataWedge。根据指定的 SimulScan 模板获取表单数据时，可使用处理插件根据需要处理数据或设置其格式。有关更多信息，请参阅 SimulScan 用户指南。

此功能只能在 支持 SimulScan 的设备上使用。

SimulScan 输入选项

SimulScan 标准模板（未全部显示）

硬件触发器 - 启用/禁用将设备硬件触发器用于 Simulscan 输入。默认情况下，硬件触发器处于启用状态。如果禁用，则在按下硬件触发器时不会显示取景器。但是，仍可使用软扫描触发器 DataWedge API Intent 激活取景器。使用此功能，应用程序编程人员可以在应用程序中扫描条码和文档时强制使用特定于应用程序的功能。


设备选择 - 允许在设备摄像头和系统默认的扫描设备之间进行选择（推荐）。

模板选择 - 为正在配置的配置文件设置 SimulScan 模板。DataWedge 包含的模板：

  • 默认 - BankCheck.xml - 从支票的机器可读取区域 (MRZ) 中获取账号和路由编号。
  • 默认 - Barcode1.xml - 解码任何码制的单个条码。
  • 默认 - Barcode10.xml - 解码相同或不同码制的 10 个条码。
  • 默认 - Barcode2.xml - 解码相同或不同码制的 2 个条码。
  • 默认 - Barcode4.xml - 解码相同或不同码制的 4 个条码。如果选择“无”，则这是默认模板。
  • 默认 - Barcode5.xml - 解码相同或不同码制的 5 个条码。
  • 默认 - BookNumber.xml - 解码 10 位或 13 位 ISBN 代码：
  • 默认 - DocCap+Optional-Barcode.xml - 将表单作为图像捕获，并且可以选择对条码进行解码（如果存在）。
  • 默认 - DocCap+Required-Barcode.xml - 获取表单，并解码任何可用的条码。
  • 默认 - TravelDoc.xml - 从旅行证件（如护照）的机器可读取区域 (MRZ) 获取信息。
  • 默认 - Unstructured Multi-Line.xml - 使用 OCR 获取多行字母/数字文本。
  • 默认 - Unstructured Single Line.xml - 使用 OCR 获取单行字母/数字文本。

SimulScan 包含的所有模板名称前面均带有“默认”字样以及连字符。

要将自定义模板添加到上面的列表，请将模板 XML 文件复制到 /enterprise/device/settings/datawedge/templates 目录。

注意：在 /enterprise 目录中的文件和文件夹对“Android 文件浏览器”不可见；通过手动输入路径，可在“文件浏览器”中将其显示。

Zebra 合作伙伴和其他授权用户可使用 Zebra 的 SimulScan Template Builder 在线创建自定义模板。

动态模板参数 – 允许在使用动态模板时配置参数。这样可提供根据不同的使用场景接受输入参数的灵活性，而不是每个场景需要不同的模板。如果所选模板包含动态模板参数，则 DataWedge 会提示用户配置参数。目前支持动态数量，其设置表单上要解码条码的数量（从 1 到 99；默认值 = 5）。使用 Template Builder 创建动态模板。

区域分隔符 - 用于为 SimulScan 文本区域数据配置分隔符字符（请参阅下面的备注）。当存在多个文本区域时，将在获取表单上每个区域的数据字符串之间插入区域分隔符。区域分隔符可与按键输出操作键字符设置一起使用，以将 SimulScan 区域数据分派到不同的文本字段。

可能的值：

  • 无（默认值）
  • Tab
  • 换行符
  • 回车符

日志目录 – 用于更改设备上用于存储 SimulScan 日志的默认文件夹路径 (/storage/emulated/0/simulscan/logs)。注意：SimulScan 日志记录由所使用的 SimulScan 模板进行启用/禁用；日志记录不由 DataWedge 控制。

时间戳 – 启用/禁用随已获取数据一起自动插入时间戳 (yyyy-MM-dd HH:mm:ss)。

SimulScan 备注

  • DataWedge 将通过 SimulScan 获取的所有文本级联成一个字符串，并针对该字符串执行处理。
  • 条码、OCR 和 OMR 区域视为文本区域。使用按键输出和/或 IP 输出时，仅将文本区域数据分派到前台应用程序或远程服务器。
  • 仅可通过 Intent 输出检索图片区域数据（图像）。
  • 将通过 SimulScan 获取的文本级联成单个字符串，并针对该字符串执行处理。
  • 如果在配置文件中启用条码输入，则在该配置文件中启用 SimulScan 将导致禁用条码输入插件。

SimulScan 相关数据

可以使用以下调用检索添加到 Intent 捆绑包中的与 SimulScan 相关的数据：

  • Intent.getStringtExtra()
  • Intent. getParcelableArrayListExtra()
  • Bundle.getInt()
  • Bundle.getString()
  • Bundle.getByteArray()

上面的调用可使用以下字符串标签：

  • 字符串 SIMULSCAN_TEMPLATE_NAME_TAG = "com.symbol.datawedge.simulscan_template_name"；SimulScan 用于捕获表单的模板的名称。

  • 字符串 SIMULSCAN_REGIONS_BUNDLE_TAG= "com.symbol.datawedge.simulscan_region_data"；返回一个捆绑包数组，其中每个捆绑包都包含有关区域和表单的数据和信息。

  • 字符串 SIMULSCAN_REGION_NAME_TAG = "com.symbol.datawedge.simulscan_region_name"；返回到达区域的捆绑包对象的区域名称。调用 Bundle.getString() 以获取区域名称。

  • 字符串 SIMULSCAN_REGION_ID_TAG = "com.symbol.datawedge.simulscan_region_id"；返回到达区域的捆绑包对象的区域 ID。区域 ID 为整数，并且通过调用 Bundle.getInt () 来检索。

  • 字符串 SIMULSCAN_REGION_STRING_DATA= "com.symbol.datawedge.simulscan_region_string_data"；返回区域的字符串数据。字符串数据配有条码、OCR 和 OMR 数据。

  • 字符串 SIMULSCAN_REGION_BINARY_DATA= "com.symbol.datawedge.simulscan_region_binary_data"；以字节数组的形式返回区域的数据。二进制数据仅用于图片区域和表单图像。图片和表单数据均可加载到位图中，并显示在应用程序中。

  • 字符串 SIMULSCAN_REGION_TYPE_TAG = "com.symbol.datawedge.simulscan_region_type"；返回到达区域的捆绑包对象的区域类型。区域类型是字符串，并且通过调用 Bundle.getString () 来检索。

区域类型的可能返回值：

  • 条码 - 区域是条码。
  • OCR - 区域是一个光学字符识别 (OCR) 区域（即名称或地址）。
  • OMR - 区域是一个光学标记识别 (OMR) 区域（即复选框、单选按钮）。
  • 图片 - 区域为图片；数据将以 JPEG 格式显示。
  • 表单 - 表单类型用于指定该捆绑包所包含已获取表单的图片。表单图像以 JPEG 格式显示。

重要说明：对于某些扫描应用程序，最好将解码后的数据直接发送到当前活动，且不一定显示。对于此类实例，必须在其 AndroidManifest.xml 文件中指定该活动为“singleTop”。不以这种方式指定活动将导致在每次解码时启动一个活动实例，并且将数据发送到每个新生成的副本。

有关 Android Intent 的更多信息，请参考 Android 开发人员网站。

配置

以编程方式配置 Simulscan 并检索配置：

相关指南：