bleToken

scan connect disConnect enumApps getApp login logout createContainer genKeyPair getContainers exportPublicKeyBlob signatures getDeviceInfo

概述

该插件封装了蓝牙设备安全检测功能

插件接口

scan

扫描蓝牙设备

scan(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
    devices ： []	   //数组类型；蓝牙设备的名称数组
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.scan(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

connect

连接蓝牙设备

connect({params}, callback(ret))

params

deviceName：

  • 类型：字符串类型
  • 描述：要连接的蓝牙设备名称

auth：

  • 类型：字符串类型
  • 描述：要连接的蓝牙设备的授权码，默认为12345678

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.connect({
        deviceName : "1170308102",
        auth : "12345678"
},function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

disConnect

断开蓝牙设备连接

disConnect(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.disConnect(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(ret)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

enumApps

枚举应用

enumApps(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
    apps ： []	   //数组类型；应用的名称数组
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.enumApps(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

getApp

获取应用，进行以下操作前要先获取到应用

getApp({params}, callback(ret))

params

appName：

  • 类型：字符串类型
  • 描述：应用名称

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.getApp({
    appName : 'K5RSA'
},function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

login

登录

login({params}, callback(ret))

params

password：

  • 类型：字符串类型
  • 描述：登录密码

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.login({
    password : '12345678'
},function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

logout

注销登录

logout(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.logout(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

createContainer

创建容器，名称根据SDK的随机数接口生成一个32位的随机数（转换成16进制字符串）

createContainer(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
    containerName ：   //字符串类型；容器名称
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.createContainer(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

genKeyPair

生成密钥对，RSA加密模式

genKeyPair({params},callback(ret))

params

containerName：

  • 类型：字符串类型
  • 描述：容器名称

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.genKeyPair({
    containerName : ''
},function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

getContainers

枚举容器

getContainers(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       		//布尔类型；蓝牙是否可用
    containers : [{	   		//数组类型；容器数组
        containerName:		//字符串类型；容器名称
        containerType:		//字符串类型；容器类型
        isSignCert:			//布尔类型；是否存在签名证书
        isExchCert:			//布尔类型；是否存在加密证书
        signKeyLen:			//数字类型；签名密钥长度
        exchKeyLen:			//数字类型；加密密钥长度
    }]	   
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.getContainers(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

exportPublicKeyBlob

导出公钥

exportPublicKeyBlob({params},callback(ret))

params

containerName：

  • 类型：字符串类型
  • 描述：容器名称

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
    publicKey ：		   //字符串类型；公钥
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.exportPublicKeyBlob({
    containerName : ''
},function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

signatures

签名

signatures({params},callback(ret))

params

containerName：

  • 类型：字符串类型
  • 描述：容器名称

data：

  • 类型：字符串类型
  • 描述：要签名的数据

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
    signature ：		   //字符串类型；签名
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.signatures({
    data : '12345678'
    containerName : '',
},function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

getDeviceInfo

获取蓝牙设备信息

getDeviceInfo(callback(ret))

callback(ret, err)

ret:

  • 类型：JSON 对象
  • 内部字段：
{
    status: true       //布尔类型；蓝牙是否可用
    deviceId ：	   	   //字符串类型；蓝牙设备序列号
}

err:

  • 类型：JSON 对象
  • 内部字段：
{
    code: 0       //数字类型；错误码
}

示例代码

var bleToken = api.require("bleToken");
bleToken.getDeviceInfo(function(ret,err){
    if(ret.status){
        api.alert({
            msg: JSON.stringify(ret)
        })
    }else{
        api.alert({
            msg: JSON.stringify(err)
        })
    }
});

可用性

Android,IOS

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/04/24