关于聊天:Android实现实时视频聊天功能｜源码-Demo-分享

疫情期间，很多线下流动转为线上举办，实时音视频的需要剧增，在视频会议，在线教育，电商购物等泛滥场景成了“生存新常态”。

本文将教你如何通过即构ZEGO 音视频 SDK 在Android端搭建实时视频通话能力。即构音视频SDK提供100+种行业解决方案，RTC 每月赠送10000分钟收费时长，提供收费RTC SDK 接入体验。

接下来咱们看看残缺的Android实时视频聊天实现流程。

1 Android端音视频SDK筹备环境

在开始集成 ZEGO Express SDK 前，请确保开发环境满足以下要求：

Android Studio 2020.3.1 或以上版本。

Android SDK 25、Android SDK Build-Tools 25.0.2、Android SDK Platform-Tools 25.x.x 或以上版本。

Android 4.4 或以上版本，且反对音视频的 Android 设施。

Android 设施曾经连贯到 Internet。

2 实时音视频我的项目筹备

2.1 创立实时音视频我的项目

进入即构官网，在【ZEGO控制台】创立我的项目，并申请无效的 AppID，这一步很要害，appid为利用的惟一标识，如身份证号，是利用的身份证明，用于明确你的我的项目及组织身份。zego 音视频云提供的服务也是基于APP ID；

App ID的获取形式很简略，只需3～5分钟，在即构官网-我的我的项目-创立即可。创立的我的项目信息可用于音视频 SDK的集成和配置；

2.2 Token 鉴权

登录房间时必须应用 Token 鉴权，可参考 Token 鉴权教程。

为了不便开发阶段的调试，开发者可间接在 ZEGO 控制台获取长期 Token（有效期为 24 小时）来应用，详情请参考控制台（新版） - 项目管理中的 “我的项目信息”。

3 ZEGO 音视频 SDK 集成

3.1 我的项目设置

开始集成前，可参考如下步骤设置你的我的项目；

如已有我的项目，本步骤可疏忽。

如需新建我的项目，可依照以下步骤创立你的新我的项目：

1.关上 Android Studio，抉择 “File > New > New Project” 菜单。

2.填写我的项目名及我的项目存储门路。

3.其它依照默认设置，单击 “Next”，最初单击 “Finish” 实现新工程创立。

3.2 导入 ZEGO 音视频 SDK

目前反对的平台架构包含：armeabi-v7a、arm64-v8a、x86、x86_64。

在实现根本的实时音视频性能之前，需确保获取的ZEGO 音视频 sdk为最新版本，保障音视频性能体验为最优；

- 应用 JitPack 主动集成 SDK

进入我的项目根目录，关上 “build.gradle” 文件，在 “allprojects” 中退出如下代码。

...allprojects {    repositories {        maven { url 'https://www.jitpack.io' }        google()        jcenter()    }}

进入 “app” 目录，关上 “build.gradle” 文件，在 “dependencies” 中增加 implementation 'com.github.zegolibrary:express-video:2.+'，这样能获取到最新的版本。

...dependencies {    ...    implementation 'com.github.zegolibrary:express-video:2.+'}

4 音视频SDK 设置权限

以上步骤集成已实现，为保障音视频 SDK运行成果更佳，须要在利用中设置所需的权限，步骤如下：

进入 “app/src/main” 目录，关上 “AndroidManifest.xml” 文件，增加权限。

<!-- SDK 必须应用的权限 --><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><uses-permission android:name="android.permission.RECORD_AUDIO" /><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.CAMERA" /><uses-permission android:name="android.permission.BLUETOOTH" /><uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" /><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><!-- App 须要应用的局部权限 --><uses-permission android:name="android.permission.READ_PHONE_STATE" /><uses-permission android:name="android.permission.WAKE_LOCK" /><uses-feature    android:glEsVersion="0x00020000"    android:required="true" /><uses-feature android:name="android.hardware.camera" /><uses-feature android:name="android.hardware.camera.autofocus" />

因为 Android 6.0 在一些比拟重要的权限上要求必须申请动静权限，不能只通过 “AndroidMainfest.xml” 文件申请动态权限。因而还须要参考执行如下代码，其中 “requestPermissions” 是 “Activity” 的办法。

String[] permissionNeeded = {    "android.permission.CAMERA",    "android.permission.RECORD_AUDIO"};if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {    if (ContextCompat.checkSelfPermission(this, "android.permission.CAMERA") != PackageManager.PERMISSION_GRANTED ||        ContextCompat.checkSelfPermission(this, "android.permission.RECORD_AUDIO") != PackageManager.PERMISSION_GRANTED) {        requestPermissions(permissionNeeded, 101);    }}

具体的权限阐明如下：

其中非必要权限 “android.permission.READ_PHONE_STATE” 仅用于实现音视频 SDK 的打断事件处理，因而只需在 AndroidMainfest.xml 文件中进行申明即可，不须要动静申请（业务方有需要则另外解决）。

5 避免混同代码

在 “proguard-rules.pro” 文件中，为 SDK 增加 -keep 类的配置，避免混同 SDK 公共类名称。

-keep class **.zego.**{*;}

至此，咱们曾经实现了基于Android 端ZEGO SDK的主动集成，已实现了音视频聊天的根底能力。接下来可在此基础上实现在线KTV，云健身，线上剧本杀等当下实时音视频热门玩法。

接下来的内容，我将给大家分享实时音视频的罕用性能，如Token 鉴权，创立房间，一对一视频通话等；

6 Android端视频通话实现流程

用户通过 ZEGO Express SDK 进行视频通话的根本流程为：

用户 A、B 退出房间，用户 B 预览并将音视频流推送到 ZEGO 云服务（推流），用户 A 收到用户 B 推送音视频流的告诉之后，在告诉中播放用户 B 的音视频流（拉流）。

整个音视频通话推拉流过程的 API 调用时序如下图：

6.1 音视频 SDK 初始化

1. 创立音视频聊天界面

依据场景须要，为你的我的项目创立视频通话的用户界面。咱们举荐你在我的项目中增加如下元素：

- 本地视频窗口

- 远端视频窗口

- 完结通话按钮

界面代码示例：

<?xml version="1.0" encoding="utf-8"?><RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    xmlns:tools="http://schemas.android.com/tools"    android:layout_width="match_parent"    android:layout_height="match_parent"    tools:context=".Playing">    <TextureView        android:id="@+id/logView"        android:layout_width="match_parent"        android:layout_height="50dp"        android:layout_alignParentTop="true"/>    <TextureView        android:id="@+id/previewView"        android:layout_width="match_parent"        android:layout_height="match_parent"        android:layout_below="@id/logView"        android:layout_alignParentBottom="true"        android:layout_alignParentLeft="true"/>    <TextView        android:id="@+id/roomIDTextView"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:text=""        android:layout_margin="10dp"        android:textColor="@color/black"        android:textSize="12sp"        android:layout_below="@+id/logView"/>    <TextView        android:id="@+id/userIDTextView"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:text=""        android:layout_margin="5dp"        android:textColor="@color/black"        android:textSize="12sp"        android:layout_below="@+id/roomIDTextView"/>    <TextView        android:id="@+id/publishStreamIDTextView"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:text=""        android:layout_margin="5dp"        android:textColor="@color/black"        android:textSize="12sp"        android:layout_below="@+id/userIDTextView"/>    <Button        android:id="@+id/stopButton"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:text="Stop"        android:textSize="15sp"        android:layout_alignParentBottom="true"        android:layout_marginBottom="30dp"        android:layout_centerHorizontal="true"/>    <TextureView        android:id="@+id/playView"        android:layout_width="108dp"        android:layout_height="192dp"        android:layout_below="@id/logView"        android:layout_alignParentRight="true"        android:layout_margin="10dp"/></RelativeLayout>

2. 创立引擎

调用 createEngine 接口，将申请到的 AppID 传入参数 “appID” ，创立引擎单例对象。

注册回调，可将实现了 IZegoEventHandler 的对象（例如 “self”）传入参数 “eventHandler”。

// 创立引擎，通用场景接入，并注册 self 为 eventHandler 回调// 不须要注册回调的话，eventHandler 参数能够传 null，后续可调用 "setEventHandler:" 办法设置回调ZegoEngineProfile profile = new ZegoEngineProfile();profile.appID = ;  // 请通过官网注册获取，格局为：1234567890Lprofile.scenario = ZegoScenario.GENERAL;  // 通用场景接入profile.application = getApplication();engine = ZegoExpressEngine.createEngine(profile, null);

6.2 登录视频聊天房间

- 登录视频聊天房间时必须应用 Token 鉴权，否则会登录失败。

- 为了不便开发阶段的调试，开发者可间接在 ZEGO 控制台获取长期 Token（有效期为 24 小时）

来应用，详情请参考控制台（新版） - 项目管理中的 “我的项目信息”。

你能够调用 loginRoom 接口登录房间。roomID 和 user 的参数由您本地生成，然而须要满足以下条件：

- 同一个 AppID 内，需保障 “roomID” 全局惟一。

- 同一个 AppID 内，需保障 “userID” 全局惟一，倡议开发者将 “userID” 与本人业务的账号零碎进行关联。

// ZegoUser 的构造方法 public ZegoUser(String userID) 会将 “userName” 设为与传的参数 “userID” 一样。“userID” 与 “userName” 不能为 “null” 否则会导致登录房间失败。 ZegoUser user = new ZegoUser("user1");// 只有传入 “isUserStatusNotify” 参数取值为 “true” 的 ZegoRoomConfig，能力收到 onRoomUserUpdate 回调。ZegoRoomConfig roomConfig = new ZegoRoomConfig();//token 由用户本人的服务端生成，为了更快跑通流程，也能够通过即构控制台获取长期的音视频 tokenroomConfig.token = "xxxx";roomConfig.isUserStatusNotify = true;// 登录房间engine.loginRoom("room1", user, roomConfig);

登录状态（房间连贯状态）回调

调用登录房间接口之后，您可通过监听 onRoomStateUpdate 回调实时监控本人在本房间内的连贯状态。

@Overridepublic void onRoomStateUpdate(String roomID, ZegoRoomState state, int errorCode, JSONObject extendedData) {    super.onRoomStateUpdate(roomID, state, errorCode, extendedData);    if(state == ZegoRoomState.CONNECTED){       //房间连贯胜利    } else if(state == ZegoRoomState.CONNECTING) {       //房间连贯中    }  else if(state == ZegoRoomState.DISCONNECTED) {       //未连贯或房间连贯断开    }        }

6.3 预览本人的视频画面，并推送到 ZEGO 音视频云

1. 预览本人的画面

如果心愿看到本端的画面，可调用 startPreview 接口设置预览视图，并启动本地预览。

// 设置本地预览视图并启动预览，视图模式采纳 SDK 默认的模式，等比缩放填充整个 ViewZegoCanvas previewCanvas = new ZegoCanvas(previewView);engine.startPreview(previewCanvas);

2. 将本人的音视频流推送到 ZEGO 音视频云

在用户调用 loginRoom 接口后，能够间接调用 startPublishingStream 接口，传入 “streamID”，将本人的音视频流推送到 ZEGO 音视频云。您可通过监听 onPublisherStateUpdate 回调通晓推流是否胜利。

“streamID” 由您本地生成，然而须要保障：

同一个 AppID 下，“streamID” 全局惟一。如果同一个 AppID 下，不同用户各推了一条 “streamID” 雷同的流，后推流的用户推流失败。

此处示例在调用 loginRoom 接口后立刻进行推流。在实现具体业务时，您可抉择其余机会进行推流，只有保障先调用 loginRoom 即可。

// 用户调用 loginRoom 之后再调用此接口进行推流// 在同一个 AppID 下，开发者须要保障“streamID” 全局惟一，如果不同用户各推了一条 “streamID” 雷同的流，后推流的用户会推流失败。 engine.startPublishingStream("stream1");

6.4 拉取其余用户的音视频

进行视频通话时，咱们须要拉取到其余用户的音视频。

在同一房间内的其余用户将音视频流推送到 ZEGO 音视频云时，咱们会在 onRoomStreamUpdate 回调中收到音视频流新增的告诉，并能够通过 ZegoStream 获取到某条流的 “streamID”。

咱们能够在该回调中，调用 startPlayingStream，传入 “streamID” 拉取拉取播放该用户的音视频。您可通过监听 onPlayerStateUpdate 回调通晓是否胜利拉取音视频。

// 房间内其余用户推流/进行推流时，咱们会在这里收到相应流增减的告诉public void onRoomStreamUpdate(String roomID, ZegoUpdateType updateType, ArrayList<ZegoStream> streamList, JSONObject extendedData) {    super.onRoomStreamUpdate(roomID, updateType, streamList, extendedData);    //当 updateType 为 ZegoUpdateType.ADD 时，代表有音视频流新增，此时咱们能够调用 startPlayingStream 接口拉取播放该音视频流    if (updateType == ZegoUpdateType.ADD) {         // 开始拉流，设置远端拉流渲染视图，视图模式采纳 SDK 默认的模式，等比缩放填充整个             View        // 如下 playView 为 UI 界面上 View.这里为了使示例代码更加简洁，咱们只拉取新增的音视频流列表中第的第一条流，在理论的业务中，倡议开发者循环遍历 streamList ，拉取每一条音视频流         ZegoStream stream = streamList.get(0);        playStreamID = stream.streamID;        ZegoCanvas playCanvas = new ZegoCanvas(playView);        engine.startPlayingStream(playStreamID, playCanvas);    }}

7 视频聊天运行成果

实时音视频的根底性能已实现，接下来咱们运行下成果，1步疾速测验成绩。

step1.与好友一起装置编译好的App，在手机上能够看到对方并进行视频通话互动。

实现以上，阐明你胜利啦！

Enjoy与好友的欢畅时光!

获取音视频SDK开发文档、Demo、技术帮忙

- 获取音视频SDK 开发文档、Demo，可拜访即构文档核心.

- 获取更多音视频SDK优惠活动热门产品，可提交信息分割商务.

注册即构ZEGO开发者帐号，疾速开始。