常见问题
收藏我的收藏
前置接入问题
1.1 开发者如何进行接入测试
1.完成前置工作:入驻认证、创建直播玩法、配置相应能力
2.开启私密直播间/普通测试直播间
3.直播中挂载小玩法
a.调用启动/停止/查询任务等接口进行测试
b.启动任务过程中,在直播间发送相关数据,在自己的服务后台验证数据推送结果
4.取消挂载小玩法
5.关掉直播
1.2 消息推送是否支持长连接
一期属于快速验证收益阶段,暂不支持长连接接入。后续平台会看业务发展情况,推动技术升级
启动推送任务问题
2.1 启动任务失败,提示status=5003019,推送任务不符合开启的限制条件
1.传入的房间roomID找不到对应的直播间信息,roomID有误/主播已关播
2.当前玩法未开通对应开放能力
3.当前玩法的推送QPS已经超过了限制策略
2.2 小玩法调试环境下启动任务失败可能是什么原因导致的?
玩法不需要正式上线,通过调试球启动了玩法即可,但需要用主播身份扫码,观众扫码自启动不会记录玩法状态,所以弹幕推送任务开启的时候,判断玩法是未启动状态,从而启动失败
2.3 能否同时启动评论, 礼物, 点赞中的两种或三种监听任务,需要调用多次启动接口吗
目前不支持同时启动多个任务,需要调用多次启动接口
2.4 access_token有效期还有剩余,但是获取roomId的时候却显示已过期
开发者检查access_token刷新策略,重新获取access_token, 前一个token的有效期就会被缩短为5min。
推送数据问题
3.1 突然收不到消息回调
发消息的帐号触发了风控逻辑(存在刷评论等行为)
3.2 根据目前收到的点赞回调数据,文档中提到的payload字段在返回的数据里是没有的,现在返回的数据格式是点赞数据直接作为消息体返回的
payload 指的就是 body 的载荷
3.3 推送秘钥有什么特殊要求吗
开发者生成一个长度小于100的随机ASCII字符串就可以,用于开发者检验签名
3.4 推送失败的数据如何补偿处理
•通过平台的分页查询接口定时主动回查推送失败的数据
◦数据类型限制:当前只有礼物数据支持回查
◦时间限制:24小时内
◦长度限制:暂定10w条
◦注意:补偿数据的查询没有ack机制,需要开发者自行维护补偿状态,比如当前补偿到第几页了,下次该读取第几页
3.5 为什么没有收到推送数据的可能原因
1、没有请求启动推送任务接口或启动失败,调用查询推送状态接口排查。•不存在:任务已经被删除,可能是因为玩法被异常关闭了/或主播已关播。
•未启动:任务还未被启动,需要开发者调用启动任务接口。
2、主播自己的消息会被过滤,只会推送直播间观众的消息。3、只会推送指定的礼物消息、只会推送匹配关键词的评论。确认开发 者后台营收设置下面要设置关键词和礼物。4、发消息的帐号触发了风控逻辑。
签名计算问题
4.1 规则理解有Gap
请先仔细看下规则说明和示例,示例中有拼接后的字符串以及签名后的字符串
4.2 字符串编码问题
注意必须使用UTF-8编码,否则会不一致
4.3 body字符串来源
请直接使用从http读取的body转换成utf8字符串再进行拼接,不要先unmarshal出来再marshal成字符串
4.4 在线工具计算出来的签名和示例不一样
请先区分清楚“byte 值”和“byte 值展示”两个概念网上md5工具计算结果都给你按16进制可视化展示出来,我们要编码的不是这个16进制字符串。要编码的是md5出来的是16个bytes, 对这个字节数组做base64编码。
平台相关问题
5.1 开发配置下未显示礼物/评论/点赞能力配置
请自查玩法分类是否选择的是【直播玩法】若不是,需新建一个玩法并选择【直播玩法】分类;如果期望保留原名,可以将旧玩法的名字改成其他内容,新玩法即可使用对应名字若是,且仍然没有对应配置,请联系接口运营
SDK使用问题
6.1 安卓手机开直播点调试扫码开发工具,调用tt.getRoomInfo返回错误21100,错误信息:errMsg: "getRoomInfo:fail message handler is null"
调用时机过早导致的,可以将调用时机换到onShow里
6.2 调用tt.setClipboardData时提示tt.setClipboardData is not a function,目前小玩法API支持剪贴板功能(tt.setClipboardData)吗
目前小玩法的API是不支持剪贴板功能(tt.setClipboardData),方法能力暂时没有对外开放,不能调用是正常 的PC伴侣端:1.如果只是想让主播复制roomId,可以引导主播在伴侣客户端的右上角=> 更多 => 关于 对话框中复制。
2.如果想让主播在玩法中复制内容,请使用如下临时方法。
const res = tt.getSystemInfoSync();if(res.platform === 'windows') {parent.document.body.style.userSelect = 'text';}tt.showModal({title: '复制的内容',content: '复制的内容'});真机客户端:a. 利用键盘的方式来复制:tt.showKeyboard({ value: '复制的内容' })
6.3 IOS手机悬浮球扫描App二维码,显示“加载失败”?
iOS 2580以及之后的版本已关闭了玩法的可见性,并无法调试。请用 Android 扫码调试。
礼物相关
7.1 礼物置顶的延迟以及未刷新问题
1.当前调用礼物置顶延时不稳定,最长会有10秒左右的延迟,后续平台会优化这个延时
2.需要重新打开礼物面板才能刷新置顶
直播伴侣问题
8.1 伴侣挂载小玩法出现白屏
1.先确认小玩法代码是否已按照文档适配直播伴侣
2.通过调试模式,用scheme打开玩法,此时可打开vConsole查看报错信息
3.以上无法解决问题联系接口运营
8.2 直播伴侣挂载测试的小玩法,获取直播间信息的接口提示“开发者工具暂不支持tt.getRoominfo方法,请在真机上调试该功能”,是否需要做什么?
没有影响,可忽略warning
8.3 直播伴侣下,玩法通过login接口返回的code+code2Session接口拿到的openid和tt.getLiveUserInfo,tt.getUserInfoV2等方法拿到的openid不一样,有什么影响吗?
openId 是 “同一个用户在同一个应用中的唯一标识”,它和uid+appid+aid是对应的。目前伴侣中,通过code2Session拿到的openid是用伴侣的aid生成的,tt.getLiveUserInfo,tt.getUserInfoV2是通过抖音的aid生成的,所以会造成两种方式拿到的openid不一样。如果开发者只用openid做服务存储,可以选择两种方式中的任意一种方式,如果涉及到tt.payDiamondsV3的调用,请使用第二种方式。
8.4 直播伴侣弹幕玩法,点击下载按钮,提示“MD5校验失败”
1.第一种情况:上传包体云端计算的md5有问题,所有主播都提示md5校验失败。需要重新审核提交一次包体。
2.第二种情况:下载的包体资源不完整,个别主播提示md5校验失败,需要手动清除一下本地包体(本地包体路径在右上角玩法设置里)
调试接入问题
9.1 调试过程中,账号被无故封禁?
开发测试阶段,不要把玩法内容放到伴侣投屏出来,未见过的物料,会被安全封禁。
ipad端问题
10.1 用手机能看到直播玩法,但是用iPad看不到了
目前由于横屏会导致部分游戏失真,ipad机型均已被屏蔽
其它问题
