更新记录
1.0.1(2020-07-30)
初版。
平台兼容性
Android | Android CPU类型 | iOS |
---|---|---|
适用版本区间:4.4 - 10.0 | armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 | × |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios
注意事项:使用HBuilderX2.7.14以下版本,如果同一插件且同一appid下购买并绑定了多个包名,提交云打包界面提示包名绑定不一致时,需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择
基本使用方法
1. 在页面中引入:const scanHelper = uni.requireNativePlugin('xfbao-ScanHelper')
2. 调用init()方法进行初始化。建议在onLaunch()方法中调用。
3. 设置接收模式和扫描模式。默认广播和普通扫描模式。
4. 注册监听扫描结果(非广播模式直接扫描到界面上的输入框中):register() / unregister()
5. 启用/禁用扫描按钮:enableScanButton(true|false)
/**
* 必须先调用init方法进行初始化
*/
public boolean init()
/**
* 设置接收模式。
* @param 0,快速;1,慢速;2,广播
*/
public void setBarcodeReceiveModel(RECEIVE_MODE mode)
/**
* 设置扫描模式。
* @param mode 0,普通模式,按一次扫描按钮扫描一次;1,自动连续扫描;2,连续扫描,手动,按下不松开连续扫描,松开停止;
*/
public void setScanOperatingMode(SCAN_MODE mode)
/**
* 获取接收模式
*/
public RECEIVE_MODE getBarcodeReceiveModel()
/**
* 获取扫描模式
*/
public SCAN_MODE getScanOperatingMode()
/**
* 注册条码receiver。重复注册无效。
*/
public void register(JSCallback callback)
/**
* 注销条码Receiver。
*/
public void unregister()
/**
* 禁用/启用扫描键,对应“扫描服务”中“扫描模式”。
*
* @param enable
*/
public void enableScanButton(boolean enable)
/**
* 启用/禁用前台输出,对应“扫描服务”中“前台输出”。
*
* @param enable
*/
public void enableScanForegroundOutput(boolean enable)
/**
* 扫码时的声音设置。
*
* @param enable
*/
public void setScanSound(boolean enable)
/**
* 获取扫码时的声音设置。
*
* @return
*/
public boolean getScanSound()
/**
* 扫码时的震动设置。
*
* @param enable
*/
public void setScanVibrate(boolean enable)
/**
* 获取扫码时的震动设置。
*
* @return
*/
public boolean getScanVibrate()