语音直播场景的使用主要有两种,在同一语音直播间内:
单主播语音直播,1 个主播发布语音,观众播放语音。
多主播语音直播,主播与观众连麦,进行实时语音互动。
以 2 人间的实时语音为例,主要流程如下:
请注意:
上面流程中以 2 名房间成员间的语音直播为例,实际上 Zego SDK 支持多人实时语音。建议开发者按需设计。
为了便于开发者更快理解 AudioLive 中的逻辑,下述每节会将功能核心源码片段挑出来并加以讲解。开发者亦可直接阅读 AudioLive 源码,两者是一致的。
单主播直播时,一个房间内仅有一个主播,不支持主播与观众连麦互动。
请注意,下列操作前,请确保各成员均登录至同一房间。
房间内成员均可推流,发布直播。语音直播场景下,发布直播应该使用手动发布,
如果开发者想进一步了解手动发布直播,请参考:快速开始-手动发布直播
请注意:
如果用户选择自动发布直播,登录成功后,SDK 会自动开始推流,用户无需手动触发。
如果开发者想进一步了解自动发布直播,请参考:快速开始-自动发布直播
AudioLive 中手动发布直播相关源码片段演示如下,仅供参考:
SessionActivity.java
// 用户主动点击发布直播按钮
private void handleCommunicate() {
if (!PrefUtils.isManualPublish()) return;
if (hasPublish) {
zegoAudioRoom.stopPublish();
btnCommunicate.setText(R.string.zg_start_communicate);
ZegoAudioStream myStream = new ZegoAudioStream(publishStreamId, PrefUtils.getUserId(), PrefUtils.getUserName());
streamAdapter.removeItem(myStream);
publishStreamId = null;
hasPublish = false;
tvEventTips.setText(R.string.zg_tip_stop_publish);
} else {
btnCommunicate.setEnabled(false);
zegoAudioRoom.startPublish();
}
}
房间内成员均可播放直播,登录房间成功后,SDK 会自动拉流播放直播。用户无需手动触发拉流。
如果开发者想进一步了解播放直播,请参考:快速开始-播放直播
音频通话结束后的操作主要是登出房间、清理视图或数据等。开发者可按需调用。
AudioLive 中结束音频直播相关源码片段演示如下,仅供参考:
SessionActivity.java
// 用户退出 SessionActivity 界面时
@Override
public void onBackPressed() {
if (hasLogin) {
logout();
}
removeCallbacks();
super.onBackPressed();
}
// 退出房间
private void logout() {
boolean success = zegoAudioRoom.logoutRoom();
streamAdapter.clear();
hasLogin = false;
hasPublish = false;
btnAux.setEnabled(false);
btnMute.setEnabled(false);
btnRecorder.setEnabled(false);
btnMicrophone.setEnabled(false);
btnCommunicate.setText(R.string.zg_start_communicate);
if (PrefUtils.isManualPublish()) {
btnCommunicate.setEnabled(false);
}
MainActivity.ZGLog.d("logout: %s", success);
}
// 移除所有回调
private void removeCallbacks() {
zegoAudioRoom.setAudioRoomDelegate(null);
zegoAudioRoom.setAudioPublisherDelegate(null);
zegoAudioRoom.setAudioPlayerDelegate(null);
zegoAudioRoom.setAudioLiveEventDelegate(null);
zegoAudioRoom.setAudioRecordDelegate(null);
zegoAudioRoom.setAudioDeviceEventDelegate(null);
zegoAudioRoom.setAudioPrepareDelegate(null);
zegoAudioRoom.setAudioAVEngineDelegate(null);
}
多主播直播是主播与观众连麦,使观众也成为主播的互动功能,类似实时语音功能。
多主播直播的推流、拉流流程,同单主播一致,不再赘述。
但多主播比单主播多了一个信令交互的过程。开发者可以通过该过程,设计逻辑,决定是否允许房间内拉流的成员推流,成为主播。该信令交互由开发自行实现,SDK 仅提供推拉流的能力。
请注意,AudioLive 中没有使用信令交互决定其他用户是否可以推流。用户进入房间即可自动或手动推流。
联系我们
文档反馈