设备
# 设备
| 接口名 | 接口描述 |
|---|---|
| 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及以上
调用参数说明:
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| appName | String | 是 | 当前应用名字 |
# 获取接入点标识
代码样例
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及以上
成功回调返回参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| ssid | String | 热点SSID |
| macAddress | String | 热点MAC地址 |
# 获取网络类型
代码样例
FSOpen.device.getNetworkType({
onSuccess: function(resp) {
// network: '3g'
alert('network = ' + resp.network);
}
});
方法名:FSOpen.device.getNetworkType JS版本:2.0.0 客户端支持版本:5.4.0及以上
成功回调返回参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| network | String | 网络类型,取值可能为:2g``3g``4g``wifi``unknown``none,none表示离线。 |
# 获取设备唯一编码
代码样例
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及以上
成功回调返回参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| uuid | String | 本机唯一识别码 |
# 调用扫码
代码样例
FSOpen.device.scan({
onSuccess: function(resp) {
// text: 'https://www.fxiaoke.com/'
alert('扫码内容:' + resp.text);
}
});
方法名:FSOpen.device.scan JS版本:2.0.0 客户端支持版本:5.4.0及以上
成功回调返回参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| text | String | 扫码内容 |
# 手机震动
代码样例
FSOpen.device.vibrate({
duration: 3000
});
方法名:FSOpen.device.vibrate JS版本:2.0.0 客户端支持版本:5.4.0及以上
调用参数说明:
| 参数 | 类型 | 必须 | 说明 |
|---|---|---|---|
| duration | Number | 否 | 震动时间,只对Android有效。单位毫秒,默认3秒。 |