更新记录

1.0.0（2024-06-05）

三个组件重新整合

平台兼容性

原生插件通用使用流程：

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>