首页 > API文档 > JavaScript API
设备
更新时间: 2021-12-08 12:27:39

设备类

接口名接口描述
device.authenticateUser对当前用户鉴权,支持指纹和珍岛密码两种方式
device.getAP获取接入点标识
device.getNetworkType获取当前接入的网络类型:WiFi、2/3/4G
device.getUUID获取设备唯一编码
device.scan调用扫码
device.vibrate手机震动

对当前用户鉴权

调用该接口会弹出一个鉴权页面,用户需要验证指纹(支持Touch-ID并打开了指纹登录)、或输入当前登录用户的珍岛密码才能通过鉴权。

代码样例

FSOpen.device.authenticateUser({
    appName: '工资助手',
    onSuccess: function(resp){
        alert('认证成功');
    },
    onFail: function(error){
        if (error.errorCode === 40050) {
            alert('取消了认证');
            return;
        }
        alert('操作失败,错误码:' + error.errorCode);
    }
});

方法名:FSOpen.device.authenticateUser
JS版本:2.0.0
客户端支持版本:5.4.0及以上

调用参数说明:

参数类型必须说明
appNameString当前应用名字

获取接入点标识

代码样例

FSOpen.device.getAP({
    onSuccess: function(resp) {
        // ssid: 'FSDevLan'
        // macAddress: '3c:12:aa:09'
        alert('ssid = ' + resp.ssid + '\n' + 'macAddress = ' + resp.macAddress);
    }
});

方法名:FSOpen.device.getAP
JS版本:2.0.0
客户端支持版本:5.4.0及以上

成功回调返回参数:

参数类型说明
ssidString热点SSID
macAddressString热点MAC地址

获取网络类型

代码样例

FSOpen.device.getNetworkType({
    onSuccess: function(resp) {
        // network: '3g'
        alert('network = ' + resp.network);
    }
});

方法名:FSOpen.device.getNetworkType
JS版本:2.0.0
客户端支持版本:5.4.0及以上

成功回调返回参数:

参数类型说明
networkString网络类型,取值可能为:2g``3g``4g``wifi``unknown``nonenone表示离线。

获取设备唯一编码

代码样例

FSOpen.device.getUUID({
    onSuccess: function(resp) {
        // uuid: 'FD71A168-1CAD-4EF1-BECC-52997124207A'
        alert('uuid = ' + resp.uuid);
    }
});

方法名:FSOpen.device.getUUID
JS版本:2.0.0
客户端支持版本:5.4.0及以上

成功回调返回参数:

参数类型说明
uuidString本机唯一识别码

调用扫码

代码样例

FSOpen.device.scan({
    onSuccess: function(resp) {
        // text: 'https://www.71360.com/'
        alert('扫码内容:' + resp.text);
    }
});

方法名:FSOpen.device.scan
JS版本:2.0.0
客户端支持版本:5.4.0及以上

成功回调返回参数:

参数类型说明
textString扫码内容

手机震动

代码样例

FSOpen.device.vibrate({
    duration: 3000
});

方法名:FSOpen.device.vibrate
JS版本:2.0.0
客户端支持版本:5.4.0及以上

调用参数说明:

参数类型必须说明
durationNumber震动时间,只对Android有效。单位毫秒,默认3秒。