实现极速直播

  • Windows

更新时间

了解如何快速接入实时互动 RTC,完成环境准备、参数配置、示例运行和核心流程验证。

本文介绍如何集成声网实时互动 SDK,在基础的音视频互动能力上进行少量代码修改,即可实现一个极速直播 App。 极速直播是区别于互动直播的一种直播场景,两者的区别在于观众端的延时级别:

  • 互动直播:观众端的延时级别为超低延时,以便满足主播和观众需要频繁进行音视频互动的需求。
  • 极速直播:观众端的延时级别为低延时,可以满足主播与观众较低频率的音视频互动,或者回应观众文字、弹幕及打赏信息。

更多关于极速直播的延时指标、同步性、互动体验以及费用介绍,详见直播场景区别和计费说明。

前提条件

已在你的项目中实现基本的实时音视频功能。详见实现音视频互动。

实现步骤

将直播场景下观众端的延时级别修改为低延时,即可将一个互动直播修改为极速直播,有以下两种实现方式:

  • 在调用 joinChannel [2/2] 加入频道时,在 options 参数中将 clientRoleType 参数设置为 CLIENT_ROLE_AUDIENCE(观众);将 audienceLatencyLevel 参数设置为 AUDIENCE_LATENCY_LEVEL_LOW_LATENCY(低延时)。
  • 在加入频道后,调用 setClientRole [2/2] 方法,将 role 参数设置为 CLIENT_ROLE_AUDIENCE(观众);将 options 参数设置为 AUDIENCE_LATENCY_LEVEL_LOW_LATENCY(低延时),示例代码如下:
ChannelMediaOptions option;
// 设置频道场景为直播
option.channelProfile = CHANNEL_PROFILE_LIVE_BROADCASTING;
// 设置用户角色为观众
option.clientRoleType = CLIENT_ROLE_AUDIENCE;
// 将观众端延时级别设为低延时
option.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_LOW_LATENCY;
// 自动订阅频道内的音频流
option.autoSubscribeAudio = true;
// 自动订阅频道内的视频流
option.autoSubscribeVideo = true;
// 填入你在控制台获取的临时 Token 加入频道
int ret = m_rtcEngine->joinChannel(token, cs2utf8(strChannelName).c_str(), 0, option);

将直播场景下观众端的延时级别修改为低延时,即可将一个互动直播修改为极速直播,有以下两种实现方式:

  • 在调用 JoinChannel [2/2] 加入频道时,在 options 参数中将 clientRoleType 参数设置为 CLIENT_ROLE_AUDIENCE(观众);将 audienceLatencyLevel 参数设置为 AUDIENCE_LATENCY_LEVEL_LOW_LATENCY(低延时)。

  • 在加入频道后,调用 SetClientRole [2/2] 方法,将 role 参数设置为 CLIENT_ROLE_AUDIENCE(观众);将 options 参数设置为 AUDIENCE_LATENCY_LEVEL_LOW_LATENCY(低延时),示例代码如下:

    ChannelMediaOptions options = new ChannelMediaOptions();
        // 将频道场景设置为直播。
        options.channelProfile.SetValue(CHANNEL_PROFILE_TYPE.CHANNEL_PROFILE_LIVE_BROADCASTING);
        // 将用户角色设置为主播或观众。此处以观众为例。
        options.clientRoleType.SetValue(CLIENT_ROLE_TYPE.CLIENT_ROLE_AUDIENCE);
        // 对于极速直播下的观众,需设置用户级别为 AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY;对于主播,无需此设置。
        options.audienceLatencyLevel.SetValue(AUDIENCE_LATENCY_LEVEL_TYPE.AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY);

后续步骤

本文的示例使用了临时 Token 加入频道。在测试或生产环境中,为确保通信安全,声网推荐使用 Token 服务器来生成 Token,详见使用 Token 鉴权。

参考信息

示例项目

声网提供了开源的示例项目供你参考,你可以前往下载或查看其中的源代码。

常见问题

相关文档