实时语音
  • iOS
  • Android
  • Windows : C++
  • 概述
  • 限制说明
  • SDK 下载
  • 快速开始
  • 进阶功能
  • API 文档
  • 常见错误码
  • 语音通话
  • 语音直播
  • 文档中心
  • 实时语音
  • 语音直播
  • 功能实现流程

功能实现流程

更新时间:2021-04-25 20:25

语音直播场景的使用场景主要有 2 种,在同一语音直播间内:

  1. 单主播语音直播,1 个主播发布语音,观众播放语音。
  2. 多主播语音直播,主播与观众连麦,进行实时语音互动。

以 2 人间的语音直播为例,流程如下:

请注意:

  1. 上面流程中以 2 名房间成员间的语音直播为例,实际上 Zego SDK 支持多人语音直播。建议开发者按需设计。

  2. 为了便于开发者更快理解 AudioLive 中的逻辑,下述每节会将功能核心源码片段挑出来并加以讲解。开发者亦可直接阅读 AudioLive 源码,两者是一致的。

1 单主播语音直播

单主播直播时,一个房间内仅有一个主播,不支持主播与观众的连麦互动。

请注意,下列操作前,请确保各成员均登录至同一房间。

1.1 主播推流

房间内成员均可推流,发布直播。语音直播场景下,发布直播应该使用手动发布

如果开发者想进一步了解手动发布直播,请参考:快速开始-手动发布直播

请注意:

  1. 如果用户选择自动发布直播,登录成功后,SDK 会自动开始推流,用户无需手动触发。

  2. 如果开发者想进一步了解自动发布直播,请参考:快速开始-自动发布直播

AudioLive 中手动发布直播相关源码片段演示如下,仅供参考:

ZegoMainDialog.cpp

// 用户主动点击发布直播按钮
void ZegoAudioLive::OnButtonClickedPublish()
{
    if (ui.m_switchStartPublish->text() == QStringLiteral("进入"))
    {
       ...

        //不能重复点击
        ui.m_switchStartPublish->setEnabled(false);

        //获取SessionID
        m_sessionID = ui.m_edSessionID->text();

        //以当前时间去生成流ID
        QTime currentTime = QTime::currentTime();
        int ms = currentTime.msec();
        QString strStreamId;
        strStreamId = QString(QStringLiteral("s-windows-%1-%2")).arg(m_strEdUserId).arg(ms);
        m_strPublishStreamID = strStreamId;

        AUDIOROOM::LoginRoom(m_sessionID.toStdString().c_str());
        AUDIOROOM::SetManualPublish(isManual);
        addLogString(QStringLiteral("开始加入session: %1").arg(m_sessionID));


    }

    ...

    else if (ui.m_switchStartPublish->text() == QStringLiteral("开始直播"))
    {
        AUDIOROOM::StartPublish();
        ui.m_switchStartPublish->setEnabled(false);
    }

}

1.2 观众拉流

房间内成员均可播放直播,登录房间成功后,SDK 会自动拉流播放直播。用户无需手动触发拉流。

如果开发者想进一步了解播放音频直播,请参考:快速开始-播放直播

1.3 结束音频直播

音频通话结束后的操作主要是登出房间、清理视图或数据等。开发者可按需调用。

AudioLive 中结束音频直播相关源码片段演示如下,仅供参考:

ZegoMainDialog.cpp

// 关闭实时语音通话Dialog
void ZegoAudioLive::OnClose()
{
    streamList.clear();
    AUDIOROOM::LogoutRoom();
    this->close();
}

2 多主播语音直播

多主播直播是主播与观众连麦,使观众也成为主播的互动功能,类似实时语音功能。

多主播直播的推流、拉流流程,同单主播一致,不再赘述。

但多主播比单主播多了一个信令交互的过程。开发者可以通过该过程,设计逻辑,决定是否允许房间内拉流的成员推流,成为主播。该信令交互由开发自行实现,SDK 仅提供推拉流的能力。

请注意,AudioLive 中没有使用信令交互决定其他用户是否可以推流。用户进入房间即可自动或手动推流。

本篇目录