======  Android 访客端demo集成（含UI库） ======

==== 代码下载 ====


您可以通过以下两种方式获取到源代码：

  * 下载代码压缩包：客服云sdk 及 Demo 下载 http://www.easemob.com/download/cs

==== 项目集成：详细内容参考demo ====


**app模块主体类介绍：**

  * LoginActivity：处理登录相关的逻辑，必须先登录环信服务器获取相关信息
  * SettingFragment：通过扫码配置appkey相关信息
  * CallReceiver：用于接收视频邀请相关的信令
  * DemoApplication：继承Application类，需要在AndroidManifest.xml内指定
  * DemoHelper：初始化相关信息配置和注册
  * HMSPushHelper：配置华为HMS推送相关的工具类

**kefu-easeui模块主体类介绍：**

  * ChatFragment：聊天界面，app也可继承此fragment续写，参数传入示例可查看demo里的ChatActivity

**VideoKit模块主体类介绍（在线视频）：**

  * Calling：视频通话页面唤起类
  * CallActivity：视频通话页面（没有赋予悬浮权限)，普通效果
  * VideoCallWindowService：视频通话页面（已赋予悬浮权限)，画中画效果
  * AgoraRtcEngine：音视频通话相关（基于声网sdk）


**VECKit模块主体类介绍（VEC视频）：**

  * VECKitCalling：视频通话页面唤起类
  * CallVideoActivity：视频通话页面（没有赋予悬浮权限)，普通效果
  * VideoCallWindowService：视频通话页面（已赋予悬浮权限)，画中画效果
  * AgoraRtcEngine：音视频通话相关（基于声网sdk）


==== 初始化注意事项 ====
<code java>
在项目Application类的onCreate方法里调用如下方法：

// VEC视频用到
AppStateVecCallback.init(this);
// CEC视频用到
AppStateCecCallback.init(this);
// UI库里用到
EaseUiStateUtils.getEaseUiStateUtils().init(this);
</code>

==== 其它注意事项 ====
<code java>
如果使用到询前引导发起视频功能，需要到Demo里拷贝GuideMenuUtils类文件到自己项目里，在对应聊天页面里调用如下方法：
// 聊天页面创建时，需要注册
GuideMenuUtils.getGuideMenuUtils().registerReceiver(getContext());
// 聊天页面关闭时，需要取消注册
GuideMenuUtils.getGuideMenuUtils().unregisterReceiver(getContext());
</code>

<code java>
如果用户自己实现聊天页面，需要在打开聊天页面和关闭聊天页面时调用如下两个方法（如下两个方法目前已经集成在kefu-easeui模块ChatFragment类里面，自行修改）
进入到聊天页面时调用：开启在线上报
EaseUiReportUtils.getEaseUiReportUtils().startReport(im服务号); // ChatFragment类onStart()方法里

关闭聊天页面时调用：停止在线上报
EaseUiReportUtils.getEaseUiReportUtils().closeReport(); // ChatFragment类onDestroyView()方法里

注意：根据自己业务场景是否需要在自己聊天页面里上报，UI库里已经调用此方法，如果自己实现的聊天页面需要用户到kefu-easeui模块ChatFragment类里面注释掉上报代码，在自己聊天页面里进行调用
</code>
==== kefu-easeui模块说明 ====

注意：当使用到环信kefu-easeui模块时，在ChatFragment类里已经添加如下功能，不需要用户自己调用
<code java>
// 自定义表情通知
ChatClient.getInstance().emojiconManager().addDelegate(this);
ChatClient.getInstance().emojiconManager().removeDelegate(this);

// 进入到聊天页面时调用
ChatClient.getInstance().chatManager().bindChat(toChatUsername);
ChatClient.getInstance().chatManager().unbindChat();

// 添加座席端输入状态
ChatClient.getInstance().chatManager().addAgentInputListener(agentInputListener);
ChatClient.getInstance().chatManager().removeAgentInputListener(agentInputListener);

// 待接入时获取等待数
ChatClient.getInstance().chatManager().addVisitorWaitListener(visitorWaitListener);
ChatClient.getInstance().chatManager().removeVisitorWaitListener(visitorWaitListener);

// 获取机器人欢迎语，默认在ChatFragment类里requestRobotWelcome()方法里对数据进行处理刷新页面显示
ChatFragment类 requestRobotWelcome()方法，方法默认被注释掉，需要用户自行调用。如果自己调用获取机器人欢迎语接口时需要参考requestRobotWelcome()方法处理结果以及更新屏幕显示
</code>


==== VideoKit在线音视频模块主要功能介绍 ====

音视频（基于声网音视频服务，使用环信 IM 作为信令通道的开源音视频模块）

**注册视频信令广播（demo里CallReceiver广播类）**
<code java>
IntentFilter callFilter = new IntentFilter(ChatClient.getInstance().callManager().getIncomingCallBroadcastAction());
callFilter.addAction("calling.state");
CallReceiver callReceiver = new CallReceiver();
// register incoming call receiver
context.registerReceiver(callReceiver, callFilter);
</code>


=====主动发送视频邀请：=====
<code>
// 只是唤起视图页面，需要单独发送视频邀请信令
Calling.callingRequest(context(), toChatUsername);

// 发送视频邀请信令
ChatClient.getInstance().callManager().callVideo(msg, toChatUsername);
</code>

=====被动收到访客视频邀请信令，唤起视频页面：=====
<code>
/**
 * V1.3.1版本之后才可以使用此方法，需要悬浮权限，授予权限将会实现悬浮效果
 * 被动唤起视频页面（座席端发起会话到访客端）
 * @param context
 * @param intent
 */
Calling.callingResponse(Context context, Intent intent);
</code>
=====相关音视频api介绍及使用如下：=====
<code java>
创建视频引擎AgoraRtcEngine
/**
 * 创建视频数据
 * @param context Context
 * @param appId String
 * @param handler IAgoraRtcEngineEventHandler
 */
AgoraRtcEngine engine = AgoraRtcEngine.builder()
		.addVideoWatermark() // 该方法将一张 PNG 图片作为水印添加到本地发布的直播视频流上
		.setVideoEncodingDimension() // 视频编码像素。参数使用查看SDK里方法注解
		.setVideoEncoderConfiguration() // 视频编码属性的定义。参数使用查看SDK里方法注解
		.setRenderMode() // 设置视频渲染模式。参数使用查看SDK里方法注解
		.setMirrorMode() // 设置视频镜像模式。参数使用查看SDK里方法注解
		.setClientRole() // 设置直播场景下的用户角色。参数使用查看SDK里方法注解
		.setChannelProfile() // 设置频道场景。参数使用查看SDK里方法注解
		.build(getApplication(), "appid", new IAgoraRtcEngineEventHandler() {
	@Override
	public void onUserJoined(int uid, int elapsed) {
		// 有人员加入时回调
	}

</code>

<code java>
	@Override
	public void onJoinChannelSuccess(String channel, int uid, int elapsed) {
		// 自己加入成功时回调
	}

	@Override
	public void onLeaveChannel(RtcStats stats) {
		// 离开channel时回调
	}

	@Override
	public void onUserOffline(int uid, int reason) {
		// 人员离开时回调
	}
});


/**
 * 创建 RendererView视图
 *
 * 请在主线程调用该方法
 * @return SurfaceView
 */
engine.createRendererView();
engine.createRendererView(Context context);
</code>

<code>
发送视频通话信令
/**
 * 发送视频通话信令
 * @param chatInviteShoe msg内容
 * @param toChatUsername IM服务号
 */
ChatClient.getInstance().callManager().callVideo(String chatInviteShoe, String toChatUsername);
</code>

<code>
拒绝接听信令
/**
 * 拒绝接听信令
 * @param callId callId
 * @param isConnected 是否已接通，false未接通
 */
ChatClient.getInstance().callManager().endCall(int callId, boolean isConnected);
</code>

<code>
挂断视频信令
/**
 * 挂断视频
 * @param callId callId
 * @param isConnected 是否已接通，true接通
 */
ChatClient.getInstance().callManager().endCall(int callId, boolean isConnected);
</code>

音视频（基于声网音视频服务，使用环信 IM 作为信令通道的开源音视频模块）相关详细方法及参数说明参考声网api地址：https://docs.agora.io/cn/Interactive%20Broadcast/API%20Reference/java/index.html

===== VECKit 模块音视频主要方法介绍 =====

VECKit 模块（新版VEC）音视频（基于声网音视频服务，使用环信 IM 作为信令通道的开源音视频模块）

**相关音视频api介绍及使用如下：**
==== 注册视频信令广播（demo里CallReceiver广播类） ====

<code>
IntentFilter callFilter = new IntentFilter(ChatClient.getInstance().callManager().getIncomingCallBroadcastAction());
callFilter.addAction("calling.state");
CallReceiver callReceiver = new CallReceiver();
// register incoming call receiver
context.registerReceiver(callReceiver, callFilter);
</code>

==== 主动发送视频邀请信令同时唤起视频视图 ====

<code>
// 主动向坐席发送信令（发送信令并且唤起视频视图）
VECKitCalling.callingRequest(Context context, String toChatUserName);
</code>



==== 被动接收到视频邀请信令同时唤起视图页面 ====

<code>
// 接收到坐席发来的信令（发送信令并且唤起视图）
VECKitCalling.callingResponse(Context context, Intent intent);
</code>

==== 唤起满意度评价视图 ====
<code>
// 接收到坐席发来的信令，唤起满意度评价视图
VECKitCalling.callingRetry(Context context, String content);
</code>
==== 初始化相关操作 ====
<code>
/**
 * 注册Vec视频通知
 * @param classKey 当前类名。当调用unRegisterVecMessageNotify方法释放时传入相同类名
 * @param message IVecMessageNotify接口，通知回调：
 *                zuoXiSendThreeUserRequest(ZuoXiSendRequestObj obj)当座席端邀请第三方用户加入时，回调此方法
 *                createFlatRoom(ZuoXiSendRequestObj obj) 创建电子白板房间时，回调此方法
 */
AgoraMessage.newAgoraMessage().registerVecMessageNotify(String classKey, IVecMessageNotify message);


/**
 * 注销通知
 * @param classKey 当前类名。registerVecMessageNotify方法传入相同类名
 */
AgoraMessage.newAgoraMessage().unRegisterVecMessageNotify(String classKey);
</code>

<code>
// 创建引擎
AgoraRtcEngine agoraRtcEngine = AgoraRtcEngine.builder().build(Context context, String appId, IRtcEngineEventHandler handler)

// 设置自己窗口视图
agoraRtcEngine.setupLocalVideo(surfaceView, AgoraRtcEngine.RENDER_MODE_HIDDEN, obj.getUid());
// 加入房间
agoraRtcEngine.joinChannel(obj.getToken(), obj.getChannel(), obj.getUid());

*注：详情参数设置参考demo
</code>





==== 主动发送视频邀请信令 ====
<code>
// 主动向坐席发送信令（只发送信令）
ChatClient.getInstance().callManager().callVecVideo(String content, String toChatUsername)
</code>

==== 挂断视频信令 ====

<code>
/**
 * 主动发起视频邀请，坐席未接通状态。主动发送挂断信令
 */
VECKitCalling.endCallFromOff();

/**
  * 视频已接通。发送挂断信令
  * @param callBack 回调函数
  */
VECKitCalling.endCallFromOn(ValueCallBack<String> callBack);

/**
 * 坐席发起视频邀请，访客未接通状态。访客发送挂断信令
 * @param content 显示内容
 */
VECKitCalling.endCallFromZuoXi(String content);
</code>


==== 发送接通视频信令（只发送信令） ====
<code>
// 发送接通视频信令（只发送信令）
/**
  * 坐席发起视频邀请。访客发送接通信令
  * @param content 显示内容
  */
VECKitCalling.acceptCallFromZuoXi(String content);
</code>



==== 智能辅助相关信令 ====
<code>
// 注册接口，接收vec相关信令
AgoraMessage.newAgoraMessage().registerVecPushMessage(String classKey, IPushMessage callback);
// 释放接口
AgoraMessage.newAgoraMessage().unRegisterVecPushMessage(String classKey);
</code>

<code>
/**
 * 智能辅助（手电筒）：通知坐席端开启手电筒的状态
 * @param isOk 是否开启成功：true开启成功，false开启失败
 * @param msg 内容（通知坐席端开启失败的原因，如果isOK指定为true，msg传入""）
 */
AgoraMessage.sendFlashLight(boolean isOk, String msg);
</code>

<code>
/**
 * 智能辅助（闪光灯）：通知坐席端开启光灯的状态
 * @param isOk 是否开启成功：true开启成功，false开启失败
 * @param msg 内容（通知坐席端开启失败的原因，如果isOK指定为true，msg传入""）
 */
AgoraMessage.sendCameraTorch(boolean isOk, String msg);
</code>

<code>
/**
 * 智能辅助（聚焦）：通知坐席端开启的状态
 * @param msg 内容（通知坐席端聚焦失败的原因，聚焦成功msg传入""）
 */
AgoraMessage.sendCameraFocus(String msg);
</code>

<code>
/**
 * 智能辅助（麦克风）：通知坐席端开启的状态
 * @param msg 内容（通知坐席端开启失败的原因，麦克风开启成功msg传入""）
 */
AgoraMessage.sendMicrophone(String msg);
</code>

<code>
/**
 * 智能辅助（相机）：通知坐席端开启的状态
 * @param msg 内容（通知坐席端开启失败的原因，相机开启成功msg传入""）
 */
AgoraMessage.sendCamera(String msg);
</code>

<code>
/**
 * 智能辅助（切换相机）：通知坐席端切换的状态
 * @param msg 内容（通知坐席端切换相机失败的原因，切换相机成功msg传入""）
 */
AgoraMessage.sendChangeCamera(String msg);
</code>

详情使用请参考demo

音视频（基于声网音视频服务，使用环信 IM 作为信令通道的开源音视频模块）相关详细方法及参数说明参考声网api地址：https://docs.agora.io/cn/Interactive%20Broadcast/API%20Reference/java/index.html