開發(fā)者如何調(diào)用直播SDK或API接入直播功能

1、趣看云視頻直播點(diǎn)播服務(wù)視頻直播推流SDK iOS開發(fā)指南版本：1.02016.05SDK 概述趣看IOS視頻直播推流 SDK 是一個(gè)強(qiáng)大的實(shí)時(shí)直播推流引擎，可用于構(gòu)建直播互動(dòng)、美女秀場、遠(yuǎn)程教育等產(chǎn)品。推薦精選SDK 提供了構(gòu)建直播推流所需要的所有核心技術(shù)，包括：音視頻管理、音視頻采集、編碼、網(wǎng)絡(luò)傳輸、顯示等功能。SDK 支持 iOS 7.0 及以上系統(tǒng)。開發(fā)準(zhǔn)備 在趣看后臺生成賬號，獲取到賬號對應(yīng)的APPKEY 下載視頻直播推流 iOS SDK 解壓下載的視頻直播推流 SDK 開發(fā)包，將頭文件和靜態(tài)庫都導(dǎo)入工程。 添加 IPCameraSDK依賴庫o UIKit.frameworko Cor

2、eImage.frameworko QuartzCore.frameworko AVFoundation.framworko OpenGLES.frameworko CoreMedia.frameworko CoreVideo.frameworko CoreGraphics.frameworko Security.frameworko Foundation.frameworko CFNetwork.framework 在 Other Linker Flags 中添加 -ObjC 在需要使用 SDK 的地方 import IPCameraSDK.h直播流程展示圖推薦精選 IOS接口函數(shù)調(diào)用圖趣看

3、直播使用接入非常簡易，只需要接入SDK后，實(shí)現(xiàn)流程圖中的5個(gè)方法，即可實(shí)現(xiàn)實(shí)時(shí)視頻直播。SDK 類說明SDK 所有功能都封裝在 IPCameraSDK類中，下面詳細(xì)介紹下 IPCameraSDK類的功能。初始化Appkey+(int)initAppkey:(NSString*)appkey;推薦精選此接口提供用戶只需要設(shè)置賬戶的Appkey，即可開通直播權(quán)限。設(shè)置后，sdk會發(fā)送一個(gè)通知Notification，通知中攜帶Appkey驗(yàn)證信息。初始化SDK委托+(void)initSDKDelegate:(id)delegate;此接口初始化IPCameraSDK接口，并設(shè)置錯(cuò)誤消息的回調(diào)接口

4、；如果設(shè)置了代理，后面sdk產(chǎn)生了錯(cuò)誤的消息，會回調(diào)方法IPCameraSDKSupportFun。 錯(cuò)誤回調(diào)代理-(void)IPCameraSDKSupportFun:(UInt16)type ErrorString:(NSString*) error根據(jù)返回的錯(cuò)誤信息，判斷Appkey的驗(yàn)證、直播中錯(cuò)誤信息、推流情況。 直播結(jié)束后，清除委托+(void) cleanupDelegate;直播參數(shù)設(shè)置IPCameraSDK中直播相關(guān)的參數(shù)為：視頻的清晰度、視頻的碼率、視頻的幀率，還可以設(shè)置設(shè)備朝向，主要用于糾正用戶直播中，設(shè)備旋轉(zhuǎn)導(dǎo)致的畫布顯示也旋轉(zhuǎn)的問題。設(shè)置RTMP重連時(shí)間，用于在推流

5、連接斷開后，進(jìn)行重連： 設(shè)置視頻清晰度-( BOOL) setCameraEncodeType:(NSInteger)encodeType; 設(shè)置視頻碼率+( BOOL)setCameraVideoBitRate:(NSInteger)videobitrate; 設(shè)置視頻幀率+(BOOL)setVideoFrame:(int)videobitrate; 設(shè)置設(shè)備朝向+(void)setAppOrientation:(UIInterfaceOrientation)orientation;推薦精選目前支持：豎屏 UIInterfaceOrientationPortrait，橫屏 UIInterfa

6、ceOrientationLandscapeRight 設(shè)置RTMP重連時(shí)間+(void)setRtmpReConnectTime:(int)iTime；設(shè)置rtmp重連時(shí)間，默認(rèn)為500毫秒重連一次，可以手動(dòng)更改，參數(shù)必須要大于或等于500毫秒攝像頭開關(guān)（startCamera與stopCamera）IPCameraSDK提供用戶開啟和關(guān)閉攝像頭的操作： 直播前開啟攝像頭+(int) startCameraNoEncodeType:(UIView *)view VideoPath:(NSString*) videoPath GainValue:(float)gain_value Orient

7、ation:(AVCaptureVideoOrientation)Orientation Camera:(NSInteger)cameraValue;view：攝像頭采集到的畫面，所顯示的畫布。VideoPath：選錄像文件，在documents下保存的相對路徑，不需要錄像可以填nil。GainValue：聲音增大效果 范圍 0 1.Oreintation：豎屏拍攝還是橫屏拍攝，AVCaptureVideoOrientationPortrait豎拍 AVCaptureVideoOrientationLandscapeRight橫拍.CameraValue:攝像頭。0：前置攝像頭 1、后置攝像頭

8、。 直播完成后關(guān)閉攝像頭-(void)stopCamera;開始和斷開推送視頻數(shù)據(jù)IPCameraSDK提供視頻推送數(shù)據(jù)開啟和關(guān)閉的接口，方便用戶控制那些數(shù)據(jù)需要推送，那些數(shù)據(jù)不需要： 開始推送視頻數(shù)據(jù)+(int) startRtmp :(NSString *)rtmp_server_address；開啟推送視頻數(shù)據(jù)的線程，與中斷數(shù)據(jù)推送相配對。 中斷數(shù)據(jù)推送推薦精選+(int) stopRtmp;中斷數(shù)據(jù)推送，中斷后，只要攝像頭沒關(guān)閉，還可以調(diào)用startRtmp，重新開啟視頻推送。開啟美顏功能IPCameraSDK提供接口，開啟美顏功能：+(int)setEffect:(BOOL)valu

9、e；參數(shù)Value：YES開啟美顏，NO 關(guān)閉美顏，返回值0 表示成功，1 表示無美顏功能權(quán)限，2表示機(jī)器不支持該功能開啟或者關(guān)閉音頻IPCameraSDK在開啟攝像頭后，提供任意時(shí)刻的開關(guān)音頻的功能:+(void) switchAudio :(int) audioType;參數(shù) 0 關(guān)閉音頻，1 開啟音頻。直播中修改聲音增益的效果IPCameraSDK在開啟攝像頭后，提供任意時(shí)刻的修改聲音增益屬性:+(void) changeGainValue : (float)gain_value;參數(shù)gain_value范圍0-1，聲音增益的幅度，0最小 1最大。切換攝像頭IPCameraSDK在開啟攝

10、像頭后，提供在任意時(shí)刻的前后攝像頭切換功能:+(BOOL) switchChangeCamera : (int) cameraValue;返回切換攝像頭成功或者失敗，參數(shù) 0：啟動(dòng)前置攝像頭 1：啟用后置攝像頭。攝像頭閃光燈的開啟和關(guān)閉IPCameraSDK在開啟攝像頭后，可以開啟或者關(guān)閉閃光燈。推薦精選+(BOOL) switchFlash:(int)flashFlag;返回開啟閃光燈成功或者失敗，參數(shù)： 0：關(guān)閉閃光燈。 1：開啟閃光燈。攝像頭聚焦模式改變IPCameraSDK在開啟攝像頭后，可以改變其聚焦模式。+(BOOL) switchFocusMode : (int) focusTy

11、pe;返回改變聚焦模式成功或者失敗，參數(shù)： 0：自動(dòng)聚焦。 1：手動(dòng)聚焦。 手動(dòng)聚焦設(shè)置焦點(diǎn)+(void) manualFocus:(CGPoint) touchPoint TouchView:(UIView *)view;在調(diào)用switchFocusMode(1)后，切換到手動(dòng)聚焦的模式，就可以調(diào)用該函數(shù)使手機(jī)的攝像頭修改聚焦的焦點(diǎn)位置。攝像頭焦距改變IPCameraSDK在開啟攝像頭并且你的設(shè)備系統(tǒng)高于IOS7，設(shè)備型號為Iphone5及以上設(shè)備，你可以在任意時(shí)刻實(shí)時(shí)改變攝像頭的焦距:+(void) zoomOut : (float) scale；在開啟攝像頭后，就可以設(shè)置攝像機(jī)焦距，參數(shù)

12、范圍：1-10，1 物體正常大小 10 物體被放大多倍。設(shè)置和清除水印IPCameraSDK提供設(shè)置水印的接口，用于給視頻添加Logo，在初始化SDK后可以調(diào)用： 設(shè)置水印+(void)setUserImage:(UIImage*)logoimg Transparent:(int)transparent Offset:(int) offset;參數(shù)transparent logo圖片的透明度 0-10之間，0完全透明，10不透明，參數(shù)offset logo圖片的位置 0 表示設(shè)置logo在左上角 1表示設(shè)置logo在右上角。每次設(shè)置logo前，先調(diào)用clearUserImage 清除已有l(wèi)og

13、o。Logo要針對分辨率進(jìn)行設(shè)置，其中，所有16：9的圖像 logo 標(biāo)準(zhǔn)按照 1280*720來的，640*480 與352*288的logo需單獨(dú)設(shè)置。 清除水印推薦精選+(void)clearUserImage;清除已有l(wèi)ogo水印。直播健康狀況、實(shí)時(shí)流量以及總流量的統(tǒng)計(jì)IPCameraSDK提供設(shè)置查詢直播健康狀況、實(shí)時(shí)流量、總流量的接口，還能清空當(dāng)前總流量的統(tǒng)計(jì)。 查詢視頻健康狀況+(int)getNetPercent;該函數(shù)用于檢測當(dāng)前直播時(shí)網(wǎng)絡(luò)數(shù)據(jù)發(fā)送的狀態(tài)。如果數(shù)據(jù)發(fā)送不流暢，比如返回值大約為2或3，那么視頻觀看可能會發(fā)現(xiàn)略微有些卡頓；如果網(wǎng)絡(luò)狀態(tài)為0或1，那么視頻可能會非常的

14、卡，或者網(wǎng)絡(luò)不通。用戶可以根據(jù)這個(gè)值，考慮如何改善現(xiàn)場的網(wǎng)絡(luò)情況。 查詢視頻實(shí)時(shí)流量+(double)getNowFlow;獲取用戶直播時(shí)候前一秒消耗的流量 查詢視頻總流量+(double)getAllFlow;獲取用戶直播總流量，總流量數(shù)據(jù)不手動(dòng)清空，會在本次APP運(yùn)行中一直疊加 清空總流量統(tǒng)計(jì)+(void)clearAllFlow;清空總流量消耗統(tǒng)計(jì)直播sdk版本號IPCameraSDK提供接口，獲取當(dāng)前 sdk 版本號：+(NSString*)getVersion;推薦精選=API文檔IPCameraSDK.h+(int)initAppkey:(NSString*)appkey; 初始化

15、appkey+(void)initSDKDelegate:(id)delegate; 設(shè)置錯(cuò)誤回調(diào)通知代理+(void) cleanupDelegate; 清除代理+(int) startCameraNoEncodeType:(UIView *)view VideoPath:(NSString*) videoPath GainValue:(float)gain_value Orientation:(AVCaptureVideoOrientation)Orientation Camera:(NSInteger)cameraValue; 開啟攝像頭+(void) stopCamera; 關(guān)閉攝像頭

16、+(BOOL)setVideoFrame:(int)videoframe; 設(shè)置幀率+(BOOL)setCameraEncodeType:(NSInteger)encodeType; 設(shè)置視頻清晰度+(BOOL)setCameraVideoBitRate:(NSInteger)videobitrate; 設(shè)置視頻碼率+(void)setAppOrientation:(UIInterfaceOrientation)orientation; 設(shè)置設(shè)備朝向，目前支持：豎屏 UIInterfaceOrientationPortrait，橫屏 UIInterfaceOrientationLandscap

17、eRight+(void)setRtmpReConnectTime:(int)iTime; rtmp的重連的時(shí)間，單位毫秒+(int) startRtmp :(NSString *)rtmp_server_address; 開啟rtmp發(fā)送 需要傳入rtmp的地址 0正常 -1 啟動(dòng)非正常 -2APPKEY驗(yàn)證未能正常進(jìn)行，常為網(wǎng)絡(luò)不佳情況導(dǎo)致 -3 地址不和法或者云端地址配置錯(cuò)誤 -4 APPKey是無效的+(void) stopRtmp; 關(guān)閉rtmp發(fā)送推薦精選+(void)setUserImage:(UIImage*)logoimg Transparent:(int)transpare

18、nt Offset:(int) offset; 添加logo，transparent為logo所占的透明度，參數(shù) 0 -10，offset目前支持kImageLeftOffset左邊和kImageRightOffset右邊+(void)clearUserImage; 清空所有l(wèi)ogo/ +(BOOL) switchFlash:(int)flashFlag; 開啟或關(guān)閉閃光燈：0 關(guān)閉 1 開啟+(void) switchAudio :(int) audioType; 音頻開關(guān)：0 關(guān)閉音頻 ， 1 打開音頻+(BOOL) switchChangeCamera : (int) cameraValue; 攝像頭切換：0 前置攝像頭 ， 1 后置攝像頭 +(BOOL) switchFocusMode : (int) focusType; 設(shè)置聚焦：0 自動(dòng)聚焦 ， 1 手動(dòng)聚焦+(void) manualFocus:(CGPoint) touchPoint TouchView:(UIView *)view; 手動(dòng)聚焦的聚焦點(diǎn)+(void) zoomOut : (float) scale; 攝像頭焦距設(shè)置+(void) changeGainValue :