更新记录

1.0.0(2024-06-05)

三个组件重新整合


平台兼容性

Android Android CPU类型 iOS
适用版本区间:7.0 - 11.0 armeabi-v7a:支持,arm64-v8a:支持,x86:未测试 ×

原生插件通用使用流程:

  1. 购买插件,选择该插件绑定的项目。
  2. 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
  3. 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
  4. 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
  5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
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、插件说明 本插件是天波收银机专用SDK工具集, 插件主要集成了扫码窗、身份证读卡器、小票打印3个组件设备 。

2、使用步骤

1)导入插件

2)注册插件、配置数据监听方法

3、代码示例

<template>
    <view>
        <view>
            <button type="primary" @click="initScanPlugin">初始化扫码插件</button>
            <button type="primary" @click="releaseScanPlugin">释放扫码插件</button>
            <button type="primary" @click="pauseScan">暂停扫码</button>
            <button type="primary" @click="resumeScan">恢复扫码</button>
        </view>
        <view>
            <text>扫码结果:{{scanData}}</text>
        </view>

        <view>
            <button type="primary" @click="initReaderPlugin">初始化读卡器</button>
            <button type="primary" @click="releaseReaderPlugin">释放读卡器</button>
            <button type="primary" @click="readCard">开始读卡</button>
            <button type="primary" @click="stopReading">停止读卡</button>
        </view>
        <view>
            <text>身份证信息:{{idCardData}}</text>
        </view>
    </view>
</template>
<script>
    // 获取 module 
    var telpoD2Plugin = uni.requireNativePlugin("ls-cashier-kit-plugin");
    /***
    天波D2 双屏机原生插件使用说明
    1、扫码窗
        初始化扫码插件后默认开始监听扫码窗,如果需要暂停或恢复扫码,请调用接口即可。不再使用插件时,请释放扫码插件。
    2、身份证识别
        插件必须先初始化读卡器。由于读卡器很消耗性能,默认不自动开启读卡,需要手动调用开始读卡接口,识别到身份证后请调用停止读卡,如需再次读卡请调用开启读卡即可。
        不使用读卡器后,请释放读卡器。

    *****/
    const modal = uni.requireNativePlugin('modal');
    export default {
        data() {
            return {
                scanData: '',
                idCardData: ''
            }
        },  
        onLoad() {
            let _this= this;
            plus.globalEvent.addEventListener('scanDataEvent', function(e){
                modal.toast({
                    message: "scanDataEvent收到数据",
                    duration: 1.5
                });
                _this.scanData = e.dataContent;
            });

            plus.globalEvent.addEventListener('initReaderEvent', function(e){
                modal.toast({
                    message: "initReaderEvent收到数据 " + e.status + " " + e.msg,
                    duration: 3
                });
            });

            plus.globalEvent.addEventListener('readCardEvent', function(e){
                modal.toast({
                    message: "readCardEvent收到数据",
                    duration: 1.5
                });
                /***
                属性对象
                name 姓名, 中间有空格,需要自行处理
                headPhoto 头像,尺寸 102 * 126,  使用方法 src="data:image/jpeg;base64," + e.headPhoto
                sex 性别
                nation 名族
                born 出生日期
                no 身份证号
                period  有效期限
                apartment 签发机关
                address 住址
                ***/
                _this.idCardData = e.name +" " + e.no;

            });
        },
        methods: {
            initScanPlugin() {
                telpoD2Plugin.initScanPlugin({}
                ,(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                });

            },
            releaseScanPlugin(){
                telpoD2Plugin.releaseScanPlugin({},(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                    });
            },
            pauseScan(){
                telpoD2Plugin.pauseScan({},(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                    });
            },
            resumeScan(){
                telpoD2Plugin.resumeScan({},(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                    });
            },
            initReaderPlugin(){
                telpoD2Plugin.initReaderPlugin({},(ret) => {
                        /* uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 1500
                        }); */
                    });
            },
            releaseReaderPlugin(){
                telpoD2Plugin.releaseReaderPlugin({},(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                    });
            },
            readCard(){
                telpoD2Plugin.readCard({},(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                    });
            },
            stopReading(){
                telpoD2Plugin.stopReading({},(ret) => {
                        uni.showToast({
                            icon: 'none',
                            title: JSON.stringify(ret),
                            duration: 3000
                        });
                    });
            }
        }
    }
</script>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据。 插件不具备存储功能,读取到的身份证信息直接返回到页面进行展示。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

暂无用户评论。

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问