• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 标准对象输入
  • 用户授权
  • 参数调起使用场景描述
  • 用户授权
    收藏
    我的收藏

    小程序会对用户信息进行严格的保护,开发者仅在用户授权的情况下才能进行下述 API / 组件的调用/使用。
    小程序仅在 API / 组件 首次 调用/使用时弹窗询问用户。若用户允许则正常调用,否则本次调用失败。且在用户手动授权之前,开发者再次调用需要授权 API 时,会直接进入接口的 fail 回调。同时,无论用户允许与否,该授权设置均会出现在小程序授权设置页中。用户可以再次修改授权,调用结果也会随之变化。
    ⚠️ 注意
    只有已经提示过用户授权的权限才会出现在授权设置页面内。
    ⚠️ 注意
    用户授权设置不会与服务器同步,若用户更换设备,或在同一设备上切换账号,则会重新提示授权。

    获取用户授权设置

    开发者可以通过 tt.getSetting 获取用户当前的授权状态。

    打开设置页面

    用户可以在小程序设置页面(右上角 - 更多 - 设置)中控制对该小程序的授权状态。
    开发者可以通过 tt.openSetting 打开设置页面,引导用户授权。

    scope 列表

    scope
    对应接口
    描述
    scope.hostId
    是否授权抖音号
    scope.userLocation
    是否授权地理位置
    scope.record
    是否授权麦克风
    scope.camera
    tt.chooseImage(sourceType=camera)
    是否授权摄像头
    scope.album
    tt.chooseImage(sourceType=album)
    是否授权相册
    scope.address
    是否授权收货地址
    scope.pip
    video组件播放时切后台
    是否授权后台播放视频
    scope.clipboard
    是否授权剪切板
    scope.calendar
    是否授权日历