文档

API咨询

更新时间:

通过阅读本文,可以帮您增加对API的了解。

问题概览

直播类事件回调

包含直播状态和推流状态,详见配置回调——直播类事件回调,其差异详见直播状态和推流状态有何区别?

(1)直播状态变更是否有回调接口?

开始直播、结束直播等状态的变更均有回调通知。暂无禁用流和断流超时的回调。

(2)在直播状态回调中, 直播开始和直播结束时间以哪个操作的时间点为准?

直播状态的回调中,直播开始以 PublishLiveRoom - 发布直播的时间为准,直播结束以StopLiveRoom - 停止直播的时间为准。

(3)直播状态回调地址是否有“回调鉴权码”?

暂无回调鉴权码。

(4)推流状态的回调 ,若客户侧没有收到或收到但处理异常,有重试机制么?

关于直播推流状态的回调地址,若访问超时,则会重试。目前超时时间是5秒,重试次数5次,重试间隔1秒。

若客户侧收到但处理异常响应非200状态码,则不会重试。

支持的消息发送接口有哪些?有何区别?

目前,主要提供了两大类消息发送的接口,详见消息的服务端API

(1)弹幕消息

普通的文本消息,适用于直播弹幕、文字聊天室等业务场景,服务端会存储这类消息,可以通过ListComments批量查询历史的弹幕消息。

除此之外,这类消息受到禁言管控影响,被禁言的用户将无法发送该消息。弹幕消息通过CommentId作为唯一ID标识,在调用SendComment - 发送弹幕消息时返回。

(2) 自定义消息

适用于业务服务端想向房间内所有在线用户或者指定用户广播某些事件,比如推送营销卡片、红包、购物车、商品卡片等一些系统通知。

(3)自定义消息与弹幕消息的不同:

  • 服务端不会存储自定义消息,即无法通过ListComments拉取到这类消息。

  • 自定义消息不会收到禁言管控的影响。自定义消息通过MessageId作为唯一ID标识,在调用相关发送API时返回,比如SendCustomMessageToAll

  • 自定义消息有更高的消息到达率要求。

消息审核是否开放接口,支持企业自己审核?

支持,通过配置消息转存回调即可实现企业自己审核。

在完成消息转存回调配置后,经客户端发送的弹幕消息将会依据所填写的回调地址,转发到相应的业务服务端,而不会进行消息审核和下行推送的工作。 业务服务端可以按照自行的业务逻辑对消息内容进行审核,审核通过后可以调用服务端APISendComment将其发送扩散到所有客户端,经服务端API发送的弹幕消息,音视频低代码工厂只会做基本的文本安全审核。

您也可以选择我们的消息审核(互动消息审核结果)。低代码音视频工厂服务端基于阿里云的智能检测算法集成了基础的文本消息审核,会自动拦截一些涉黄、涉政、涉恐的敏感词,被拦截规则命中后的文本消息将不会进行下行推送。您可以配置 互动消息审核结果 来具体感知拦截的具体内容。

数据统计接口有哪些?

目前,提供的是“互动直播”场景的数据统计接口,共有2类:

(1)单场查询直播统计数据

包括直播实时PV数、UV数、在线用户数和互动消息数等,以及用户观看总时长(直播结束后生成)。

(2)用户维度的观看直播时长

包括每个用户的直播观看时长(直播结束后生成)。

  • 本页导读 (1)
文档反馈