簡介
CallKit?是融云音視頻通話功能的 UI 界面 SDK腮考。包含了單人忘巧、多人音視頻通話的界面的各種場景和功能饶米。您可以快速的集成?CallKit?來實現(xiàn)豐富的音視頻通話界面桨啃，并進行自己的 UI 定制開發(fā)。同時我們開源了?CallKit檬输，您可以根據(jù)您的需要去使用照瘾。
GitHub 項目：CallKit 開源代碼
開通方式
音視頻服務(wù)開通，請參考音視頻開通方式說明褪猛。
使用說明
由于底層引擎技術(shù)不同网杆，2.6.0 之后的音視頻 SDK 與 2.6.0 之前的 SDK 中的實時音視頻不能互通羹饰。
音視頻 SDK 為商用收費功能伊滋，之前的 SDK 中的實時音視頻為免費測試功能，如果您還想使用之前的實時音視頻队秩，可以使用 2.5.2 版本笑旺。
集成說明
1.導入 SDK
有兩種方式可以將 SDK 導入您的項目中：
通過?CocoaPods?管理依賴
手動導入 SDK 并管理依賴
2.使用 CocoaPods 導入 SDK
1、 Cocoapods 的安裝馍资、使用筒主，可以參考IM SDK - 下載與導入SDK文檔。
2鸟蟹、 使用 CocoaPods 導入融云 SDK
在您的工程根目錄下新建一個 Podfile 文件乌妙，在文件中輸入以下內(nèi)容。（在此以 2.8.0 版本為例建钥，其中 “MyApp” 為自己工程名）
target'MyApp'do? ??
? ? ?pod'RongCloudIM/IMLib','2.8.0'
? ? ?pod'RongCloudIM/IMKit','2.8.0'
? ? ?pod'RongCloudIM/CallLib','2.8.0'
? ? ?pod'RongCloudIM/CallKit','2.8.0'
end
然后在終端中運行以下命令：
? pod install
完成后藤韵，CocoaPods 會在您的工程根目錄下生成一個?.xcworkspace?文件。您需要通過此文件打開您的工程熊经，而不是之前的?.xcodeproj泽艘。
請務(wù)必保證使用的 RongCloudIM 所有模塊版本號一致欲险。?
關(guān)于融云 IM CocoaPods 功能模塊的介紹和使用說明，可以參考說明文檔匹涮。?
如果您使用的是2.8.0之前的SDK天试，請參考知識庫文檔。
3.手動導入 SDK
1然低、 下載 SDK
您可以到融云官方網(wǎng)站下載 SDK喜每。
2、 融云?IM SDK?是?Call SDK?的基礎(chǔ)雳攘。使用?CallKit?或?CallLib灼卢，必須同時集成使用融云?IM SDK。 手動導入 IM SDK来农，可以參考?IM SDK - 下載與導入文檔鞋真。
SDK 文件說明：
? ? ? ? ? ? ? ? ?文件 ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?說明 ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?注意事項
RongCallKit.framework ? ? ? ? ? ? CallKit的framework 庫 ? ? ?使用 CallKit 必須導入
RongCallLib.framework ? ? ? ? ? ?CallLib的framework 庫 ? ?使用 CallLib 與使用 CallKit 都必須導入
AgoraRtcEngineKit.framework ?通話引擎 ? ? ? ? ? ? ? ? ? ? 必須導入，否則通話功能將無法使用
3沃于、 手動集成了融云 SDK 之后涩咖，您需要在您的工程中導入 RongCallLib.framewrok、 RongCallKit.framewrok繁莹、AgoraRtcEngineKit.framework 以及系統(tǒng)庫 CoreMotion.framework檩互、VideoToolbox.framework、libresolv.tbd咨演。
4闸昨、 在 Xcode 項目 “Build Settings -> Other Linker Flags” 中，增加"-ObjC"薄风。
快速集成
使用融云通話之前饵较，必須先初始化 SDK 和連接服務(wù)器，詳細內(nèi)容可以參考?IMKit SDK 集成文檔遭赂。
1. 發(fā)起通話
使用 CallKit 可以通過兩種方式發(fā)起通話：
在聊天界面輸入擴展的加號內(nèi)循诉，點擊音頻通話/視頻通話按鈕直接發(fā)送通話。
這個功能在 SDK 中已經(jīng)默認實現(xiàn)了撇他，您不需要做什么額外的操作茄猫。
調(diào)用 RCCall 類中的以下方法發(fā)起通話。
發(fā)起單人通話
// RCCall Class/*!
發(fā)起單人通話
@param targetId? 對方的用戶ID
@param mediaType 使用的媒體類型
*/- (void)startSingleCall:(NSString*)targetId? ? ? ? ? ? ?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?mediaType:(RCCallMediaType)mediaType;
選擇成員并發(fā)起多人通話
// RCCall Class/*!
選擇成員并發(fā)起多人通話
@param conversationType 會話類型
@param targetId? ? ? ? 會話目標ID
@param mediaType? ? ? ? 使用的媒體類型
@discussion 此方法會先彈出選擇成員界面困肩，選擇完成后再會發(fā)起通話划纽。目前支持的會話類型有討論組和群組。
@warning 如果您需要在群組中調(diào)用此接口發(fā)起多人會話锌畸，需要設(shè)置并實現(xiàn)groupMemberDataSource勇劣。
*/- (void)startMultiCall:(RCConversationType)conversationType? ? ? ? ? ? ?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?targetId:(NSString*)targetId? ? ? ? ? ?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? mediaType:(RCCallMediaType)mediaType;
需要注意的是，如果您需要在群組中調(diào)用此接口發(fā)起多人會話蹋绽，需要設(shè)置并實現(xiàn)?groupMemberDataSource?芭毙。
SDK 在選擇群組成員的時候筋蓖，會調(diào)用?getAllMembersOfGroup:result:?接口獲取群成員列表并顯示。
直接發(fā)起多人通話
// RCCall Class/*!
直接發(fā)起多人通話
@param conversationType 會話類型
@param targetId? ? ? ? 會話目標ID
@param mediaType? ? ? ? 使用的媒體類型
@param userIdList? ? ? 邀請的用戶ID列表
@discussion 此方法會直接發(fā)起通話退敦。目前支持的會話類型有討論組和群組粘咖。
@warning 您需要設(shè)置并實現(xiàn)groupMemberDataSource才能加人。
*/- (void)startMultiCallViewController:(RCConversationType)conversationType ? ?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?targetId:(NSString*)targetId ? ? ? ? ? ? ? ? ? ? ? ?
? ? ? ? ? ? ? ? ? ? ? ?mediaType:(RCCallMediaType)mediaType? ? ? ? ?
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? userIdList:(NSArray*)userIdList;
2. 通話接聽
當收到一個通話呼叫的時候侈百，
當 App 處于前臺狀態(tài)的時候瓮下，SDK 會自動彈出通話界面。
當 App 處于后臺活動狀態(tài)的時候钝域，SDK 會彈出本地通知并播放鈴聲讽坏。
當 App 處于后臺暫停狀態(tài)的時候，如果您的 App 開啟了實時音視頻后臺運行模式并在開發(fā)者后臺上傳了 VoIP 推送證書例证，這時候 App 會在后臺啟動并彈出本地通知路呜；否則，App 會收到遠程推送提醒织咧，VoIP Push 設(shè)置請參考?VoIP 推送設(shè)置文檔胀葱。
關(guān)于 App 運行狀態(tài)的更多信息，您可以參考?SDK 的運行狀態(tài)文檔笙蒙。
3. 會話是否支持發(fā)起通話
目前抵屿，SDK 支持在單聊發(fā)起單人通話，在討論組捅位、群聊中發(fā)起多人通話轧葛。
您可以通過 RCCall 類的以下接口查詢當前會話的通話能力。
// RCCall Class/*!
當前會話類型是否支持音頻通話
@param conversationType 會話類型
@return 是否支持音頻通話
*/- (BOOL)isAudioCallEnabled:(RCConversationType)conversationType;/*!
當前會話類型是否支持視頻通話
@param conversationType 會話類型
@return 是否支持視頻通話
*/- (BOOL)isVideoCallEnabled:(RCConversationType)conversationType;
4. 設(shè)置多人最大通話人數(shù)限制
CallKit?默認音頻通話最大人數(shù)為 20 人艇搀，視頻通話最大人數(shù)為 9 人尿扯。
如果不符合您的需求，您可以通過?RCCall?以下接口設(shè)置最大人數(shù)中符。
// RCCall Class/*!
音頻通話支持的最大通話人數(shù)
*/@property(nonatomic,assign)intmaxMultiAudioCallUserNumber;/*!
視頻通話支持的最大通話人數(shù)
*/@property(nonatomic,assign)intmaxMultiVideoCallUserNumber;
建議您在設(shè)置最大人數(shù)的時候姜胖，考慮移動設(shè)備的帶寬（主要是多路視頻通話）和UI交互友好。
CallLib?的話音頻和視頻人數(shù)默認均沒有限制淀散。
5. UI 界面說明
CallKit?中默認實現(xiàn)了一套較為通用的通話 UI，包含單人音視頻通話界面?RCCallSingleCallViewController?蚜锨、多人音頻通話界面RCCallAudioMultiCallViewController?档插、多人視頻通話界面?RCCallVideoMultiCallViewController、最小化的通話界面?RCCallFloatingBoard亚再、聊天界面的通話提示?RCCallDetailMessageCell郭膛、RCCallTipMessageCell等。
如果能滿足您的需求氛悬，您可以基于?CallKit?直接開發(fā)则剃，如果您的需求較為特殊耘柱，可以直接使用?CallLib?并實現(xiàn)相關(guān)的界面UI，您也可以向我們商務(wù)索取CallKit?源碼以供參考棍现。
實時音視頻推送設(shè)置
詳細請參考?VoIP 推送設(shè)置文檔调煎。
