【新春征文】跨频道流媒体转发技术在商业化落地你必须知道的技术细节

我正在参加「新春」征文活动, 活动连接 https://www.agora.io/cn/community/discussion/0/25358

我们在语音房功能的开发当中,总要少不了PK模块的存在.而这篇技术贴就是介绍声网SDK在跨频道PK场景下的商业化落地的技术细节.

第一个模块:实现流转发的做法

我们要知道,pk是要有两个频道的主播声音的,那如何将A频道的流媒体转发给B频道,而B频道的流媒体如何转发给A频道呢?

先引用下官方的图介绍.并贴下官方文档地址

https://docs.agora.io/cn/live-streaming-premium-legacy/media_relay_android?platform=Android


频道A的A主播将自己的声音转发给B频道.那要同时生成两个机器人,分别是在A频道生成机器人Asrc和B频道生成机器人Adest.

频道B的B主播将自己的声音转发给A频道.那也要同时生成两个机器人,分别是在B频道生成机器人Bsrc和B频道生成机器人Bdest.

所以PK这个事情的流媒体转发是要最少生成4个机器人.


第二个模块:实现流转发的流程,引用下官方的图介绍

在A主播已经加入A频道,B主播已经加入B频道的情况下

即可根据需要转发的时机来进行转发,比如可以用信令告知发起流转发,也就是给AB两个频道的主播同时告知流转发,A将自己的流转发给B,B同时也将自己的流转发给A这样就可以实现,自己的频道又对方的声音这个效果了.

A主播发起跨频道连麦,会在本频道加入一个观众机器人负责接收A主播的流,然后在B频道加入一个推流机器人把前面观众(A频道的)机器人接收到的流转发出来。


1)源频道信息:

ChannelMediaInfo srcChannelInfo = new ChannelMediaInfo(channelName, sourceChannelToken, userId); ChannelMediaRelayConfiguration mediaRelayConfiguration = new ChannelMediaRelayConfiguration(); mediaRelayConfiguration.setSrcChannelInfo(srcChannelInfo);

入参:channelName 源频道名称,userId 声网建议设置为0,sourceChannelToken 给源频道机器人根据id=0新生成的token.

srcChannelInfo的Token需要客户服务器在跨频道连麦时下发给发起推流的主播并且注意srcChannelInfo的Token跟srcUID、发起推流主播所在频道的channelName对应;

2)目标频道信息:

ChannelMediaInfo destChannelInfo = new ChannelMediaInfo(channelName, destChannelToken, loginUserAgoraID); mediaRelayConfiguration.setDestChannelInfo(destChannelName, destChannelInfo);

入参:channelName 目标道名称,userId 声网建议设置为与发起转发流的主播id一致,sourceChannelToken 给目标频道机器人根据id新生成的token.

destChannelInfo的Token需要客户服务器在跨频道连麦时下发给发起推流的主播并且注意destChannelInfo的Token跟destUID、目标频道的channelName对应。


3)开始跨频道媒体流转发

engine.startChannelMediaRelay(mediaRelayConfiguration);


4)停止跨频道媒体流转发

engine.stopChannelMediaRelay();


第三个阶段

几个重要的API参考,这个大家看官网即可.文档中可直达连接.

API 参考


第四个阶段

本段是跨频道流媒体转发的最重要的部分,是笔者收集整理的,外部没有如此详细细节的文档.

  • 3.7.0.2版本及以上最多支持将媒体流转发至 64 个目标频道。转发过程中,如果想添加或删除目标频道,可以调用 updateChannelMediaRelay 方法。
  • 在设置源频道信息时,请确保 uid 必须为 0,且用于生成 token 的 uid 也必须为 0
  • 在成功调用 startChannelMediaRelay 方法后,如果想再次调用该方法,必须先调用 stopChannelMediaRelay 方法退出当前的转发状态。
  • 声网留下频道的规则是,只要房间内还有推流用户或者拉流用户任意一个就不会自动销毁频道.
  • 跨频道连麦功能需要联系技术支持开通 onChannelMediaRelayStateChanged(state=3,code=2)
  • 发版说明 https://docs.agora.io/cn/live-streaming-premium-legacy/release_android_video?platform=Android
  • 源token 和 目标token都需要新生成,因为这两个token都是给机器人用的,和之前的频道内的主播没有影响.
  • 当前"跨频道连麦机器人" 还不支持 renew token ,预计2023年q1季度可能会带上.所以建议机器人时间长一点.
  • 可以同时转发多个频道,setDestChannelInfo方法添加多个目标信息就可以.
  • 如果推流身份退出,对应的转发机器人会自动退出
  • 强杀APP后,重连进频道,对应连接的sessionid是有变化的,这时候原来sessionid维持的推流链接就不可用,建议重新生成token转发频道,如果业务场景,在短期(<1min)内恢复要求不重新生成token,用旧的也可以(原机器人1分钟内退出频道),但这不是声网建议的.
  • 实际就是,每次这种情况就重新生成转发机器人就好,(token也是新生成的,机器人也会再新建2个)
  • 那如果鉴于A,B两个频道的老机器人还没退出,再加上A频道重新转发生成的2个机器人,
  • 那就是短期内(或者说一分钟内)房间内就是4+2=6个机器人,不过很快原来的两个机器人就会退出.
  • 目前阶段机器人没有renew token机制,所以主播即将过期,对机器人token有没有影响,主播过期直接,退出机器人.
  • A同时转发给BCDEF频道这种.onChannelMediaRelayEvent这个回调应该是怎么样的:同时跨多频道,在发起的时候,回调都只会是一组。




推荐阅读
相关专栏
开发者实践
150 文章
本专栏仅用于分享音视频相关的技术文章,与其他开发者和声网 研发团队交流、分享行业前沿技术、资讯。发帖前,请参考「社区发帖指南」,方便您更好的展示所发表的文章和内容。