tt.followAwemeUser
收藏
我的收藏

注意:为了更好的保护小程序内的用户体验,平台将于2024年10月22日起 陆续对 tt.followAwemeUser 增加触发频次的限制,以避免频繁弹窗对用户造成骚扰。请开发者提前对能力调用进行自查和调整,确保小程序业务逻辑稳定查看公告

基础库 2.19.0 开始支持本方法,这是一个异步方法。

调用此 API 会弹出弹框,用户可以点击按钮关注绑定的抖音号。仅抖音 \ 抖音 Lite \ 抖音火山版支持。

使用该功能前开发者需要去开发者后台为对应的抖音号申请关注抖音号接口能力,具体信息请参考关注抖音号能力接入指南

前提条件
业务背景
使用限制
注意事项
  • Tip: 使用该功能前开发者需要去开发者后台-设置-关联设置-抖音号管理为对应的抖音号申请 关注抖音号接口能力;
  • Tip: 抖音号没有关注抖音号接口权限,会触发 fail 回调,对应的错误码是 21103 。
支持沙盒
相关教程

语法

tt.followAwemeUser(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
awemeIdstring
引导关注的抖音号
2.92.0
successfunction
接口调用成功的回调函数
2.19.0
failfunction
接口调用失败的回调函数
2.19.0
completefunction
接口调用结束的回调函数(调用成功、失败都会执行)
2.19.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
followedboolean
返回调用此 API 之前是否已关注抖音号
2.19.0
errMsgstring
"followAwemeUser:ok"
2.19.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring
"followAwemeUser:fail " + 详细错误信息
2.19.0

错误码

errNoerrMsg说明最低支持版本
10301followAwemeUser:fail feature is not supported in app

宿主未实现

2.53.0
10601followAwemeUser:fail not login

没有登录

2.53.0
10502followAwemeUser:fail cancel

用户取消操作

2.53.0
21103followAwemeUser:fail awemeId not exist

抖音号不存在

2.92.0
21104followAwemeUser:fail awemeId not support

抖音号没有在开发者后台申请 关注抖音号接口 能力。

2.92.0
21102followAwemeUser:fail following request failed

用户信息获取失败

2.92.0

扫码体验

请使用字节宿主APP扫码

代码示例