直播间礼物互动能力
一、能力介绍
功能点 | 实现效果 | 示意 |
设置玩法专属礼物 |
| |
设置礼物效果描述 |
| |
设置礼物组刷 |
| |
设置幸运魔方(随机道具) | 开发者在直播玩法后台开启并接入「幸运魔方」功能,即可在小摇杆内展示出「幸运魔方」,激发直播间观众参与兴趣,让用户快速体验玩法爽感,实现用户付费破冰。 | |
二、接入流程
- 1.能力申请
- ◦登录开发者平台控制台。
- ◦在「我的应用」页面中点击「直播小玩法」,然后在「直播小玩法」页签中点击已创建的应用。
- ◦在应用详情页面左侧导航栏选择「能力」-「基础互动能力」,选择「直播间礼物互动能力」并点击「申请开通」。
- 2.能力配置
配置项 | 配置说明 | 示意图 |
能力申请 |
| |
能力配置 | 添加礼物
| |
添加礼物描述
| ||
添加礼物数量
| ||
礼物效果区分阵营
| ||
幸运魔法配置 开启「幸运魔方」开关后,观众侧即可看到幸运魔法按钮,详细接入指南请查看幸运魔方(随机道具)接入指南 | | |
配置审核 |
| |
观众阵营数据配置 |
|
三、接口列表
- 1.获取礼物数据
详见:数据开放
API 名称 | API 描述 |
获取access_token | 该接口用于获取开放能力接口的调用凭证 access_token |
启动任务 | 启动直播间数据推送,启动成功后,直播间数据才会同步推送给开发者服务器 |
停止任务 | 停止直播间数据推送成功后,抖音平台会等停止前产生的存量数据推送完成,然后停止推送新数据 |
查询任务状态 | 抖开提供接口给开发者查询推送任务状态 |
分页查询推送失败数据(仅支持礼物数据) | 开发者可以定时请求api分页查询推送失败的数据 |
弹幕数据上报 | 服务端推送直播间内特定礼物的数据,设计玩法内交互,如赠送礼物可获得武器加成,支持对局数据上报 |
- 2.分阵营展示礼物
详见:礼物进阶互动效果
API 名称 | API 描述 |
同步对局状态 | 开发者在 对局开始时调用,同步对局开始事件; 在对局结束时再次调用,同步对局结束事件。 |
上报阵营数据 | 观众通过评论、点赞、送礼等方式加入玩法时,调用该接口上报当前观众的阵营数据。 |
查询观众阵营数据 | 查询观众当前阵营数据,在观众进入直播间打开小摇杆互动面板时,平台服务器请求该接口获取用户在指定直播间最新的阵营数据。 |
四、直播玩法礼物素材图片及id
常规礼物
礼物名称 | 价值抖币 | 礼物icon | 礼物ID |
仙女棒 | 1抖 | n1/Dg1905sj1FyoBlQBvmbaDZFBNaKuKZH6zxHkv8Lg5x2cRfrKUTb8gzMs= | |
黄色仙女棒 | 1抖 | eplFUy7i0B0fiv0Iym1MpOZa5XmUE8g/WUAyJ6Tc+UJJDpcs7pzclNOz/WM= | |
蓝色仙女棒 | 1抖 | 4I66OIE1HKWfM7PNvAHtAgYUSNlggSEgcpo3ai8GYQXAWqjrDuH8NtjsWEQ= | |
绿色仙女棒 | 1抖 | XHS+QR5Cv0b9ydsZZ5mLkrhPtMTTdrLsgfWNU/QX2IfUy2P6dmDaRHJT+0U= | |
紫色仙女棒 | 1抖 | gs+95ujNzXXSCtLTv97fWgbApTQi0sqz1BULB+7w62g+v4sFxINvxOIrXCw= | |
能力药丸 | 10抖 | 28rYzVFNyXEXFC8HI+f/WG+I7a6lfl3OyZZjUS+CVuwCgYZrPrUdytGHu0c= | |
魔法镜 | 19抖 | fJs8HKQ0xlPRixn8JAUiL2gFRiLD9S6IFCFdvZODSnhyo9YN8q7xUuVVyZI= | |
甜甜圈 | 52抖 | PJ0FFeaDzXUreuUBZH6Hs+b56Jh0tQjrq0bIrrlZmv13GSAL9Q1hf59fjGk= | |
能量电池 | 99抖 | IkkadLfz7O/a5UR45p/OOCCG6ewAWVbsuzR/Z+v1v76CBU+mTG/wPjqdpfg= | |
爱的爆炸 | 199抖 | gx7pmjQfhBaDOG2XkWI2peZ66YFWkCWRjZXpTqb23O/epru+sxWyTV/3Ufs= | |
派对话筒 | 299抖 | YbLESoUj053FWVYPWUNOAtp4FYnb+/eZbyrLi7ndArVFz14rivgxf0cFrKs= | |
神秘空投 | 520抖 | pGLo7HKNk1i4djkicmJXf6iWEyd+pfPBjbsHmd3WcX0Ierm2UdnRR7UINvI= | |
草莓甜点 | 666抖 | rHSYLYmWZvy2eal+foarBgE5qDJe3j2e96icNOhTSO/t2G0W8UVnXN3mltM= | |
超级空投 | 888抖 | lsEGaeC++k/yZbzTU2ST64EukfpPENQmqEZxaK9v1+7etK+qnCRKOnDyjsE= | |
生命药水 | 999抖 | CwaE5Zyq2ZvwgA4S9udpz1BTWMAM41FRkMN5WI5J8E7QJEUT6VFZK0USxig= | |
超能喷射 | 1200抖 | P7zDZzpeO215SpUptB+aURb1+zC14UC9MY1+MHszKoF0p5gzYk8CNEbey60= | |
稀有宝箱 | 3000抖 | rROiXLcY2saGvxHt3fAkYbWvbbikhEzbo0wpI794zEv+A2SCLrkNKYZEVuE= |
特殊礼物
礼物名称 | 价值抖币 | 礼物icon | 礼物ID | 备注 |
幸运魔方 | 1抖 | /mVCtA5npZSbhJezM2S3QxK4bMlMPz2AKpE0LdaD86RO5W5qSo3q0k0prDE= | 详见幸运魔方介绍部分 |
FAQ
Q:添加礼物效果描述后,还需要保留玩法内的规则贴纸吗?
需要,玩法内依然需要设置贴纸向观众展示规则。
Q:上传新包体后,旧版本的礼物配置后受影响吗?
不会,礼物配置会和包体版本对应生效。