# getAccountInfoSync

获取当前帐号信息

返回值

Object object

属性 类型 说明
miniProgram Object 小程序帐号信息
plugin Object 插件帐号信息(仅在插件中调用时包含这一项)

object.miniProgram 的结构

结构属性 类型 说明
appId string 小程序 appId
envVersion string 小程序版本
version string 线上小程序版本号

object.plugin 的结构

结构属性 类型 说明
appId string 插件 appId
version string 插件版本号

示例代码

const accountInfo = ft.getAccountInfoSync();
console.log(accountInfo.miniProgram.appId) // 小程序 appId

# authorize

提前向用户发起授权请求。

参数

Object object

属性 类型 默认值 必填 说明
scope string yes 需要获取权限的 scope,详见 scope 列表
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

示例代码

// Can be passed ft.getSetting Check to see if the user is authorized "scope.record" this scope
// 可以通过 ft.getSetting 先查询一下用户是否授权了 "scope.record" 这个 scope
ft.getSetting({
  success(res) {
    if (!res.authSetting['scope.record']) {
      ft.authorize({
        scope: 'scope.record',
        success () {
          // 用户已经同意小程序使用录音功能,后续调用 ft.startRecord 接口不会弹窗询问
          ft.startRecord()
        }
      })
    }
  }
})

# openSetting

调起客户端小程序设置界面,返回用户设置的操作结果

参数

Object object

属性 类型 默认值 必填 说明
withSubscriptions Boolean false 是否同时获取用户订阅消息的订阅状态,默认不获取。
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性 类型 说明
authSetting AuthSetting 用户授权结果
subscriptionsSetting SubscriptionsSetting 用户订阅消息设置,接口参数withSubscriptions值为true时才会返回

示例代码

ft.openSetting({
  success (res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})

# getSetting

获取用户的当前设置

参数

Object object

属性 类型 默认值 必填 说明
withSubscriptions Boolean false 是否同时获取用户订阅消息的订阅状态,默认不获取。
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性 类型 说明
authSetting AuthSetting 用户授权结果
subscriptionsSetting SubscriptionsSetting 用户订阅消息设置,接口参数withSubscriptions值为true时才会返回
miniprogramAuthSetting AuthSetting 在插件中调用时,当前宿主小程序的用户授权结果

示例代码

ft.getSetting({
  success (res) {
    console.log(res.authSetting)
    // res.authSetting = {
    //   "scope.userInfo": true,
    //   "scope.userLocation": true
    // }
  }
})

# AuthSetting

用户授权设置信息,详情参考权限

属性

boolean scope.userInfo

是否授权用户信息,对应接口 ft.getUserInfo

boolean scope.userLocation

是否授权地理位置,对应接口 ft.getLocation, ft.chooseLocation

boolean scope.address

是否授权通讯地址,已取消此项授权,会默认返回true

boolean scope.invoiceTitle

是否授权发票抬头,已取消此项授权,会默认返回true

boolean scope.invoice

是否授权获取发票,已取消此项授权,会默认返回true

boolean scope.werun

是否授权微信运动步数,对应接口 ft.getWeRunData

boolean scope.record

是否授权录音功能,对应接口 ft.startRecord

boolean scope.writePhotosAlbum

是否授权保存到相册 ft.saveImageToPhotosAlbum, ft.saveVideoToPhotosAlbum

boolean scope.camera

是否授权摄像头,对应 camera 组件

boolean scope.bluetooth

是否授权蓝牙,对应接口 ft.openBluetoothAdapter、ft.createBLEPeripheralServer

boolean scope.addPhoneContact

是否添加通讯录联系人,对应接口 ft.addPhoneContact

boolean scope.addPhoneCalendar

是否授权系统日历,对应接口 ft.addPhoneRepeatCalendar、ft.addPhoneCalendar