产品百科 |RTC SDK 如何将通讯模式升级至互动模式

简介: 您可以通过阅读本文,了解互动模式说明。

音视频通信 RTC(Real-Time Communication)是阿里云覆盖全球的实时音视频开发平台,依托核心音视频编解码、信道传输、网络调度技术,提供高可用、高品质、超低延时的音视频通信服务,让用户快速搭建多端实时应用,适用于在线教育、视频会议、互动娱乐、音视频社交等场景。


产品链接:https://www.aliyun.com/product/rtc


您可以通过阅读本文,了解互动模式说明。

背景信息

针对部分业务场景中,单一频道存在较多用户人数,但主要时间内只有一名主播推流,少量观众需要与主播连麦互动的情况,RTC SDK 加入了新的频道模式(互动模式 AliRtcInteractiveLive)。

通讯模式与互动模式

通讯模式与互动模式的不同,主要体现在以下两点:

  • 频道内最大支持人数不同,通信模式目前默认最多是支持 50*50(即 50 个人同时推拉流),互动模式可以支持最多 2*4000(即 2 个人同时推拉流,其余都是只拉流)。
  • 通信模式没有用户角色的区分,互动模式下增加了用户角色的设置功能,每位加入频道的用户都具备用户角色,分别为:
  • 互动角色(AliRtcChannelProfileInteractiveLive):允许推流,适用于频道中的主播与连麦用户。
  • 观看角色(AliRtcClientRolelive):只能订阅拉流观看,不能推流,适用于普通观众用户。
  • 同时,所有观众角色只能接受到互动角色的加入频道,推流,停止推流,离开频道等状态通知,不会收到其余观众用户的信令消息。

说明

同一个频道里同时只能使用一种频道模式,频道模式由最早加入频道的用户设置,后续加入的用户也需要使用对应的频道模式,否则加入频道失败。例如,最早一个用户使用互动模式进入频道成功后,后续用户如果再使用通信模式加入频道将会失败。当频道内所有用户都离开 2 分钟后,该频道的频道模式会被重置,将由之后首个加入频道的用户设置的频道模式重新确定。

由于前期 SDK 版本不支持频道模式设置,默认以通信模式加入频道。为避免出现上述因频道模式不匹配而加入失败问题,建议业务侧升级使用互动模式后,强制升级用户 SDK 版本,均升级完毕之后再启用,保证同一频道内用户频道模式的统一。

互动模式升级说明

从通信模式升级为互动模式时,推流端和订阅端需要作出以下接入改变:

推流端

  • 主播在加入频道之前,先调用 setChannelProfile 接口设置频道模式为互动模式。
  • 主播可以在加入频道前调用 setClientRole 接口,将用户角色设置为互动角色。主播入会之后自动推流,并且可以调整用户角色信息,当主播加入频道成功后保持自动推流。
  • 主播也可以关闭自动推流模式,在加入频道后,切换角色为互动角色。当主播切换成功后会收到 onUpdateRoleNotify 回调通知,收到回调通知后可以配置需要推流媒体型,调用 publish 接口开始推流。

说明

如果在加入频道成功前设置用户角色,默认初始角色即为设置角色,不会接收到角色变更回调。加入频道成功后再设置用户角色,设置为不同角色成功时会有回调通知。同时业务侧需要记录一下当前的角色参数值,重复设置当前角色不会收到回调。建议业务侧将角色切换和推拉流的逻辑区分开。

用户必须确保在加入频道成功的前提下,进行切换角色操作和推流动作,否则无法切换和推流成功。

订阅端

  • 用户在加入频道之前,先调用 setChannelProfile 接口设置频道模式为互动模式。
  • 用户可以在加入频道前调用 setClientRole 接口,将用户角色设置为观看角色,关闭自动推流,保持自动订阅。
  • 当连麦观众,在加入频道成功后,如果业务场景需要连麦,将设置用户角色为互动角色,设置成功后会收到 onUpdateRoleNotify 回调通知,收到回调通知后可以配置需要推流媒体型,调用 publish 接口开始推流。
    当连麦观众下麦时,关闭推流媒体并停止推流,将用户角色设置回观众角色与普通观众一样,保持订阅拉流即可。
  • 对于普通观众,只需保持观看角色,订阅观看推流媒体,无需其他操作。订阅操作可参考官网相关文档说明。


「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。

image.png


相关文章
|
3月前
|
存储 Java 开发工具
【Azure 存储服务】Azure Blob Storage SDK 升级失败,遇见 Unsatisfied Dependency Exception 和 Unexpected Length Exception
【Azure 存储服务】Azure Blob Storage SDK 升级失败,遇见 Unsatisfied Dependency Exception 和 Unexpected Length Exception
|
3月前
|
文字识别 算法 API
视觉智能开放平台产品使用合集之支持的离线SDK有哪些
视觉智能开放平台是指提供一系列基于视觉识别技术的API和服务的平台,这些服务通常包括图像识别、人脸识别、物体检测、文字识别、场景理解等。企业或开发者可以通过调用这些API,快速将视觉智能功能集成到自己的应用或服务中,而无需从零开始研发相关算法和技术。以下是一些常见的视觉智能开放平台产品及其应用场景的概览。
视觉智能开放平台产品使用合集之支持的离线SDK有哪些
|
3月前
|
SQL Java 关系型数据库
实时数仓 Hologres产品使用合集之如何安装和使用Java SDK
实时数仓Hologres是阿里云推出的一款高性能、实时分析的数据库服务,专为大数据分析和复杂查询场景设计。使用Hologres,企业能够打破传统数据仓库的延迟瓶颈,实现数据到决策的无缝衔接,加速业务创新和响应速度。以下是Hologres产品的一些典型使用场景合集。
|
3月前
|
运维 分布式计算 DataWorks
DataWorks产品使用合集之sdk的下载地址在哪里
DataWorks作为一站式的数据开发与治理平台,提供了从数据采集、清洗、开发、调度、服务化、质量监控到安全管理的全套解决方案,帮助企业构建高效、规范、安全的大数据处理体系。以下是对DataWorks产品使用合集的概述,涵盖数据处理的各个环节。
|
3月前
|
存储 监控 API
视觉智能开放平台产品使用合集之人脸识别服务端的离线SDK是什么
视觉智能开放平台是指提供一系列基于视觉识别技术的API和服务的平台,这些服务通常包括图像识别、人脸识别、物体检测、文字识别、场景理解等。企业或开发者可以通过调用这些API,快速将视觉智能功能集成到自己的应用或服务中,而无需从零开始研发相关算法和技术。以下是一些常见的视觉智能开放平台产品及其应用场景的概览。
28 0
|
4月前
|
消息中间件 分布式计算 DataWorks
DataWorks产品使用合集之如何使用Python和阿里云SDK读取OSS中的文件
DataWorks作为一站式的数据开发与治理平台,提供了从数据采集、清洗、开发、调度、服务化、质量监控到安全管理的全套解决方案,帮助企业构建高效、规范、安全的大数据处理体系。以下是对DataWorks产品使用合集的概述,涵盖数据处理的各个环节。
|
4月前
|
SQL 分布式计算 大数据
MaxCompute产品使用合集之如何使用SDK获取ODPS上的资源文件
MaxCompute作为一款全面的大数据处理平台,广泛应用于各类大数据分析、数据挖掘、BI及机器学习场景。掌握其核心功能、熟练操作流程、遵循最佳实践,可以帮助用户高效、安全地管理和利用海量数据。以下是一个关于MaxCompute产品使用的合集,涵盖了其核心功能、应用场景、操作流程以及最佳实践等内容。
|
4月前
|
JSON Java Serverless
函数计算产品使用问题之如何使用Go SDK从HTTP上下文中提取JSON数据
函数计算产品作为一种事件驱动的全托管计算服务,让用户能够专注于业务逻辑的编写,而无需关心底层服务器的管理与运维。你可以有效地利用函数计算产品来支撑各类应用场景,从简单的数据处理到复杂的业务逻辑,实现快速、高效、低成本的云上部署与运维。以下是一些关于使用函数计算产品的合集和要点,帮助你更好地理解和应用这一服务。
|
5月前
|
消息中间件 负载均衡 网络性能优化
消息队列 MQ产品使用合集之 终端sdk和云端sdk的区别是什么
消息队列(MQ)是一种用于异步通信和解耦的应用程序间消息传递的服务,广泛应用于分布式系统中。针对不同的MQ产品,如阿里云的RocketMQ、RabbitMQ等,它们在实现上述场景时可能会有不同的特性和优势,比如RocketMQ强调高吞吐量、低延迟和高可用性,适合大规模分布式系统;而RabbitMQ则以其灵活的路由规则和丰富的协议支持受到青睐。下面是一些常见的消息队列MQ产品的使用场景合集,这些场景涵盖了多种行业和业务需求。
|
5月前
|
文字识别 小程序 API
视觉智能开放平台产品使用合集之使用SDK进行视频活体检查时,如何将视频URL传递给后端服务
视觉智能开放平台是指提供一系列基于视觉识别技术的API和服务的平台,这些服务通常包括图像识别、人脸识别、物体检测、文字识别、场景理解等。企业或开发者可以通过调用这些API,快速将视觉智能功能集成到自己的应用或服务中,而无需从零开始研发相关算法和技术。以下是一些常见的视觉智能开放平台产品及其应用场景的概览。

热门文章

最新文章