实时通话

实时通话分为视频通话和音频通话，与普通电话不同，它是基于网络的。

实时语音和实时视频的数据流量如下：

• 实时语音：双向 170k bytes/minute
• 实时视频：双向 2.5M～3M bytes/minute

通过注册相应 action 的 BroadcastReceiver 来监听呼叫过来的通话，接到广播后开发者可以调起 APP 里的通话 Activity。

IntentFilter callFilter = new IntentFilter(EMClient.getInstance().callManager().getIncomingCallBroadcastAction());
registerReceiver(new 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 当前页面（保证通话所占用的资源都释放完），然后开始下一个通话。

EMClient.getInstance().callManager().addCallStateChangeListener(new EMCallStateChangeListener() {
    @Override
    public void onCallStateChanged(CallState callState, CallError error) {
        switch (callState) {
        case CONNECTING: // 正在连接对方
           
            break;
        case CONNECTED: // 双方已经建立连接
           
            break;

        case ACCEPTED: // 电话接通成功
           
            break;
        case DISCONNECTED: // 电话断了

            break;
        case NETWORK_UNSTABLE: //网络不稳定
            if(error == CallError.ERROR_NO_DATA){
		//无通话数据
	    }else{
	    }
	    break;
	case NETWORK_NORMAL: //网络恢复正常
			
	    break;
        default:
            break;
        }

    }
});

详细回调请参考API Doc。

/**
* 拨打语音通话
* @param to
* @throws EMServiceNotReadyException
*/
try {//单参数
	EMClient.getInstance().callManager().makeVoiceCall(username);
} catch (EMServiceNotReadyException e) {
	// TODO Auto-generated catch block
	e.printStackTrace();
}

try {//多参数
	EMClient.getInstance().callManager().makeVoiceCall(username，"ext 扩展内容");
} catch (EMServiceNotReadyException e) {
	// TODO Auto-generated catch block
	e.printStackTrace();
}

//获取扩展内容
 String callExt = EMClient.getInstance().callManager().getCurrentCallSession().getExt();

/**
* 拨打视频通话
* @param to
* @throws EMServiceNotReadyException
*/
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();
}

//获取扩展内容
 String callExt = EMClient.getInstance().callManager().getCurrentCallSession().getExt();

视频通话需要显示自己和对方的图像，需要设置相应 surfaceview。

/**
* 接听通话
* @throws EMNoActiveCallException
* @throws EMNetworkUnconnectedException
*/
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();
}

/**
* 拒绝接听
* @throws EMNoActiveCallException
*/
try {
	EMClient.getInstance().callManager().rejectCall();
} catch (EMNoActiveCallException e) {
	// TODO Auto-generated catch block
	e.printStackTrace();
}

/**
* 挂断通话
*/
EMClient.getInstance().callManager().endCall();

暂停语音数据传输：

EMClient.getInstance().callManager().pauseVoiceTransfer()

恢复语音数据传输：

EMClient.getInstance().callManager().resumeVoiceTransfer()

暂停视频（图像）数据传输：

EMClient.getInstance().callManager().pauseVideoTransfer()

恢复视频（图像）数据传输：

EMClient.getInstance().callManager().resumeVideoTransfer()

调用后对方会收到相应VOICE_PAUSE、VOICE_RESUME、VIDEO_PAUSE、VIDEO_RESUME的callstate的变动通知。

视频通话需要预先设置 localSurfaceView、oppositeSurfaceView， 而且必须在Activity.onCreate(Context context)方法中设置，之后才能正确捕捉 Surface 的变化。

EMClient.getInstance().callManager().setSurfaceView(localSurface, oppositeSurface);

如果需要处理自己本地视频数据，比如美颜等操作，可以自己输入视频数据进行操作，原来的回调视频数据接口EMCameraDataProcessor已经废弃，不推荐使用；

使用方式：

/**
 * 首先在初始化音视频部分设置外部输入视频数据
 * 设置是否启用外部输入视频数据，默认 false，如果设置为 true，需要自己调用
 * {@link EMCallManager#inputExternalVideoData(byte[], int, int, int)}输入视频数据
 */
EMClient.getInstance().callManager().getCallOptions().setEnableExternalVideoData(true);
...
/**
 * 然后就是自己获取视频数据，进行美颜等处理，循环调用以下方法输入数据就行了（这个调用频率就相当于你的帧率，调用间隔可以自己进行控制，一般最大30帧/秒）
 * 视频数据的格式是摄像头采集的格式即：NV21 420sp 自己手动传入时需要将自己处理的数据转为 yuv 格式输入
 */
EMClient.getInstance().callManager().inputExternalVideoData(data, width, height, rotate);

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

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

视频通话相对复杂，把视频相关的一些 API 封装到了 EMVideoCallHelper 里。

EMVideoCallHelper callHelper = EMClient.getInstance().callManager().getVideoCallHelper();

设置通话最大帧率，SDK 最大支持(30)，默认(20)

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

callHelper.takePicture(filepath);

设置视频通话分辨率 默认是(640, 480)

EMClient.getInstance().callManager().getCallOptions().setVideoResolution(640, 480);

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

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

音视频呼叫对方，如果对方不在线，则发送一条离线消息通知对方（true推送，false不推送）

EMClient.getInstance().callManager().getCallOptions().setIsSendPushIfOffline(false);

设置音视频采样率，一般不需要设置，除非采集声音有问题才需要手动设置(默认值48000)，根据自己硬件设备确定

EMClient.getInstance().callManager().getCallOptions().setAudioSampleRate(48000);

设置音视频通话时音频源,参数表示采集语音时所设置的音频源类型（这个一般只有在外接输入源时才需要设置），具体值参考 MediaRecorder.AudioSource 源码类，SDK 中默认值 VOICE_COMMUNICATION

EMClient.getInstance().callManager().getCallOptions().setCallAudioSource(AudioSource.MIC);

录制视频，参数为录制的文件存储目录。

callHelper.startVideoRecord(dirPath);

停止录制，此方法返回录制完成的视频的完整路径。

callHelper.stopVideoRecord();

详细文档请参考 Java Doc。