进入环信IM下载页面，选择Android SDK + Demo下载
或者直接去Github下载 克隆代码
同时还要我们自己的UI项目 克隆代码

Android Studio 3.0 或以上版本
Android SDK API 等级 19 或以上
支持 Android 4.4 或以上版本的设备

源码目录如上所示，主要目录如以下介绍
ui是有关所有Activity的具体实现
runtimepermissions是有关运行是有关动态权限的获取的封装
untils是有关工具类的封装
DemoHelper和DemoApplication类是全局单例，用来做一些初始化

选择如下任意一种方式将环信语音SDK集成到你的项目中:

方法一：使用 JCenter 自动集成

在项目的 /app/build.gradle 文件中，添加如下行

dependencies { 
   ... 
   // x.x.x 请填写具体版本号，如：3.7.0 
   // 可通过 SDK 发版说明取得最新版本号 
   api 'com.hyphenate:hyphenate-sdk:x.x.x' 
 } 

方法二：手动复制 SDK 文件

前往SDK载页面，获取最新版的环信音视频SDK，然后解压;
将SDK包内libs路径下的如下文件，拷贝到你的项目路径下
hyphenatechat_3.7.0.jar 文件 /app/libs/
arm-v8a 文件夹 /app/src/main/jniLibs/
armeabi-v7a 文件夹 /app/src/main/jniLibs/
x86文件夹 /app/src/main/jniLibs/
x86_64文件夹 /app/src/main/jniLibs/

用Android Studio 运行examples\ChatDemoUI3.0 或者 连接Android 手机，直接运行即可
需要注意的的是项目build.gradle中的，配置成和自己Android Studio相匹配的 gradle 版本，如下所示

dependencies {
    classpath 'com.android.tools.build:gradle:3.2.1'
 }

环信为管理者与开发者提供了方便易用的App工作台–环信管理后台；
通过环信管理后台可以完成应用创建、服务购买、企业信息修改基础功能;
同时，管理后台也提供了发送消息、用户管理、群组管理、聊天室管理和数据统计等管理监控功能;
有关注册appkey的详细操作大家可以参考注册AppKey 。

打开 Android Studio点击Start a new Android Studio project;
在Select a Project Template界面，选择 Phone and Tablet > Empty Activity;
然后点击 Next;
在 Configure Your Project界面，依次填入以下内容：Name：你的Android项目名称，如 HelloWrold;
Package name:你的项目包的名称，如 package.easemob.helloworld;
Save location：项目的存储路径;
Language：项目的编程语言，如 Java;
Minimum API level：项目的最低 API 等级;(注意本SDK 支持API 19或以上)
然后点击 Finish;
根据屏幕提示，安装可能需要的插件;
上述步骤使用 Android Studio 3.6.2 示例;
你也可以直接参考Android Studio 官网文档创建首个应用。

新建项目完成以后，可以选择以上任何一种导入SDK的方法，把环信音视频SDK集成到你的项目里面，参考导入环信SDK。

根据场景需要，在 /app/src/main/AndroidManifest.xml 文件中添加如下行，获取相应的设备权限;
在清单文件 AndroidManifest.xml 里加入以下权限，以及写上你注册的 AppKey;
权限配置（实际开发中可能需要更多的权限，可参考 Demo）;

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
 xmlns:tools="http://schemas.android.com/tools"
 package="com.a.b">

 <uses-feature android:name="android.hardware.camera" />
 <uses-feature android:name="android.hardware.camera.autofocus" />
 <uses-permission android:name="android.permission.VIBRATE" />
 <uses-permission android:name="android.permission.INTERNET" />
 <uses-permission android:name="android.permission.RECORD_AUDIO" />
 <uses-permission android:name="android.permission.CAMERA" />
 <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
 <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
 <uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS" />
 <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
 <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
 <uses-permission android:name="android.permission.BLUETOOTH" />
 <uses-permission android:name="android.permission.READ_PHONE_STATE" />
 <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
 <uses-permission android:name="com.android.launcher.permission.READ_SETTINGS" />
 <uses-permission android:name="android.permission.BROADCAST_STICKY" />
 <uses-permission android:name="android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS" />
<!-- 设置环信应用的appkey -->
 <meta-data
 android:name="EASEMOB_APPKEY"
 android:value="easemob-demo#chatdemoui" />
 <!-- 声明sdk所需的service -->
 <service
 android:name="com.hyphenate.chat.EMChatService"
 android:exported="true"
 tools:ignore="ExportedService" />
 <service
 android:name="com.hyphenate.chat.EMJobService"
 android:exported="true"
 android:permission="android.permission.BIND_JOB_SERVICE" />

 <!-- 声明sdk所需的receiver -->
 <receiver android:name="com.hyphenate.chat.EMMonitorReceiver">
 <intent-filter>
 <action android:name="android.intent.action.PACKAGE_REMOVED" />

 <data android:scheme="package" />
 ...
</manifest>

注意：关于EASEMOB_APPKEY对应的value获取，在创建应用后，

   申请 AppKey并进行相关配置，环信Demo中AppKey为easemob-demo#chatdemoui;

在 app/proguard-rules.pro 文件中添加如下行，防止混淆环信SDK的代码。

-keep class com.hyphenate.** {*;}
  -dontwarn  com.hyphenate.**
  //3.6.8版本之后移除apache，无需再添加
  -keep class internal.org.apache.http.entity.** {*;}
  //如果使用了实时音视频功能
  -keep class com.superrtc.** {*;}
  -dontwarn  com.superrtc.**

根据场景需要，为你的项目创建语音通话的用户界面。若已有界面，可以直接查看导入类;
可以参考 Demo SDK3.0示例项目的 em_activity_voice_call.xml 文件中的代码。

初始化环信SDK，可以参考使用DemoHelper中的init方法，可设置私有部署地址或者是否允许日志输出，调用如下：

public void init(Context context) {
	EMOptions options = initChatOptions(context);
        appContext = context;
        //可设置私有服务地址
        options.setRestServer("a.b.c"); 
        options.setIMServer("1.2.3.4");
        options.setImPort(8081);
        EMClient.getInstance().init(context, options);
        //打开日志输出
        EMCallManager manager = EMClient.getInstance().callManager();
	EMClient.getInstance().setDebugMode(true);
}

在进行音视频通话前，需要首先登录IM账户，登录过程参见账号登录。

若您还没有IM账户，需要先注册账户，注册过程参见账号注册

账号登录成功后，需要进行音视频通话功能的初始化，设置监听类;
主要有监听呼入通话和监听呼入通话状态;

通过注册相应action的BroadcastReceiver来监听呼叫过来的通话，接到广播后开发者可以调起APP里的通话Activity;
具体调用如下代码所示:

protected void setGlobalListeners(){
    IntentFilter callFilter = new IntentFilter(EMClient.getInstance().
                              callManager().getIncomingCallBroadcastAction());
    if(callReceiver == null){
       callReceiver = new CallReceiver();
     }
     appContext.registerReceiver(callReceiver, callFilter); 
 }
 private class CallReceiver extends BroadcastReceiver { 
     @Override 
     public void onReceive(Context context, Intent intent) {
      // 拨打方username String from = intent.getStringExtra("from");
     // call type String type = intent.getStringExtra("type"); //跳转到通话页面
    }
}

通过addCallStateChangeListener监听通话状态;
注意：在收到 DISCONNECTED回调时才能finish当前页面保证通话所占用的资源都释放完，然后开始下一个通话;
addCallStateListener();
在onCreate里面增加这个监听包括网络连接状态呼入电话状态,听电话状态等等都可以在这监听;
调用如下代码所示:

void addCallStateListener() {
     callStateListener = new EMCallStateChangeListener() {
     
       @Override
     public void EMCallStateChangeListener(CallState callState, final CallError error) {
              // Message msg = handler.obtainMessage();
              EMLog.d("EMCallManager", "onCallStateChanged:" + callState);
               switch (callState) {
                  case CONNECTING: //正在连接
                       break;
                  case CONNECTED: //已经连接 等等状态                        
               break;
                    .....
              }   
        
     //增加监听
     EMClient.getInstance().callManager().addCallStateChangeListener(callStateListener);
  }

当A方给B方进行视频通话时候，A可以调用下面三个方法中的任意一个来发起通话，后边两个是多参的。

try {//单参数
   EMClient.getInstance().callManager().makeVideoCall(username);
     } catch (EMServiceNotReadyException e) {
    // TODO Auto-generated catch block
   e.printStackTrace();
    }
  try {//多参数
     EMClient.getInstance().callManager().makeVideoCall(username，"ext 扩展内容");
  } catch (EMServiceNotReadyException e) {
    / / TODO Auto-generated catch block
    e.printStackTrace();
  }
   try {//多参数, recordOnServer:是否在服务器端录制该通话, mergeStream:服务器端录制时是否合并流
     EMClient.getInstance().callManager().makeVideoCall(username，"ext 扩展内容", recordOnServer, mergeStream);
  } catch (EMServiceNotReadyException e) {
    // TODO Auto-generated catch block
     e.printStackTrace();
}

当A方给B方进行视频通话时候，B可以调用下面的方法，去接通视频，B视频电话以后,
A会收到上面已经注册好的EMCallStateChangeListener回调里边的 ACCEPTED 状态，表示B已经接通视频。

try {
EMClient.getInstance().callManager().answerCall();
} catch (EMNoActiveCallException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (EMNetworkUnconnectedException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}

当A方给B方进行通话时候，B可以调用下面的方法拒绝通话，B拒绝以后,
A会收到上面已经注册好的EMCallStateChangeListener 回调里边的 DISCONNECTED 状态，具体原因为 CallError 中的 REJECTED 表示B拒绝视频。

try {
 EMClient.getInstance().callManager().rejectCall();
 
} catch (EMNoActiveCallException e) {
 
 // TODO Auto-generated catch block
 
 e.printStackTrace();
 
}

A方给B方进行语音通话时候，通话过程中任意一方可以调用下面的方法去挂断电话,
另一方会收到已经注册好的EMCallStateChangeListener回调里边的DISCONNECTED状态，
具体原因为 CallError 中的 ERROR_NONE 表示对方正常挂断电话。

EMClient.getInstance().callManager().endCall()；

SDK会写入日志文件到本地。日志文件路径如下：sdcard/Android/data/(自己App包名)/(appkey)/core_log/easemob.log;
以Demo为例，通过adb命令获取本地的log：

adb pull /sdcard/Android/data/com.hyphenate.chatuidemo/easemob-demo#chatdemoui/core_log/easemob.log

在视频通话过程中可以暂停和恢复语音传输，具体方法如下：
A和B通话，当A停止或恢复语音传输时候，
B会收到已经注册好的EMCallStateChangeListener回调里边的
VOICE_PAUSE或者VOICE_RESUME状态，表示A的音频传输暂停或者恢复,
方法如下所示：

暂停音频数据传输：
EMClient.getInstance().callManager().pauseVoiceTransfer()；
恢复音频数据传输：
EMClient.getInstance().callManager().resumeVoiceTransfer()；

在语音通话过程中可以暂停和恢复视频传输，具体方法如下：
A和B通话，当A停止或恢复视频传输时候，
B会收到已经注册好的 EMCallStateChangeListener回调里边的
VIDEO_PAUSE 或者 VIDEO_RESUME 状态，表示A的音频传输暂停或者恢复。
方法如下所示：

暂停视频数据传输：
EMClient.getInstance().callManager().pauseVideoTransfer();
恢复视频数据传输：
EMClient.getInstance().callManager().resumeVideoTransfer()；

视频通话时如果有前置摄像头，默认使用前置的，提供切换 API 切换到后置或者前置摄像头。

EMClient.getInstance().callManager().switchCamera();

通话之前，可以设置通话音频的最大音频码率，
设置方法如下，注意:设置最大音频比特率，取值范围 6 ~ 510。

EMClient.getInstance().callManager().getCallOptions().setMaxAudioKbps(50);

可以通过以下方法设置本地视频通话分辨率 默认是(640, 480)，例如设置720P分辨率。

EMClient.getInstance().callManager().getCallOptions().setVideoResolution(1280, 720);

可以通过以下方法设置本地通话最大帧率，SDK 最大支持(30)，默认(20)，例如以下设置为25。

EMClient.getInstance().callManager().getCallOptions().setMaxVideoFrameRate(25);

可以通过以下方法设置视频通话最大和最小比特率（可以不设置，SDK会根据手机分辨率和网络情况自动适配），
最大值默认800，最小值默认80

EMClient.getInstance().callManager().getCallOptions().setMaxVideoKbps(800);
EMClient.getInstance().callManager().getCallOptions().setMinVideoKbps(80);

可以通过以下方法设置视频流畅度优先还是清晰度优先（true 为清晰度优先，false为流畅度优先)。

EMClient.getInstance().callManager().getCallOptions().setClarityFirst(true);

A，B都开启离线推送后，当A呼叫B，而B离线时，B会收到推送消息，
点击推送消息可以打开APP，进入通话页面（true推送，false不推送)。
目前小米、魅族、OPPO、VIVO推送的主要实现集成在了环信 IM SDK 中，
尽量提供给开发者最简单的集成三方推送的形式。
Google FCM 和华为推送的实现仍在 Demo 层，需要开发者自己集成，
详情请参考环信的 Google FCM 和华为的推送集成文档,有个集成， 关于第三方推送集成，大家可以参考:推送集成。

//开启离线推送
 EMClient.getInstance().callManager().getCallOptions().setIsSendPushIfOffline(true);

呼叫方呼叫时可以指定是否开启服务器录制，如要录制，
使用以下方法呼叫(recordOnServer 是否在服务器端录制该通话 ; mergeStream 服务器端录制时是否合并流)。

EMClient.getInstance().callManager().makeVoiceCall(username, "", recordOnServer , mergeStream);

通话数据的数据统计功能,
可以从保存的会话callSession中获取到通话的实时码率、帧率、分辨率等数据。

语音通话中会实时监测通话网络状态，有变化时通过回调通知应用当前，
会收到已经注册好的 EMCallStateChangeListener中有关网络状态的回调,有以下几种状态。

enum CallState{
   NETWORK_UNSTABLE("network_unstable"),  //网络不稳定，丢包率较高的场景下提示
   NETWORK_NORMAL("network_normal"), //网络正常
   NETWORK_DISCONNECTED("network_disconnected"); //对方的视频流断开，一般是断网或者app被kill等
}；
enum CallError{
   ERROR_TRANSPORT("error_transport"),
   ERROR_UNAVAILABLE("error_unavailable"),
   ERROR_NO_DATA("error_no_data"),//传输无数据
}；

设置本地view预览是否开启镜像显示，前置摄像头默认为开启镜像。

EMClient.getInstance().callManager().getCallOptions().setLocalVideoViewMirror(EMMirror.OFF);

用户使用自定义音频数据时，需要配置外部输入音频数据的开关，
以及音频采样率，通道数(当前通道数只支持1)，开启方式如下（true 为开启，false为不开启)。

EMClient.getInstance().callManager().getCallOptions().setExternalAudioParam(true, 44100,1);

音频数据采集可参考Demo中的ExternalAudioInputRecord.java类实现,
音频数据的输入必须在会话接通后开始，否则会导致网络阻塞，影响通话质量。
建议用户将音频数据采集的开始放在会话接通的回调里，及callDidAccept回调中

callStateListener = new EMCallStateChangeListener() {
 
       @Override
       public void onCallStateChanged(CallState callState, final CallError error) {
          case ACCEPTED:
               //启动外部音频输入
               if(PreferenceManager.getInstance().isExternalAudioInputResolution()){
                     ExternalAudioInputRecord.getInstance().startRecording();
               }
               ....
               break;
       }

音频采集过程参考Demo中的ExternalAudioInputRecord类实现;
音频采集过程开始后，在音频数据采集线程里调用外部输入音频数据接口，具体参考Demo中的实现。

EMClient.getInstance().conferenceManager().inputExternalAudioData(byteBuffer.array(), byteBuffer.capacity());

会话挂断时，停止音频采集及输入过程

if(PreferenceManager.getInstance().isExternalAudioInputResolution()){
                     ExternalAudioInputRecord.getInstance().stopRecording();
  }

如果用户需要自己采集特定的数据或者对于数据需要先进行一些处理，可以使用SDK的外部输入数据的方法进行。
例如如果想要使用美颜等功能，需要用户使用系统的摄像头，
然后启动监听系统设备，获取到数据后进行处理，处理后再调用我们输入数据的api发布出去。
使用自定义视频接口如下：开启外边视频输入;
用户使用自定义视频数据时，需要配置外部输入数据数据的开关（true 为开启，false为不开启)。

EMClient.getInstance().callManager().getCallOptions().setEnableExternalVideoData(true);

输入视频数据

然后就是自己获取视频数据，进行美颜等处理，循环调用以下方法输入数据就行了，
这个调用频率就相当于你的帧率，调用间隔可以自己进行控制，一般最大30帧/秒）
输入视频数据的方法如下：

/**
 *
 * 视频数据的格式是摄像头采集的格式即：NV21 420sp 自己手动传入时需要将自己处理的数据转为 yuv 格式输入
 */
 EMClient.getInstance().callManager().inputExternalVideoData(data, width, height, rotate);

在Android系统可以将图片资源设置为视频流的水印。首先将图片资源转换为Bitmap对象，
然后设置WaterMarkOption中的属性，比如位置，分辨率及距离边缘的margin等。

try {
    InputStream in = this.getResources().getAssets().open("watermark.png");
    watermarkbitmap = BitmapFactory.decodeStream(in);
} catch (Exception e) {
    e.printStackTrace();
}
watermark = new WaterMarkOption(watermarkbitmap, 75, 25, WaterMarkPosition.TOP_RIGHT, 8, 8);
//设置水印
EMClient.getInstance().callManager().setWaterMark(watermark);

1v1通话支持不同集群区域的人员通话使用代理，减小延迟；
使用多集群代理需要音视频后台配置IP及端口的映射文件rtcconfig.json,并禁用相关appkey的直连,
启用多集群代理功能需要配置如下方法：

EMOptions options = new EMOptions();
  //开启代理
  options.setUseRtcConfig(true);

私有部署设置方法参见私有云sdk集成配置。

1V1音视频通话的API包括以下接口

• EMCallOptions 视频通话配置类
  
• EMACallManager 视频通话的主要管理类，提供了语音通话的拨打、接听、挂断等接口
  
• EMCallStateChangeListener 视频通话的监听回调类，实时语音通话相关的回调
  
• EMCallSession 视频通话的会话实例接口类
  
• EMVideoCallHelper 视频通话获取通话统计信息类
  
• EMCallSurfaceView 视频通话UI显示视图类
  
• EMWaterMarkOption 视频通话水印对象类
  
• EMWaterMarkPosition 视频通话水印位置设置类