简介

CallKit是融云音视频通话功能的 UI 界面 SDK。包含了单人、多人音视频通话的界面的各种场景和功能。您可以快速的集成CallKit来实现丰富的音视频通话界面,并进行自己的 UI 定制开发。同时我们开源了CallKit,您可以根据您的需要去使用。

GitHub 项目:CallKit 开源代码

开通方式

音视频服务开通,请参考音视频开通方式说明。

使用说明

由于底层引擎技术不同,2.6.0 之后的音视频 SDK 与 2.6.0 之前的 SDK 中的实时音视频不能互通。

音视频 SDK 为商用收费功能,之前的 SDK 中的实时音视频为免费测试功能,如果您还想使用之前的实时音视频,可以使用 2.5.2 版本,2.6.0 之后的音视频服务使用说明如下:

集成说明

1、 首先请参考官网文档集成 CallKit SDK 。

2、src/main/java/io/rong/imkit下面是 Call 界面的源码,可以自行修改以满足自己的需求。

3、 打开src/main/AndroidManifest.xml,下面是 Call 相关的代码。

<uses-permissionandroid:name="android.permission.PROCESS_OUTGOING_CALLS"/><uses-permissionandroid:name="android.permission.SYSTEM_ALERT_WINDOW"/><uses-permissionandroid:name="android.permission.INTERACT_ACROSS_USERS_FULL"/>

Call 用到的权限。

<activityandroid:name="io.rong.imkit.MultiVideoCallActivity"android:launchMode="singleTop"android:screenOrientation="portrait"android:windowSoftInputMode="stateHidden|adjustResize"><intent-filter><actionandroid:name="io.rong.intent.action.voip.MULTIVIDEO"/><categoryandroid:name="android.intent.category.DEFAULT"/></intent-filter></activity><activityandroid:name="io.rong.imkit.SingleCallActivity"android:launchMode="singleTop"android:screenOrientation="portrait"android:windowSoftInputMode="stateHidden|adjustResize"><intent-filter><actionandroid:name="io.rong.intent.action.voip.SINGLEVIDEO"/><categoryandroid:name="android.intent.category.DEFAULT"/></intent-filter><intent-filter><actionandroid:name="io.rong.intent.action.voip.SINGLEAUDIO"/><categoryandroid:name="android.intent.category.DEFAULT"/></intent-filter></activity><activityandroid:name="io.rong.imkit.MultiAudioCallActivity"android:launchMode="singleTop"android:screenOrientation="portrait"android:windowSoftInputMode="stateHidden|adjustResize"><intent-filter><actionandroid:name="io.rong.intent.action.voip.MULTIAUDIO"/><categoryandroid:name="android.intent.category.DEFAULT"/></intent-filter></activity><activityandroid:name="io.rong.imkit.CallSelectMemberActivity"/>

Call 功能中使用到的activityreceiver

4、 用户使用 Call 期间融云保持 connected 状态。

5、 在群组中,启动视频通话或音频通话时,需要设置群组成员信息,通过 getMemberList 方法返回群组成员的 userId 的集合。以确保选择成员页面能正确显示所有群组成员。设置方法如下:

RongCallKit.setGroupMemberProvider(newRongCallKit.GroupMembersProvider(){@OverridepublicArrayList<String>getMemberList(StringgroupId,finalRongCallKit.OnGroupMembersResultresult){//返回群组成员userId的集合}});发起通话

在私聊或讨论组的会话界面,点击输入框右侧的+号,就可以选择“语音聊天”和“视频聊天”了。

或者你可以根据自己的代码逻辑,在需要的地方调用下面接口发起呼叫。

/***发起单人通话。**@paramcontext上下文*@paramtargetId会话id*@parammediaType会话媒体类型*/RongCallKit.startSingleCall(Contextcontext,StringtargetId,CallMediaTypemediaType);/***发起多人通话**@paramcontext上下文*@paramconversationType会话类型*@paramtargetId会话id*@parammediaType会话媒体类型*@paramuserIds参与者id列表*/RongCallKit.startMultiCall(Contextcontext,Conversation.ConversationTypeconversationType,StringtargetId,CallMediaTypemediaType,ArrayList<String>userIds);

CallKit 默认音频通话最大人数为 20 人,视频通话最大人数为 9 人。

收到呼入的通话

如果 App 在前台或者在后台且并没有被系统回收时,当收到呼叫,会自动弹出通话界面。如果 App 已经被回收,2.6.0 以上的版本需要集成远程推送。这样即使被回收了也能收到 Call 的推送消息,点击推送消息启动 App 会自动弹出通话界面。详细请参考远程推送集成文档。

通话回调接口

IRongCallListener 是通话状态的监听类,CallKit 的RongCallProxy.java已经实现了该监听,并且会回调到 BaseCallActivity 中的各个方法,您可以继承 BaseCallActivity,根据需要复写其中的对应方法,即可获取对应的通话回调。

publicclassMyCallActivityextendsBaseCallActivity{@OverridepublicvoidonCallOutgoing(RongCallSessioncallProfile,SurfaceViewlocalVideo){super.onCallOutgoing(callProfile,localVideo);/***此处添加你的代码逻辑。**/}@OverridepublicvoidonCallDisconnected(RongCallSessioncallProfile,RongCallCommon.CallDisconnectedReasonreason){super.onCallDisconnected(callProfile,reason);/***此处添加你的代码逻辑。**/}@OverridepublicvoidonOutgoingCallRinging(){super.onOutgoingCallRinging();/***此处添加你的代码逻辑。**/}@OverridepublicvoidonIncomingCallRinging(){super.onIncomingCallRinging();/***此处添加你的代码逻辑。**/}@OverridepublicvoidonCallConnected(RongCallSessioncallProfile,SurfaceViewlocalVideo){super.onCallConnected(callProfile,localVideo);/***此处添加你的代码逻辑。**/}@OverridepublicvoidonError(RongCallCommon.CallErrorCodeerrorCode){super.onError(errorCode);/***此处添加你的代码逻辑。**/}}

如果上述方法不适合,您还可以通过修改RongCallProxy.java的代码,实现自己应用的监听。示例如下:

publicclassRongCallProxyimplementsIRongCallListener{privateIRongCallListenermCallListener;//增加一个监听。/*设置自己应用的监听*/publicvoidsetAppCallListener(IRongCallListenerlistener){this.mAppCallListener=listener;}/*修改对应的通话状态回调的方法,使其回调到您设置的应用自身的监听*/@OverridepublicvoidonCallOutgoing(RongCallSessioncallSession,SurfaceViewlocalVideo){if(mCallListener!=null){mCallListener.onCallOutgoing(callSession,localVideo);}/*增加的代码,回调应用设置的监听*/if(mAppCallListener!=null){mAppCallListener.onCallOutgoing(callSession,localVideo);}}...//根据您的需要,同样的方式修改其它通话状态回调函数。}

修改完上述方法后,在您的应用里调用 setAppCallListener() 设置您自己的监听。

通话界面的控制

由于通话界面的需求是多种多样的,融云设计了一套通用的 UI 界面,开源供用户使用。对于普通用户来说,CallKit应该满足需求;而对于有特殊需要的用户,可以自己来修改CallKit的源代码来满足需求。

需要提醒开发者的是,如果您在开发过程中,没有集成融云 SDK 中的聊天会话界面 (ConversationFragment),您还需将 RongCallModule 中的变量 mViewLoaded 在该类的 onCreate 方法中设置为 True。