功能实现流程

下载pdf
更新时间:2019-09-27 10:07

实时语音场景的典型之一是,同一房间中的成员进行实时语音对话。

以 2 人间的实时语音为例,主要流程如下:

请注意:

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

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

1 登录房间

用户间进行实时语音对话前,需要先登录到同一个房间。

AudioLive 中登录相关源码片段演实时语音示如下,仅供参考:

SessionActivity.java

// 登录房间,登录成功后会自动拉流
private void login(String roomId) {
    tvEventTips.setText(getString(R.string.zg_tip_begin_login_room, roomId));
    zegoAudioRoom.setUserStateUpdate(true);
    boolean success = zegoAudioRoom.loginRoom(roomId, new ZegoLoginAudioRoomCallback() {
        @Override
        public void onLoginCompletion(int state) {
            MainActivity.ZGLog.d("onLoginCompletion: 0x%1$x", state);

            if (state == 0) {
                hasLogin = true;

                btnAux.setEnabled(true);
                btnMute.setEnabled(true);
                btnRecorder.setEnabled(true);
                btnMicrophone.setEnabled(true);

                if (PrefUtils.isManualPublish()) {
                    btnCommunicate.setEnabled(true);
                }

                tvEventTips.setText(R.string.zg_tip_login_success);
            } else {
                Toast.makeText(SessionActivity.this, String.format("Login Error: 0x%1$x", state), Toast.LENGTH_LONG).show();
                tvEventTips.setText(getString(R.string.zg_tip_login_failed_state, state));
            }
        }
    });
    MainActivity.ZGLog.d("login: %s", success);
    if (!success) {
        tvEventTips.setText(R.string.zg_tip_login_failed);
    }
}

2 发布直播

房间内成员均可发布直播,但发布直播有两种方式:

自动发布直播,请参考:快速集成-自动发布直播 手动发布直播,请参考:快速集成-手动发布直播

请注意,如果用户选择自动发布直播,登录成功后,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();
    }
}

3 播放直播

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

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

4 结束音频直播

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

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);
}