纷享销客开发者手册 纷享销客开发者手册
  • APL开发手册
  • PWC开发手册
  • OpenAPI 文档
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门
  • API 授权流程
  • API 基础说明
  • OpenAPI
  • 免登集成方案
  • 客户端开发
  • 常见问题
  • OpenApi V1版本 (opens new window)
  • 简体中文
  • English
  • 快速入门

  • API授权流程

  • API基础说明

  • OpenAPI

  • 免登集成方案

  • 客户端开发

    • 接入指南

    • JavaScript

      • 容器
      • 设备
        • 启动器
        • Webview
        • 弹层
        • 纷享服务
        • 媒体
        • 通用
      • UI

    • 常见问题

    目录

    设备

    # 设备

    接口名 接口描述
    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秒。
    容器
    启动器

    ← 容器 启动器 →

    • 跟随系统
    • 浅色模式
    • 深色模式
    • 阅读模式