【弹幕玩法】加固能力技术接口文档-对外
文档更新记录
更新记录
更新时间
更新内容
2024/06/12
文档结构修改,文档内容未变化
一、功能说明
在接入稳定加固能力前,需确保已经接入了基础能力直播弹幕玩法技术基础能力接口文档-对外
warning!!!
礼物回查能力需要强制接入,推送链路因为网络等异常情况不能保证100%推送成功,如果因为没有接入回查能力导致礼物消息丢失,需要cp厂商对用户进行补偿快币或者补偿玩法内积分等补偿措施
二、流程概览
推送数据回查
推拉结合提高系统的鲁棒性
在平台提供的基础功能中,平台向cp提供的回调地址推送互动消息。为了提高系统的稳定性,cp可通过推送数据回查接口主动拉取互动消息。
 
cp客户端收到消息ack
加强链路监控
cp服务端在推送互动消息给cp客户端后,需要将cp客户端收到消息的时间戳信息上报给平台,加强平台对cp客户端收到消息的感知。
 
cp客户端展示动效ack
加强链路监控
cp客户端在处理完互动消息后(渲染完出兵等动效),需要将cp客户端展示完消息的时间戳信息上报给平台,加强平台对cp客户端展示消息的感知。
 
三、接口列表
推送消息回查接口
特别提示:
1.目前只支持礼物推送消息回查
2.应该以基础能力中平台推送到cp回调地址的消息为主,调用本接口主动拉取礼物消息作为推送链路异常时的辅助兜底
3.通过uniqueMessageId做消息幂等,cp需要对回查消息做好去重
请求地址
Method:POST
URL:https://open.kuaishou.com/openapi/developer/live/data/interactive/pushdata/query
"Content-Type":"application/json;charset=UTF-8"
请求参数
字段名
数据类型
是否必填
是否参与签名
说明
roomCode
string
快手直播间绑定码,主播在打开小玩法详情时可以获取
timestamp
int(64)
建立连接时间戳,单位毫秒
sign
string
开发者对核心字段签名,签名方式见附录
注意:
app_id需要参与签名
app_secret直接追加在最后
签名的参数需要按首字母排序
pushType
string
推送类型,目前只支持礼物推送消息回查
giftSend-礼物推送;liveComment-评论推送(未开放);liveLike-点赞推送(未开放)
data
string
业务参数,见下表
 
进行中
0/0
速度:0 bytes/s
全部暂停