集成百度SDK注意事項(xiàng):
?下載百度iOS端推流SDK翔冀。
?準(zhǔn)備iOS運(yùn)行環(huán)境:iOS 7.0及以上的所有系統(tǒng)朋截。
?適配CPU指令集:armv6、armv7/armv7s愿伴、arm64踊赠、i386/x86_64呵扛。
添加依賴:(1)將Baidu-Capture-SDK-iOS-x.x.x/lib目錄下的頭文件VCSimpleSession.h添加到Xcode工程。(2)添加推流SDK所依賴的iOS框架筐带,視頻編解碼API (VideoToolbox.framework)及壓縮工具(libz.1.1.3.dylib或libz.1.1.3.tbd)今穿。(3)添加推流SDK的靜態(tài)庫文件:使用真機(jī)調(diào)試、發(fā)布伦籍,須添加Baidu-Capture-SDK-iOS-x.x.x/lib/arm目錄下所列靜態(tài)庫蓝晒;使用模擬器調(diào)試、發(fā)布帖鸦,則添加Baidu-Capture-SDK-iOS-x.x.x/lib/x86目錄下所列靜態(tài)庫芝薇。(注意,使用模擬機(jī)和真機(jī)一定要添加對(duì)應(yīng)的靜態(tài)庫)在Xcode中將這些框架和SDK的靜態(tài)庫文件添加到用戶的工程里作儿。
調(diào)用推流SDK中已封裝的API進(jìn)行開發(fā):
1洛二、初始化VCSimpleSession
推流SDK提供如下四種方法完成初始化:
?(1)
initWithVideoSize:(CGSize)videoSize frameRate:(int)fpsbitrate:(int)bps;
VCSimpleSession?*session?=?[VCSimpleSession?alloc];
[session?initWithVideoSize:CGSizeMake(720,?1280)?frameRate:20?bitrate:1024000];
?(2)
initWithVideoSize:(CGSize)videoSize frameRate:(int)fpsbitrate:(int)bps useInterfaceOrientation:(BOOL)useInterfaceOrientation;
VCSimpleSession?*session?=?[VCSimpleSession?alloc];
[session?initWithVideoSize:CGSizeMake(720,?1280)?frameRate:20?bitrate:1024000?useInterfaceOrientation:YES];
?(3)
initWithVideoSize:(CGSize)videoSize frameRate:(int)fpsbitrate:(int)bps useInterfaceOrientation:(BOOL)useInterfaceOrientationcameraState:(VCCameraState) cameraState;
VCSimpleSession?*session?=?[VCSimpleSession?alloc];
VCCameraState?camState?=?VCCameraStateFront;
[session?initWithVideoSize:CGSizeMake(720,?1280)?frameRate:20?bitrate:1024000?useInterfaceOrientation:YES?cameraState:camState];
?(4)
initWithVideoSize:(CGSize)videoSize frameRate:(int)fpsbitrate:(int)bps useInterfaceOrientation:(BOOL)useInterfaceOrientation cameraState:(VCCameraState)cameraState aspectMode:(VCAspectMode) aspectMode;
VCSimpleSession?*session?=?[VCSimpleSession?alloc];
VCCameraState?camState?=?VCCameraStateFront;
[session?initWithVideoSize:CGSizeMake(720,?1280)?frameRate:20?bitrate:1024000?useInterfaceOrientation:YES?cameraState:camState?aspectMode:aspectMode];
2、開始推流
初始化成功后攻锰,可以通過startRtmpSessionWithURL方法設(shè)置推流地址并開始推流晾嘶。
以下示例代碼使用startRtmpSessionWithURL設(shè)置推流路徑并開始推流,推流URL的具體值為:
rtmp://192.168.1.177:1935/zqnblive/zqnb/177_film娶吞。
[session?startRtmpSessionWithURL:@"rtmp://192.168.1.177:1935/zqnblive/zqnb/"?andStreamKey:@"177_film"];
注意:rtmp推流的地址一般格式為rtmp://{IP:PORT}/{Application}/{Channel}/{Stream}垒迂,這個(gè)方法第一個(gè)參數(shù)就是rtmp://{IP:PORT}/{Application}/{Channel},第二個(gè)參數(shù)andStreamKey對(duì)應(yīng)的就是{Stream}寝志。
3娇斑、結(jié)束推流
開始推流成功后策添,您隨時(shí)可以結(jié)束推流材部。
以下示例代碼使用endRtmpSession結(jié)束推流。
[session?endRtmpSession];
4唯竹、監(jiān)聽推流過程中的通知
?偵聽name為RTMP_Started的系統(tǒng)消息以獲取推流開始的事件示例代碼:
[[NSNotificationCenter?defaultCenter]?addObserver:self?selector:@selector(handleRTMPStartedMessage:)?name:RTMP_Started?object:nil];
(void)?handleRTMPStartedMessage:(NSNotification*)notification?{
NSLog(@"RTMP?Streaming?was?started..\n");
}
?偵聽name為RTMP_Error的系統(tǒng)消息以獲取推流異常的事件示例代碼:
[[NSNotificationCenter?defaultCenter]?addObserver:self?selector:@selector(handleRTMPErrorMessage:)?name:RTMP_Error?object:nil];
(void)?handleRTMPErrorMessage:(NSNotification*)notification?{
NSLog(@"Error?occurred?in?Streaming..\n");
}
注意:在收到RTMP_Started消息之前乐导,請(qǐng)勿調(diào)用endRtmpSession,否則將造成資源釋放異常浸颓。
5物臂、處理推流SDK狀態(tài)變化事件
在VCSimpleSession接口中旺拉,您可以通過實(shí)現(xiàn)名為VCSessionDelegate的protocol,實(shí)時(shí)接收到推流SDK的一些屬性及狀態(tài)更新信息棵磷。
protocol定義如下:
@protocol?VCSessionDelegate?
@required
-?(void)?connectionStatusChanged:?(VCSessionState)?sessionState;
@optional
-?(void)?didAddCameraSource:(VCSimpleSession*)session;
@end
以下示例代碼演示了如何實(shí)現(xiàn)protocol對(duì)session狀態(tài)變化事件進(jìn)行處理:
-?(void)?connectionStatusChanged:(VCSessionState)?state
{
switch(state)?{
case?VCSessionStateStarting:
NSLog(@"Current?state?is?VCSessionStateStarting\n");
[self.btnConnect?setImage:[UIImage?imageNamed:@"block.png"]?forState:UIControlStateNormal];
break;
case?VCSessionStateStarted:
NSLog(@"Current?state?is?VCSessionStateStarted\n");
[self.btnConnect?setImage:[UIImage?imageNamed:@"to_stop.png"]?forState:UIControlStateNormal];
break;
case?VCSessionStateError:
NSLog(@"Current?state?is?VCSessionStateError\n");
[self.btnConnect?setImage:[UIImage?imageNamed:@"to_start.png"]?forState:UIControlStateNormal];
break;
default:
NSLog(@"Current?state?is?VCSessionStateEnded\n");
[self.btnConnect?setImage:[UIImage?imageNamed:@"to_start.png"]?forState:UIControlStateNormal];
break;
}
}
注意:在protocol定義中蛾狗,connectionStatusChanged為必選方法,當(dāng)推流SDK狀態(tài)發(fā)生改變時(shí)仪媒,該方法會(huì)被調(diào)用沉桌,參數(shù)sessionState即為當(dāng)前推流session所處的狀態(tài)。
sessionState參數(shù)為VCSessionState類型算吩,定義如下:
typedef?NS_ENUM(NSInteger,?VCSessionState)
{
VCSessionStateNone,?//推流SDK的初始狀態(tài)
VCSessionStatePreviewStarted,?//推流SDK開始出現(xiàn)預(yù)覽畫面
VCSessionStateStarting,?//推流SDK開始連接服務(wù)器
VCSessionStateStarted,?//推流已經(jīng)開始
VCSessionStateEnded,?//推流已經(jīng)結(jié)束
VCSessionStateError?//推流SDK出錯(cuò)
};
在狀態(tài)VCSessionStateStarting與VCSessionStateStarted之間留凭,推流SDK正在后臺(tái)連接RTMP服務(wù)器,此時(shí)請(qǐng)勿對(duì)VCSimpleSession對(duì)象進(jìn)行任何操作偎巢。
其中蔼夜,didAddCameraSource為可選方法。
當(dāng)推流SDK創(chuàng)建CameraSource(即相機(jī)被占用)后压昼,didAddCameraSource方法會(huì)被調(diào)用求冷,參數(shù)session為VCSimpleSession對(duì)象。
在這里和大家分享一下我集成的過程中遇到的問題:
1窍霞、所有的關(guān)于靜態(tài)庫的地方都報(bào)錯(cuò)遵倦,你會(huì)發(fā)現(xiàn)有幾十個(gè)bug,這個(gè)時(shí)候不妨添加libc++這個(gè)類庫試試看官撼,這個(gè)是由于靜態(tài)庫中運(yùn)用了c與oc混編梧躺。
2、No architectures to compile for (ONLY_ACTIVE_ARCH=YES, active arch=x86_64, VALID_ARCHS這個(gè)錯(cuò)誤
3傲绣、_OBJC_CLASS_$_某文件名", referenced from:掠哥,遇到這個(gè)問題也分為幾個(gè)情況
(1).m文件沒有導(dǎo)入在Build Phases里的Compile Sources中添加報(bào)錯(cuò)的文件
(2).framework文件沒有導(dǎo)入靜態(tài)庫編譯時(shí)往往需要一些庫的支持,查看你是否有沒有導(dǎo)入的庫文件秃诵,同樣是在Build Phases里的Link Binary With Libraries中添加
(3)重復(fù)編譯续搀,可能你之前復(fù)制過兩個(gè)地方,在這里添加過兩次菠净,刪除時(shí)系統(tǒng)沒有默認(rèn)刪除編譯引用地址禁舷,在Build Settings里搜索Search Paths將里面Library Search Paths中沒有用到的地址刪除
(4)最后一個(gè)問題,出在靜態(tài)庫生成上面毅往。系統(tǒng)編譯生成的靜態(tài)庫有兩個(gè)牵咙,一個(gè)真機(jī)調(diào)用的,一個(gè)模擬器調(diào)用的攀唯。當(dāng)你在真機(jī)測(cè)試時(shí)導(dǎo)入模擬器靜態(tài)庫洁桌,運(yùn)行就會(huì)報(bào)錯(cuò);同樣在模擬器測(cè)試時(shí)調(diào)用真機(jī)靜態(tài)庫也會(huì)報(bào)錯(cuò)侯嘀。也可以將兩個(gè)靜態(tài)庫合并另凌,生成一個(gè)兼容的靜態(tài)庫谱轨。