环信EaseCallKit 使用指南及AppServer相关配置

简介：

环信EaseCallKit 是结合声网音视频结合开发的音视频 UI 库，实现了一对一语音和视频通话以及多人音视频通话的功能。基于 EaseCallKit 可以快速实现通用音视频功能。

环信官网EaseCallKit 使用文档： http://docs-im-beta.easemob.com/document/android/easecallkit.html

在官网使用指南里面介绍了EaseCallKit 快速集成。如果项目中只使用了音视频，根据EaseCallKit 步骤集成即可。
下面介绍的是如何在环信官网Demo 中修改配置，跑Demo 音视频 和AppServer

前提条件：

需要分别创建 环信应用及 声网应用
环信Demo中音视频的介绍，以V4.0.3 Demo 为例
快速跑通环信IM Android Demo 参考之前文章（见链接：https://www.imgeek.net/article/825363562）
环信IM Demo体验：https://www.easemob.com/download/demo

Android 项目快速集成音视频:

远程依赖不可以对代码进行修改，集成前可以先体验Demo是否可以满足业务需求，如果需要对页面进行修改，可以把ease-call-kit 以module 的形式导进项目中，对其进行修改
远程依赖：implementation 'io.hyphenate:ease-call-kit:4.0.3'
本地依赖源码链接：https://github.com/easemob/easecallkitui-android

本地Module的导入教程

1、从链接中下载源码并解压，下面是解压完的目录，需要导入的是红圈中的文件：

2、直接拖进项目里面

也可以通过Android Studio 导进去

3、在 build.gradle (App级别下)添加 api project(':ease-call-kit')

4、在settings.gradle下添加api project(':ease-call-kit')

添加完以后编译项目即可

EaseCallKit 初始化使用可以参考官网文档：
http://docs-im-beta.easemob.com/document/android/easecallkit.html#%E5%88%9D%E5%A7%8B%E5%8C%96

Android 项目中的相关配置：

关于EaseCallKit 初始化在DemoHelper类下，见下图。

注:AgoraAppId这里是从声网平台注册的，在项目中需要切换，不可以直接上线使用

在Demo中 DemoHelper 类下，可以看到两个请求接口如下图
第一个接口：获取声网token ，这里用于音视频通话
第二个接口：根channelName和声网uId获取频道内所有人的UserId

注：这里的两个接口对应的appServer中的接口，a1.easemob.com 是环信域名，搭建appServer 以后需要将这里换成自己的域名

在环信Demo中,DemoHelper类中可以看到Demo是通过AppServer获取到token，这里获取到的token用于音视频

注：如果在测试中遇到音视频无法正常拨打接通，可以使用断点判断这里请求是否成功，环信Demo 中默认的token 请求接口不可以直接用于项目正常上线

代码简介：

获取到token和uid以后通过回调的形式传到音视频页面

下面是加入音视频的api 调用

注：在测试或者集成中如果遇到问题，可以按上面的步骤断点查看，是否有报错

Demo 中音视频点击代码如下

EaseCallKit 中提供的 API 可以参考文档：http://docs-im-beta.easemob.com/document/android/easecallkit.html#api-%E5%88%97%E8%A1%A8

Java服务端项目中的配置：

appserver下载地址：https://github.com/easemob/easemob-im-app-server/tree/master/agora-app-server

appserver中需要修改的配置：
orgName：环信appkey 中#前面的部分
appName：环信appkey中#后面的部分
agoraAppId 和agoraCert 从声网console 下获取

修改完配置正常运行项目
Uid是服务端生成的随机数

扩展阅读：
手把手教你从零开始集成声网音视频功能(iOS版)：https://www.imgeek.net/article/825364398