Android语音通话SDK集成和实现流程(实时语音通话三)

实时语音通话系列文章三。本篇讲述Android环境下如何集成即构科技语音通话SDK，实现语音通话功能流程。

一、SDK集成指引

1、准备环境

请确保开发环境满足以下技术要求：

*
Android Studio 2.1 或以上版本

已经下载好 Android SDK 25、Android SDK Build-Tools 25.0.2、Android SDK
Platform-Tools 25..

Android 版本不低于 4.0.3 且支持音视频的 Android 设备或模拟器(推荐使用真机)

Android 设备已经连接到 Internet

2、下载SDK

请从 ZegoAudioRoom Android
<https://storage.zego.im/downloads/ZegoAudioRoom-Android.zip> 下载 SDK。

如果要实现播放本地音频、视频文件的功能(可用于播放背景音乐，播放MV，播放直播音效等场景)，请下载包含 MediaPlayer 功能的 SDK，请下载
ZegoAudioRoom_MediaPlayer Android
<https://storage.zego.im/downloads/ZegoAudioRoom-MediaPlayer-Android.zip>。

3、集成 SDK

3.1 新建示例工程(此处以新工程为例，如果是集成到已有项目，可忽略此步)

1、打开Android Studio，选择菜单 File–>New–>New Project。

2、填写项目名及项目存储路径。

3、其它按照默认设置一路 Next，最后点击”Finish”完成新工程创建。

3.2 导入 SDK

注意，目前我们仅提供 .jar 和 .so 形式的SDK，暂不支持 .aar
形式的SDK。目前支持的平台架构包括：armeabi、armeabi-v7a、arm64-v8a。

解压 SDK 至项目目录，如 app/zego_libs。

添加SDK引用。打开 app/build.gradle 文件，添加如下内容：

·在 defaultConfig 节点添加 ndk 节点，指定支持的平台类型
ndk { abiFilters 'armeabi' , 'armeabi-v7a', 'arm64-v8a' }

在 android 节点添加 sourceSets 节点，指定 zego jni libs 目录
sourceSets { main { jniLibs.srcDirs = ['zego_libs'] } }

在 dependencies 节点添加
compile fileTree(dir: 'zego_libs', include: ['*.jar'])

添加权限申明。打开 app/AndroidManifest.xml 文件，添加如下内容：
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <
uses-permission android:name="android.permission.READ_LOGS" /> <uses-permission
android:name="android.permission.RECORD_AUDIO" /> <uses-permission android:name=
"android.permission.MODIFY_AUDIO_SETTINGS" /> <uses-permission android:name=
"android.permission.INTERNET" /> <uses-permission android:name=
"android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name=
"android.permission.READ_PHONE_STATE" /> <uses-permission android:name=
"android.permission.PROCESS_OUTGOING_CALLS" /> <uses-permission android:name=
"android.permission.BLUETOOTH" /> <uses-permission android:name=
"android.permission.WRITE_EXTERNAL_STORAGE" /> <uses-permission android:name=
"android.permission.MOUNT_UNMOUNT_FILESYSTEMS" /> <uses-permission android:name=
"android.permission.WAKE_LOCK" />
3.3 使用 SDK

参见 API说明-Android API
<https://www.zego.im/static/docs/API/ZegoAudioRoom/Android/html/index.html>。

二、功能实现流程

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

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


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、发布直播

房间内成员均可发布直播，发布直播有两种方式：自动发布直播和手动发布直播。这里介绍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); }

• « 上一篇：你不能访问此共享文件夹，因为你组织的安全策略阻止未经身份验证的来宾访问（连接共享打印机）
• » 下一篇：计算机组成的基本硬件设备