【移動應(yīng)用開發(fā)技術(shù)】【音視頻】AndroidCallKit開發(fā)指南

簡介CallKit

是融云音視頻通話功能的UI界面SDK。包含了單人、多人音視頻通話的界面的各種場景和功能。您可以快速的集成

CallKit

來實(shí)現(xiàn)豐富的音視頻通話界面，并進(jìn)行自己的UI定制開發(fā)。同時(shí)我們開源了

CallKit，您可以根據(jù)您的需要去使用。GitHub項(xiàng)目：CallKit開源代碼開通方式音視頻服務(wù)開通，請參考音視頻開通方式說明。使用說明由于底層引擎技術(shù)不同，2.6.0之后的音視頻SDK與2.6.0之前的SDK中的實(shí)時(shí)音視頻不能互通。音視頻SDK為商用收費(fèi)功能，之前的SDK中的實(shí)時(shí)音視頻為免費(fèi)測試功能，如果您還想使用之前的實(shí)時(shí)音視頻，可以使用2.5.2版本，2.6.0之后的音視頻服務(wù)使用說明如下：集成說明1、首先請參考官網(wǎng)文檔集成CallKitSDK。2、

src/main/java/io/rong/imkit

下面是Call界面的源碼，可以自行修改以滿足自己的需求。3、打開

src/main/AndroidManifest.xml，下面是Call相關(guān)的代碼。<uses-permission

android:name="android.permission.PROCESS_OUTGOING_CALLS"

/>

<uses-permission

android:name="android.permission.SYSTEM_ALERT_WINDOW"

/>

<uses-permission

android:name="android.permission.INTERACT_ACROSS_USERS_FULL"

/>Call用到的權(quán)限。<activity

android:name="io.rong.imkit.MultiVideoCallActivity"

android:launchMode="singleTop"

android:screenOrientation="portrait"

android:windowSoftInputMode="stateHidden|adjustResize">

<intent-filter>

<action

android:name="ent.action.voip.MULTIVIDEO"

/>

<category

android:name="ent.category.DEFAULT"

/>

</intent-filter>

</activity>

<activity

android:name="io.rong.imkit.SingleCallActivity"

android:launchMode="singleTop"

android:screenOrientation="portrait"

android:windowSoftInputMode="stateHidden|adjustResize">

<intent-filter>

<action

android:name="ent.action.voip.SINGLEVIDEO"

/>

<category

android:name="ent.category.DEFAULT"

/>

</intent-filter>

<intent-filter>

<action

android:name="ent.action.voip.SINGLEAUDIO"

/>

<category

android:name="ent.category.DEFAULT"

/>

</intent-filter>

</activity>

<activity

android:name="io.rong.imkit.MultiAudioCallActivity"

android:launchMode="singleTop"

android:screenOrientation="portrait"

android:windowSoftInputMode="stateHidden|adjustResize">

<intent-filter>

<action

android:name="ent.action.voip.MULTIAUDIO"

/>

<category

android:name="ent.category.DEFAULT"

/>

</intent-filter>

</activity>

<activity

android:name="io.rong.imkit.CallSelectMemberActivity"

/>Call功能中使用到的

activity

和

receiver

。4、用戶使用Call期間融云保持connected狀態(tài)。5、在群組中，啟動視頻通話或音頻通話時(shí)，需要設(shè)置群組成員信息，通過getMemberList方法返回群組成員的userId的集合。以確保選擇成員頁面能正確顯示所有群組成員。設(shè)置方法如下：RongCallKit.setGroupMemberProvider(new

RongCallKit.GroupMembersProvider()

{

@Override

public

ArrayList<String>

getMemberList(String

groupId,

final

RongCallKit.OnGroupMembersResult

result)

{

//返回群組成員userId的集合

}

});發(fā)起通話在私聊或討論組的會話界面，點(diǎn)擊輸入框右側(cè)的＋號，就可以選擇“語音聊天”和“視頻聊天”了?；蛘吣憧梢愿鶕?jù)自己的代碼邏輯，在需要的地方調(diào)用下面接口發(fā)起呼叫。/**

*

發(fā)起單人通話。

*

*

@param

context

上下文

*

@param

targetId

會話

id

*

@param

mediaType

會話媒體類型

*/RongCallKit.startSingleCall(Context

context,

String

targetId,

CallMediaType

mediaType);

/**

*

發(fā)起多人通話

*

*

@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默認(rèn)音頻通話最大人數(shù)為20人，視頻通話最大人數(shù)為9人。收到呼入的通話如果App在前臺或者在后臺且并沒有被系統(tǒng)回收時(shí)，當(dāng)收到呼叫，會自動彈出通話界面。如果App已經(jīng)被回收，2.6.0以上的版本需要集成遠(yuǎn)程推送。這樣即使被回收了也能收到Call的推送消息，點(diǎn)擊推送消息啟動App會自動彈出通話界面。詳細(xì)請參考遠(yuǎn)程推送集成文檔。通話回調(diào)接口IRongCallListener是通話狀態(tài)的監(jiān)聽類，CallKit的

RongCallProxy.java

已經(jīng)實(shí)現(xiàn)了該監(jiān)聽，并且會回調(diào)到BaseCallActivity中的各個(gè)方法，您可以繼承BaseCallActivity，根據(jù)需要復(fù)寫其中的對應(yīng)方法，即可獲取對應(yīng)的通話回調(diào)。public

class

MyCallActivity

extends

BaseCallActivity

{

@Override

public

void

onCallOutgoing(RongCallSession

callProfile,

SurfaceView

localVideo)

{

super.onCallOutgoing(callProfile,

localVideo);

/**

*

此處添加你的代碼邏輯。

**/

}

@Override

public

void

onCallDisconnected(RongCallSession

callProfile,

RongCallCommon.CallDisconnectedReason

reason)

{

super.onCallDisconnected(callProfile,

reason);

/**

*

此處添加你的代碼邏輯。

**/

}

@Override

public

void

onOutgoingCallRinging()

{

super.onOutgoingCallRinging();

/**

*

此處添加你的代碼邏輯。

**/

}

@Override

public

void

onIncomingCallRinging()

{

super.onIncomingCallRinging();

/**

*

此處添加你的代碼邏輯。

**/

}

@Override

public

void

onCallConnected(RongCallSession

callProfile,

SurfaceView

localVideo)

{

super.onCallConnected(callProfile,

localVideo);

/**

*

此處添加你的代碼邏輯。

**/

}

@Override

public

void

onError(RongCallCommon.CallErrorCode

errorCode)

{

super.onError(errorCode);

/**

*

此處添加你的代碼邏輯。

**/

}

}如果上述方法不適合，您還可以通過修改

RongCallProxy.java

的代碼，實(shí)現(xiàn)自己應(yīng)用的監(jiān)聽。示例如下：public

class

RongCallProxy

implements

IRongCallListener

{

private

IRongCallListener

mCallListener;

//

增加一個(gè)監(jiān)聽。

/*設(shè)置自己應(yīng)用的監(jiān)聽*/

public

void

setAppCallListener(IRongCallListener

listener)

{

this.mAppCallListener

=

listener;

}

/*修改對應(yīng)的通話狀態(tài)回調(diào)的方法，使其回調(diào)到您設(shè)置的應(yīng)用自身的監(jiān)聽*/

@Override

public

void

onCallOutgoing(RongCallSession

callSession,

SurfaceView

localVideo)

{

if

(mCallListener

!=

null)

{

mCallListener.onCallOutgoing(callSession,

localVideo);

}

/*增加的代碼，回調(diào)應(yīng)用設(shè)置的監(jiān)聽*/

if(mAppCallListener

!=

null)

{

mAppCallListener.onCallOutgoing(callSession,

localVideo);

}

}

...

//

根據(jù)您的需要，同樣的方式修改其它通話狀