简介
Cordova 插件 @ran2207/cordova-honeywell-scanner
是一个用于与霍尼韦尔扫描器配合使用的 Cordova 插件。它能够在 Cordova 应用中直接调用扫描器,通过调用原生接口实现扫描功能。使用该插件需要对 Cordova 开发以及霍尼韦尔扫描器有基础了解。
安装
安装 @ran2207/cordova-honeywell-scanner
插件最简单的方式就是使用 npm 命令行工具,只需要在 Cordova 项目的根目录下运行以下命令:
npm install @ran2207/cordova-honeywell-scanner --save
这将会安装并保存插件到项目的 package.json
文件中。
使用
在调用插件时,我们需要确保插件已被正确初始,这需要在 deviceready
事件触发后完成。你可以在以下的代码示例中看到如何使用插件的:
-- -------------------- ---- ------- ---------------------------------------- -------- -- - ----- ------- - --- ------------------------ -------- ------ ------- - ----------------- -------- ---- -------- ---------- -- -- --------- ---- --- ------- ---- -- -------- ------- ------- - ---------------------- ----- --------- ----------- -- ------ --- ----- - -- -- ----- --- ------- ---------------- -- -------
在代码示例中,我们首先在 deviceready
事件中创建了一个 CordovaHoneywellScanner
对象,并在初始化时传入了两个回调函数。第一个回调函数在扫描器扫描到一条数据时触发,第二个回调函数则在扫描器出现错误时触发。
在初始化之后,我们调用 start
方法启动扫描器。
高级用法
除了一般用法之外,该插件还提供了一些高级特性,方便你在更复杂的场景下使用。以下为常用的高级用法举例:
处理从扫描器返回的无效数据
当使用扫描器扫描到一些无效数据时,我们可以为 CordovaHoneywellScanner
对象传递一个可选的配置对象来指定如何处理这些数据:
const scanner = new CordovaHoneywellScanner(...); scanner.configure({ discardInvalid: true // Throw away invalid data });
该配置对象中只有 discardInvalid
一项,当为 true
时,将忽略由扫描器发出的无效数据。
使用自定义配置文件
你还可以根据需要使用自定义的配置文件以满足更为特殊的场景。在这种情况下,插件将会读取你指定的文件路径并尝试拿到配置信息。以下是配置文件的例子:
{ "recursive": true, "discardInvalid": true }
接下来,当我们创建 CordovaHoneywellScanner
对象时,指定配置文件的路径即可:
const scanner = new CordovaHoneywellScanner(...); scanner.configure({ configFile: '/path/to/config.json' });
此时插件将会读取并使用该 JSON 文件作为配置文件。
总结
本文介绍了 Cordova 插件 @ran2207/cordova-honeywell-scanner
的基本用法和一些高级用法,并给出了相关的代码示例和配置文件样式。希望这篇文章对你来说有所帮助。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60065f8c238a385564ab6e76