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