Skip to content

ATTrackingManager.requestTrackingAuthorization() 静态方法 ​

ATTrackingManager.requestTrackingAuthorization() 静态方法向用户申请跟踪授权,返回一个 Promise,兑现成申请之后的授权状态。

语法 ​

ATTrackingManager.requestTrackingAuthorization()

参数 ​

无。

返回值 ​

Promise,兑现成申请之后的授权状态:'notDetermined'、'restricted'、'denied'、'authorized' 之一,见四种授权状态。

状态是 'notDetermined' 时,系统弹出提示框。提示框的标题和两个按钮由系统提供,App 能决定的只有标题下面那句说明(NSUserTrackingUsageDescription)。用户点了按钮之后 Promise 兑现,值是 'authorized' 或 'denied'。

下面几种情况系统不弹出提示框,Promise 立刻兑现成当时的状态:

情况说明
用户已经答复过状态是 'authorized' 或 'denied'
设备受限状态是 'restricted'
用户在系统的「设置 → 隐私与安全性 → 跟踪」里关掉了「允许 App 请求跟踪」所有 App 都不能申请
App 不在活动状态application.state 不是 'active',比如 App 刚启动、界面还没显示出来
上一次申请还在等用户答复提示框正显示着

提示框和这张表来自 Apple 的文档,未在模拟器验证。

一个 App 只有一次弹出提示框的机会:用户答复之后,再申请也不会弹出。

异常 ​

不同步抛出异常。失败时 Promise 被拒绝,值是一个 TypeError:

  • App 的 Info.plist 里没有 NSUserTrackingUsageDescription:requestTrackingAuthorization needs NSUserTrackingUsageDescription in Info.plist; without it the system terminates the app。用 CLI 生成的工程不会走到这里:缺这句说明时生成就已经报错了。它是给自己搭 Xcode 工程、把 framework 拖进去的情况准备的。
  • 系统答复了一个运行时不认识的状态(系统以后新增了状态):requestTrackingAuthorization: the system answered with a status this runtime does not know (…),括号里是系统给的数值。

示例 ​

js
ATTrackingManager.requestTrackingAuthorization().then(
  (status) => {
    console.log(status);
  },
  (err) => {
    console.log('申请没有发出去:' + err.message);
  },
);

效果:状态是 'notDetermined' 时弹出系统的提示框,用户答复后输出 authorized 或 denied;其余情况不弹出提示框,输出现在的状态。Info.plist 里没有 NSUserTrackingUsageDescription 时走第二个回调。未在模拟器验证。

对应的 iOS API ​

+[ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:]。完成回调换成了 Promise。

参见 ​