基础库 3.19.0 开始支持本方法，低版本需做兼容处理，这是一个异步方法。

模拟隐私接口调用，并触发隐私弹窗逻辑。隐私合规开发指南详情可见《小程序隐私协议开发指南》

前提条件	无
业务背景	无
使用限制	抖音开发者工具 4.2.3 及以上开始支持此能力调试
注意事项	调用 tt.requirePrivacyAuthorize() 时：如果用户之前已经同意过隐私授权，会立即进入 success 回调，不会触发 tt.onNeedPrivacyAuthorization 事件如果用户之前没有授权过，并且开发者注册了 tt.onNeedPrivacyAuthorization 事件监听，就会立即触发 tt.onNeedPrivacyAuthorization 事件，然后开发者在 onNeedPrivacyAuthorization 回调中弹出自定义隐私授权弹窗，用户点了同意后开发者调用 tt.onNeedPrivacyAuthorization 的回调接口 resolve({ event: 'agree', buttonId: 'agree-btn' })，会触发 requirePrivacyAuthorize 的 success 回调。开发者调用 tt.onNeedPrivacyAuthorization 的回调接口 resolve({ event: 'disagree' }) 的话，会触发 requirePrivacyAuthorize 的 fail 回调。基于上述特性，开发者可以在调用任何真实隐私接口之前调用 tt.requirePrivacyAuthorize 接口来模拟隐私接口调用，并触发隐私弹窗逻辑。
支持沙盒	否
相关教程	无

语法

tt.requirePrivacyAuthorize(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	必填	说明	最低支持版本
success	function	否	接口调用成功的回调函数	3.19.0
fail	function	否	接口调用失败的回调函数	3.19.0
complete	function	否	接口调用结束的回调函数（调用成功、失败都会执行）	3.19.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"requirePrivacyAuthorize:ok"	3.19.0

回调失败

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"requirePrivacyAuthorize:fail" + 详细错误信息	3.19.0

错误码

errorCode	errMsg	errorType	说明	最低支持版本
168680	requirePrivacyAuthorize:fail privacy permission is not authorized	U	隐私协议未授权用户未授权隐私协议，请引导用户按需授权	3.19.0
168691	requirePrivacyAuthorize:fail Internal error: no api callback	F	小程序框架内部错误，有需要请拉客服咨询小程序框架异常，请创建工单反馈，会有专人协助您解决问题	3.19.0
168679	requirePrivacyAuthorize:fail api scope is not declared in the privacy agreement	D	隐私能力不在申请的 scope 内检查隐私协议	3.19.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

tt.requirePrivacyAuthorize({
  success(res) {
    console.log('requirePrivacyAuthorize 调用成功');
  },
  fail(res) {
    console.log('requirePrivacyAuthorize 调用失败：', res);
  },
});