一、开发步骤

1.1、注册 VoIP 通话回调事件

使用方法详见 2.1 订阅voipCallUiEvent事件。

1.2、上报来/去电事件

应用内部建立通话连接之后，需要向VoIP Service Kit上报去电，并携带通话信息，详见接口文档2.15 VoipCall通话属性。

//来电
CallKitManager.getInstance().reportIncomingCall(call);
//去电
CallKitManager.getInstance().reportOutgoingCall(call);

接口使用方法详见：2.3上报来电消息、2.4 上报去电消息。

1.3、上报通话状态

当对端用户接听后，向 VoIP Service Kit 上报通话状态。

CallKitManager.getInstance().updateCallState(callId, CallKitConstants.VOIP_CALL_STATE_ACTIVE);

接口使用方法详见：2.5 上报应用内通话状态变化。

1.4、上报静音或解除静音事件

用户在通话过程中可以选择静音通话和解除静音，当用户点击通知横幅中的静音/解除静音按钮，应用会收到静音回调 mute(String callId, boolean mute)，在应用内部完成静音/解除静音后，需调用接口上报静音状态。

CallKitManager.getInstance().reportCallMuteEvent(callId, mute);  // mute=true 静音，mute=false 解除静音

接口使用方法详见：2.8 上报应用通话中的静音事件。

1.5、上报通话中的音频事件

在通话过程中，用户可以根据实际需要选择不同的音频通路，包括手机听筒、免提扬声器、蓝牙设备和有线耳机等。当通话的音频通路被切换，VoIP 应用会接收到切换通话音频通路回调 changeAudioRoute，应用在完成通话音频通路切换后，需通过调用接口上报当前通知的音频通路。

CallKitManager.getInstance().reportCallAudioRouteEvent(callId, currentRoute, supportRoute);

接口使用方法详见：2.7 上报通话中的音频事件。

1.6、上报应用内通话类型变化

通话类型分视频通话和语音通话两种，对于视频来电语音接听、通话中视频降语音或者语音升视频，需要应用调用接口上报通话类型变化。

CallKitManager.getInstance().updateCallType(callId, CallKitConstants.VOIP_CALL_TYPE_VOICE);

接口使用方法详见：2.6 上报应用内通话类型变化。

1.7、上报通话结束

用户在通知上点击挂断按钮，应用会收到挂断电话回调 disconnectCall，在应用内处理完成挂断后，需立即通过调用接口上报通话结束状态。

CallKitManager.getInstance().updateCallState(callId, CallKitConstants.VOIP_CALL_STATE_DISCONNECTED);

接口使用方法详见：2.5 上报应用内通话状态变化。

1.8、取消注册

通话结束后取消订阅。

CallKitManager.getInstance().off();

接口使用方法详见：2.2 取消订阅voipCallUiEvent事件。

1.9、上报通话异常

当通话出现异常时，应用需通过接口上报通话失败的原因。

CallKitManager.getInstance().reportCallError(callId, errorCode, errorMessage);

接口使用方法详见：2.9 通知来电消息建立失败。

二、VoIP Service Kit SDK API

2.1、订阅voipCallUiEvent事件

要求有通话时（通话由APP自行管理）再进行订阅
int on(Application context)

使用方法示例

CallKitManager.getInstance().on(application);

int register(CallKitCallBack callback)

CallKitCallBack接口方法列表：

该回调即用户对于VoipService通知显示的点击事件回调。

例：用户点击通知上的接听按钮，即回调answerCall。

回调中，APP自行实现逻辑

使用方法示例（建议回调方法中加入必要log）

// callback
 CallKitCallBack mCallKitCallBack = new CallKitCallBack() {
 
     @Override
            public void answerCall(String callId) {
                CallKitLog.i(TAG, "answerCall callId " + callId);
                CallKitManager.getInstance().updateCallState(callId, CallKitConstants.VOIP_CALL_STATE_ACTIVE);
            }

            @Override
            public void answerCallWithType(String callId, int callType) {
                CallKitLog.i(TAG, "answerCallWithType callId " + callId + ", type " + callType);
            }

            @Override
            public void rejectCall(String callId) {
                CallKitLog.i(TAG, "rejectCall callId " + callId);
                CallKitManager.getInstance().updateCallState(callId, CallKitConstants.VOIP_CALL_STATE_DISCONNECTED);
            }

            @Override
            public void changeCallType(String callId, int callType) {
                CallKitLog.i(TAG, "changeCallType callId " + callId + ", type " + callType);
            }

            @Override
            public void disconnectCall(String callId) {
                CallKitLog.i(TAG, "disconnectCall callId " + callId);
                CallKitManager.getInstance().updateCallState(callId, CallKitConstants.VOIP_CALL_STATE_DISCONNECTED);
            }

            @Override
            public void mute(String callId, boolean mute) {
                CallKitLog.i(TAG, "mute callId " + callId + ", mute " + mute);
                CallKitManager.getInstance().reportCallMuteEvent(callId, mute);
            }

            @Override
            public void changeAudioRoute(String callId, int route) {
                CallKitLog.i(TAG, "changeAudioRoute callId " + callId + ", route " + route);
                int supportRoute = CallKitConstants.ROUTE_EARPIECE | CallKitConstants.ROUTE_BLUETOOTH | CallKitConstants.ROUTE_WIRED_HEADSET | CallKitConstants.ROUTE_SPEAKER;
                CallKitManager.getInstance().reportCallAudioRouteEvent(callId, route, supportRoute);

            }

            @Override
            public void onCallKitEvent(int event, Bundle extras) {
                CallKitLog.i(TAG,"onCallKitEvent: " + event + " , extras " + extras);
            }
 };
 
 //订阅绑定，注册
 int workable = CallKitManager.getInstance().on(context);
 if (workable == CallKitConstants.ERROR_NONE) {
         CallKitManager.getInstance().register(mCallKitCallBack);

 }

2.2、取消订阅voipCallUiEvent事件

APP通话结束后，开发者需要立刻取消订阅。

int off（）

使用方法示例

CallKitManager.getInstance().off();

2.3、上报来电消息

int reportIncomingCall(VoipCall VoipCall)

使用方法示例

VoipCall call = new VoipCall();
call.setCallId("xxx");
call.setMsgId("xxx");
call.setUserName("xxx");
call.setUserProfile(imageBytes); //用户头像，byte[]类型
call.setPackageName(getPackageName());
call.setActivityName(this.getClass().getName());
call.setVoipCallType(CallKitConstants.VOIP_CALL_TYPE_VOICE);
call.setVoipCallState(CallKitConstants.VOIP_CALL_STATE_RINGING);
call.setDirection(CallKitConstants.DIRECTION_INCOMING);

// 上报来电事件
CallKitManager.getInstance().reportIncomingCall(call);

2.4、上报去电消息

int reportOutgoingCall (VoipCall voipCall)

使用方法示例

VoipCall call = new VoipCall();
call.setCallId("xxx");
call.setMsgId("xxx");
call.setUserName("xxx");
call.setUserProfile(imageBytes); //用户头像，byte[]类型
call.setPackageName(getPackageName());
call.setActivityName(this.getClass().getName());
call.setVoipCallType(CallKitConstants.VOIP_CALL_TYPE_VOICE);
call.setVoipCallState(CallKitConstants.VOIP_CALL_STATE_RINGING);
call.setDirection(CallKitConstants.DIRECTION_INCOMING);

// 上报去电事件
CallKitManager.getInstance().reportOutgoingCall(call);

2.5、上报应用内通话状态变化

void updateCallState (String callId, int callState)

使用方法示例

String callId = "xxx";
CallKitManager.getInstance().updateCallState(callId, CallKitConstants.VOIP_CALL_STATE_ACTIVE);

2.6、上报应用内通话类型变化

void updateCallType(String callId, int callType)

使用方法示例

String callId = "xxx";
CallKitManager.getInstance().updateCallType(callId, CallKitConstants.VOIP_CALL_TYPE_VOICE);

2.7、上报通话中的音频事件

void reportCallAudioRouteEvent(String callId, int currentRoute, int supportRoute)

使用方法示例

String callId = "xxx";
int currentRoute = CallKitConstants.ROUTE_SPEAKER;
int supportRoute = CallKitConstants.ROUTE_EARPIECE | CallKitConstants.ROUTE_BLUETOOTH | CallKitConstants.ROUTE_SPEAKER;
CallKitManager.getInstance().reportCallAudioRouteEvent(callId, currentRoute, supportRoute);

2.8、上报应用通话中的静音事件

void reportCallMuteEvent(String callId, boolean mute)

使用方法示例

String callId = "xxx";
CallKitManager.getInstance().reportCallMuteEvent(callId, true);

2.9、通知来电消息建立失败

void reportCallError(String callId, int errorCode, String errorMessage)

使用方法示例

String callId = "10086";
int errorCode = CallKitConstants.INVALID_CALL;
String errorMessage = "无效通话";
CallKitManager.getInstance().reportCallError(callId, errorCode, errorMessage);

2.10、通话类型

2.11、通话状态

2.12、通话事件

2.13、错误码

2.14、消息建立失败原因

2.15、VoipCall通话属性

2.16、通话音频事件