tt.onReceiveLiveInteractPluginMessage
收藏
我的收藏基础库 3.41.0 开始支持本方法,这是一个同步方法。
用于接收直播间开放消息数据。
前提条件 | 需要在抖音开放平台创建插件,并申请「互动数据」权限 |
业务背景 | 无 |
使用限制 | 无 |
注意事项 | 无 |
支持沙盒 | 否 |
相关教程 | 无 |
语法
tt.onReceiveLiveInteractPluginMessage(callback)
参数说明
callback
类型 | 默认值 | 必填 | 说明 | 最低支持 版本 |
---|---|---|---|---|
function | 否 | 收到消息后触发的回调函数 | 3.41.0 |
callback 是一个回调函数,接收类型参数如下:
属性名 | 类型 | 说明 | 最低支持版本 |
---|---|---|---|
msg_id | string | 消息 id,通用返回 | 3.41.0 |
timestamp | number | 时间戳,通用返回 | 3.41.0 |
sec_open_id | string | 用户的加密 openid,通用返回 | 3.41.0 |
avatar_url | string | 用户头像,通用返回 | 3.41.0 |
nickname | string | 用户昵称,通用返回 | 3.41.0 |
like_num | number | 点赞数量 监听 live_like 消息返回(需要开启「获取点赞互动数据」权限) | 3.41.0 |
content | string | 评论内容 监听 live_comment 消息返回(需要开启「直播间评论互动数据」权限) | 3.41.0 |
gift_num | number | 送出的礼物数量 监听 live_gift 消息返回(需要开启「获取礼物互动数据」权限) | 3.41.0 |
use_follow_action | number | 用户关注变更数据 监听 live_follow 消息返回(需要开启「直播间观众关注状态」权限) | 3.41.0 |
fansclub_reason_type | number | 粉丝团变更原因 监听 live_fansclub 消息返回(需要开启「获取粉丝团互动数据」权限) | 3.41.0 |
fansclub_level | number | 粉丝团等级 需要开启「直播间观众粉丝团详细信息」权限后额外返回 | 3.41.0 |
user_privilege_level | number | 用户荣誉等级 需要开启「直播间观众荣誉等级」权限后额外返回 | 3.41.0 |
is_follow_anchor | boolean | 用户是否关注主播 需要开启「直播间关注互动数据」权限后额外返回 | 3.41.0 |
返回值
无
代码示例
tt.onReceiveLiveInteractPluginMessage((res) => { console.log('消息数据:', res); });
点击纠错