Android CallKit 开发指南

    简介

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

    GitHub 项目:CallKit 开源代码

    开通方式

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

    使用说明

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

    CallKit SDK 支持 Android 4.4 及以上系统。

    集成说明

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

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

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

        <uses-permission android:name="android.permission.PROCESS_OUTGOING_CALLS" />
        <uses-permission android:name="android.permission.INTERACT_ACROSS_USERS_FULL" />
        <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
        <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
        <uses-permission android:name="android.permission.READ_PHONE_STATE" />
        <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    

    Call 用到的权限。

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

    Call 功能中使用到的 activityreceiver

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

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

    RongCallKit.setGroupMemberProvider(new RongCallKit.GroupMembersProvider() {
        @Override
    
        public ArrayList<String> getMemberList(String groupId, final RongCallKit.OnGroupMembersResult result) {
    
            //返回群组成员userId的集合
    
        }
    });
    

    发起通话

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

    image

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

    /**
     * 发起单人通话。
     *
     * @param context   上下文
     * @param targetId  会话 id
     * @param mediaType 会话媒体类型
     */
    RongCallKit.startSingleCall(Context context, String targetId, CallMediaType mediaType);
    
    /**
     * 发起多人通话
     *
     * @param context          上下文
     * @param conversationType 会话类型
     * @param targetId         会话 id
     * @param mediaType        会话媒体类型
     * @param userIds          参与者 id 列表
     */
    RongCallKit.startMultiCall(Context context, Conversation.ConversationType conversationType, String targetId, CallMediaType mediaType, ArrayList<String> userIds);
    

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

    收到呼入的通话

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

    通话回调接口

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

    public class MyCallActivity extends BaseCallActivity {
        @Override
        public void onCallOutgoing(RongCallSession callSession, SurfaceView localVideo) {
            super.onCallOutgoing(callSession, localVideo);
        }
    
        @Override
        public void onCallConnected(RongCallSession callSession, SurfaceView localVideo) {
            super.onCallConnected(callSession, localVideo);
        }
    
        @Override
        public void onCallDisconnected(RongCallSession callSession, RongCallCommon.CallDisconnectedReason reason) {
            super.onCallDisconnected(callSession, reason);
        }
    
        @Override
        public void onRemoteUserRinging(String userId) {
            super.onRemoteUserRinging(userId);
        }
    
        @Override
        public void onRemoteUserJoined(String userId, RongCallCommon.CallMediaType mediaType, int userType, SurfaceView remoteVideo) {
            super.onRemoteUserJoined(userId, mediaType, userType, remoteVideo);
        }
    
        @Override
        public void onRemoteUserInvited(String userId, RongCallCommon.CallMediaType mediaType) {
            super.onRemoteUserInvited(userId, mediaType);
        }
    
        @Override
        public void onRemoteUserLeft(String userId, RongCallCommon.CallDisconnectedReason reason) {
            super.onRemoteUserLeft(userId, reason);
        }
    
        @Override
        public void onMediaTypeChanged(String userId, RongCallCommon.CallMediaType mediaType, SurfaceView video) {
            super.onMediaTypeChanged(userId, mediaType, video);
        }
    
        @Override
        public void onError(RongCallCommon.CallErrorCode errorCode) {
            super.onError(errorCode);
        }
    
        @Override
        public void onRemoteCameraDisabled(String userId, boolean disabled) {
            super.onRemoteCameraDisabled(userId, disabled);
        }
    
        @Override
        public void onWhiteBoardURL(String url) {
            super.onWhiteBoardURL(url);
        }
    
        @Override
        public void onNetWorkLossRate(int lossRate) {
            super.onNetWorkLossRate(lossRate);
        }
    
        @Override
        public void onNotifySharingScreen(String userId, boolean isSharing) {
            super.onNotifySharingScreen(userId, isSharing);
        }
    
        @Override
        public void onNotifyDegradeNormalUserToObserver(String userId) {
            super.onNotifyDegradeNormalUserToObserver(userId);
        }
    
        @Override
        public void onNotifyAnswerObserverRequestBecomeNormalUser(String userId, long status) {
            super.onNotifyAnswerObserverRequestBecomeNormalUser(userId, status);
        }
    
        @Override
        public void onNotifyUpgradeObserverToNormalUser() {
            super.onNotifyUpgradeObserverToNormalUser();
        }
    
        @Override
        public void onNotifyHostControlUserDevice(String userId, int dType, int isOpen) {
            super.onNotifyHostControlUserDevice(userId, dType, isOpen);
        }
    }
    

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

    public class RongCallProxy implements IRongCallListener {
    
        private IRongCallListener mCallListener;  // 增加一个监听。
    
        /*设置自己应用的监听*/
        public void setAppCallListener(IRongCallListener listener) {
            this.mAppCallListener = listener;
        }
    
       /*修改对应的通话状态回调的方法,使其回调到您设置的应用自身的监听*/
        @Override
        public void onCallOutgoing(RongCallSession callSession, SurfaceView localVideo) {
            if (mCallListener != null) {
              mCallListener.onCallOutgoing(callSession, localVideo);
            }
            /*增加的代码,回调应用设置的监听*/
            if(mAppCallListener != null) {
              mAppCallListener.onCallOutgoing(callSession, localVideo);
            }
          }
          ... // 根据您的需要,同样的方式修改其它通话状态回调函数。
        }
    

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

    通话界面的控制

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

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

    添加代码混淆

    • 如果你项目启用了代码混淆,请在 proguard-rules.pro 中添加音视频SDK的混淆规则
    -keep class cn.rongcloud.rtc.core.**  { *; }
    -keep class cn.rongcloud.rtc.engine.binstack.json.**  { *; }