开发
API

tt.onReceiveAudiencesFollowAction

基础库 2.28.0 开始支持本方法,该 API 为同步 API。
调用方:主播端
使用该功能前,开发者需要申请并通过「直播能力」准入,并开通「获取关注互动数据」能力,具体可参考接入流程

监听接收当前直播间观众的关注/取消关注行为。

语法

tt.onReceiveAudiencesFollowAction(callback);

参数说明

callback

类型默认值必填说明最低支持版本
function事件触发的回调函数2.28.0

回调函数的参数为 Object 类型,属性如下:

属性名类型说明最低支持版本
followInfoListarray监听期间内发生的关注/取消关注行为2.28.0

followInfo 的参数为 object 类型,属性如下:

属性名类型说明最低支持版本
openUIDstring被关注/取消关注用户的 open UID2.28.0
secNicknamestring被关注/取消关注用户的加密后昵称,配合加密昵称组件使用,只能在同一个直播间使用2.28.0
secAvatarURLstring被关注/取消关注用户的加密后头像 URL,配合加密头像组件使用,只能在同一个直播间使用2.28.0
actionnumber行为类型:1-关注、2-取消关注2.28.0
timestampnumber评论时间戳2.28.0

返回值

代码示例

开发者工具中预览

tt.onReceiveAudiencesFollowAction((res) => {
  console.log(`收到用户关注行为事件: ${res.followInfoList}`);
});

Bug & Tip

  • Tips:目前该接口只支持抖音 App,版本需满足 18.2.0 版本及以上
点击纠错
评价此篇文档