文档

消息使用前必读

更新时间:

本文将为您介绍在使用低代码音视频工厂中消息能力时,您需要先了解的基本概念以及常见问题。

消息类型介绍

低代码音视频工厂支持弹幕消息和自定义消息:

  • 弹幕消息是一种简单文本聊天消息,适用于电商直播中的弹幕互动聊天、在线课堂的文字讨论区、文字聊天室互动等场景。

  • 自定义消息是低代码音视频工厂提供的一种房间内消息广播推送的信令通道,灵活性较高,您可以基于自定义消息实现直播间内发红包、送礼物、推送商品卡片等互动功能。

两类消息的主要对比如下:

消息类型

弹幕消息

自定义消息

适用场景

  • 电商直播中的弹幕互动聊天

  • 在线课堂文字讨论区

  • 文字聊天室互动

  • 直播间发红包、送礼物、推送商品卡片

  • 语音消息

推送能力

支持房间内广播

支持房间内广播、单点推送

支持的格式

普通文字消息

格式自定义

消息长度限制

默认1024个字符

默认2048个字符

调用频率QPS

100

100

安全审核

默认对文字内容进行审核

默认不进行审核

消息存储

默认存储,且存储时长不过期

默认不存储

消息拉取

支持按时间轴顺序拉取弹幕消息

未开放对应API

禁言管控

可通过禁言管控实现管理,可以参考禁言相关API

自定义消息不受到禁言影响

数据统计

提供弹幕数统计,可参考相关查询直播统计数据

未开放对应API

常见问题

1. 如何实现发送图片、语音消息?

您可以通过自定义消息实现图片和语音消息的发送。

  • 发送图片消息时,您可以将需要发送的图片URL设置为自定义消息的消息体进行发送。

  • 发送语音消息时,您可以将语音消息录制转码后的数据设置为自定义消息的消息体进行发送。

2. 发送弹幕消息时,如何设置发送用户的昵称和头像?

昵称:发送弹幕消息时的昵称默认获取的是发送的用户在进入房间时设置的用户昵称。当您通过服务端API发送弹幕消息发送弹幕消息时(比如模拟机器人发送),可以通过设置SenderNick字段指定发送人的昵称。

如果用户退出房间后,更换昵称重新进入房间,发送弹幕的昵称会在30秒后生效。

头像:您可以通过设置发送弹幕消息中的扩展字段extension设置用户的头像信息。客户端监听到对应的消息后进行头像渲染。

3. 弹幕消息或者自定义消息的内容会有安全检查吗?

低代码音视频工厂服务端会默认对弹幕消息中的文本内容进行文本安全检查,拦截政治敏感、色情和常见辱骂等相关内容,服务端不会发送被拦截的内容。

如果您的服务端希望了解哪些弹幕消息被安全拦截,可以通过回调的方式获取审核的结果,具体请参考互动消息审核

如果默认的文本安全检查不满足您的业务需求,您可以通过定义自定义敏感词的方式灵活定制安全检查策略,具体请参考创建敏感词

4. 弹幕消息能转存到我自己的服务端存储吗?

您可以通过在控制台勾选消息转存回调来实现上述功能,具体请参考消息转存回调

5. 对弹幕消息或者自定义消息的QPS使用有限制吗?

默认的QPS限制都是100次/秒,超过这个限制会被限流。请您评估好调用量,避免影响您的业务。

6. 弹幕消息和自定义消息的延时和到达率是怎么样的?

弹幕消息和自定义消息的延时和到达率与发送时房间同时在线的人数相关。低代码音视频场景在单房间1万人在线以下时保证秒级到达,具体的推送策略如下。

低代码音视频工厂服务端在t时刻收到发消息请求后,会立即给房间内在线的用户进行推送,并等待客户端响应,逻辑如下:

  1. 客户端向服务端响应200状态码,则表示推送成功。

  2. 客户端响应非200状态码或者超过3秒钟未收到客户端响应,则服务端会认为推送失败;并立即进行重推,并按照同样策略等待客户端响应。

  3. 重试上述步骤,直到客户端向服务端响应200状态码标识推送成功。

  4. 或者距离服务端收到消息的时刻t超过30秒,此时服务端认为客户端离线,不会再向该客户端推送这条消息。

如果单房间超过1万人在线,可能会由于默认资源限制导致消息延迟增大或者丢失等现象。如果您业务上有单场直播超过1万人同时在线观看并且需要大规模收发消息的场景,请在客户对接群中联系技术支持同学进行资源评估。

7. 收到的消息重复如何处理?

客户端SDK已经增加了消息去重的逻辑处理,请升级客户端SDK至1.6.0版本及以后。

8. 客户端发送弹幕消息/自定义消息失败,怎么排查?

根据发送失败返回的错误信息对照客户端误码表进行问题排查,如果找不到结果,请在对应客户技术支持群中联系技术支持同学。

9. 客户端收不到弹幕消息/自定义消息,怎么排查?

当客户端收不到发送的弹幕/自定义消息时,按照如下步骤去排查:

  1. 请先检查下客户端接入流程是否符合预期,以互动直播低代码场景接入Android为例,具体参考:Android端集成

  2. 判断对应的用户是否登录并且依旧在线。

  3. 如果是弹幕消息没有收到,请确保是否在低代码音视频工厂控制台勾选了消息转存回调。勾选该回调后,弹幕消息会转发到您填写的回调地址,而不会进行下行推送。关于消息转存,您可以参考消息转存回调

  • 本页导读 (1)