mtlUnis

startPDAScan stopPDAScan rfidConnect rfidDisconnect startInventory stopInventory

模块概述

此模块封装了通过紫光云PDA和RFID设备扫描识别的功能

模块接口

startPDAScan

添加pda扫描监听;扫描结果在此监听中返回

startPDAScan(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status: true,      //布尔类型;是否添加成功
   data: '',         //字符串类型；扫描结果
   message:''       //字符串类型；status为'false'时返回
}

示例代码

var mtlUnis = api.require('mtlUnis');
mtlUnis.startPDAScan(function(ret) {
    api.alert({ msg:JSON.stringify(ret)});
});

可用性

Android系统

可提供的1.0.0及更高版本

stopPDAScan

移除扫描监听，移除后将收不到扫描结果

stopPDAScan()

示例代码

var mtlUnis = api.require('mtlUnis');
mtlUnis.stopPDAScan();

可用性

Android系统

可提供的1.0.0及更高版本

rfidConnect

rfid模块上电、连接。开启rfid识别前必须先调用此接口。rfid模块比较耗电，页面进入后台或者闭关时需要调用rfidDisconnect接口

rfidConnect(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status:true,        //布尔类型;是否连接成功
 
}

可用性

Android系统

可提供的1.0.0及更高版本

rfidDisconnect

rfid模块下电、断开连接接口

rfidDisconnect(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status:true,        //布尔类型;模块下电、断开连接是否成功
}

示例代码

 var mtlUnis = api.require('mtlUnis');
 apiready = function(){
    //页面第一次打开时先调用模块上电、连接接口        
    mtlUnis.rfidConnect(function(ret) {
            alert("rfidConnect:"+JSON.stringify(ret));
    });
    
    //应用进入后台时调用模块下电、断开连接接口
    api.addEventListener({
         name:'pause'
    }, function(ret, err){
         mtlUnis.rfidDisconnect(function(ret) {
            alert("rfidDisConnect:"+JSON.stringify(ret));
        });
    });

    //应用从后台可见时调用模块上电、连接接口
    api.addEventListener({
        name:'resume'
    }, function(ret, err){
         mtlUnis.rfidConnect(function(ret) {
            alert("rfidConnect:"+JSON.stringify(ret));
        });
    });
}

可用性

Android系统

可提供的1.0.0及更高版本

startInventory

开始识别rfid识别，调用stopInventory停止识别后识别结果会在startInventory的回调中返回。 注意：按键一直处于按压状态会干扰识别，只能是按一次开始识别，再按一次结束识别。不能是按压时开始识别，松开时结束识别，这样会影响识别结果

startInventory(callback(ret))

callback(ret)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
   status:true,        //布尔类型;开始识别是否成功
   errorCode:'',       //status返回false时返回开启识别失败错误码
   message:'',         //status返回false时返回开启识别失败原因
   eventType:''        //status返回true时 eventType == 'onTagRead'表示识别到rfid标签
   result:''           //JSONAarray,status返回true时返回rfid标签识别结果 
                       // result内部结构 [{tagID:''},{tagID:''}...]
}

示例代码

 var mtlUnis = api.require('mtlUnis');
 var isRunning = false;
 apiready = function(){
    api.addEventListener({
        name: 'keypress'
    }, function(ret, err) {
        //监听手柄按键，按一次开始识别，再按一次结束识别。
        if (ret&&(ret.keyCode==292||ret.keyCode==131)) {
        console.log("mtlUNIS action===="+ret.action)
            if(ret.action=="up"){
                if(!isRunning){
                    isRunning = true;
                    mtlUnis.startInventory(function(ret) {
                        api.alert({ msg:JSON.stringify(ret)});
                    });
                }else{
                   isRunning = false;
                   mtlUnis.stopInventory();
                }

            }
        }
    });
 }

可用性

Android系统

可提供的1.0.0及更高版本

stopInventory

停止识别rfid识别

stopInventory()

可用性

Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2025/09/15