tt.onNeedPrivacyAuthorization
收藏我的收藏
基础库 4.17.0 开始支持本方法,这是一个同步方法。
注册隐私授权需要用户确认时的回调。开发者可通过自定义 UI 呈现隐私授权弹窗,并在用户操作后通过回调提供的 resolve 函数反馈结果。
| 前提条件 | 无 |
| 业务背景 | 无 |
| 使用限制 | 无 |
| 注意事项 | 无 |
| 相关教程 | 无 |
语法
tt.onNeedPrivacyAuthorization(callback)
参数说明
callback
| 类型 | 默认值 | 必填 | 说明 | 最低 支持版本 |
|---|---|---|---|---|
| function | 是 | 监听隐私授权需求的回调函数。回调入参为 (resolve, eventInfo)。 | 4.17.0 |
callback 是一个回调函数,接收类型参数如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| resolve | function | 隐私授权结果反馈接口。调用 resolve({ event: 'agree' }) 表示同意,resolve({ event: 'disagree' }) 表示拒绝。 | 4.17.0 |
| eventInfo | object | 包含触发本次回调的关联信息。 | 4.17.0 |
resolve 类型说明
是一个回调函数,接收类型参数如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| param | object | resolve 的入参对象。 | 4.17.0 |
param 类型说明
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| event | string | 用户操作类型。可选值:'agree'(同意)、'disagree'(拒绝)。 | 4.17.0 |
eventInfo 类型说明
object 类型,属性如下:
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| referrer | string | 触发本次隐私授权需求的接口名(例如:"getUserProfile"、"authorize")。 | 4.17.0 |
返回值
无
代码示例
tt.onNeedPrivacyAuthorization((resolve, eventInfo) => { console.log('触发隐私授权的接口:', eventInfo.referrer); // 开发者展示自定义隐私弹窗 UI this.showPrivacyPopup({ onAgree: () => { resolve({ event: 'agree' }); }, onDisagree: () => { resolve({ event: 'disagree' }); } }); });
