前提條件

請下載最新版本的直播推流SDK。

新版直播推流SDK，請參見SDK下載。

升級步驟

從項目中移除SDK V4.0.2相關類庫和資源文件，添加V4.1.0及以上版本相關類庫和資源文件，排查并更新相關API和推流主流程接口。

1. 在工程libs目錄下：用V4.1.0及以上版本中需要加入AlivcLivePusher.framework和AlivcLibRtmp.framework替換V4.0.2項目中的AliLivesdk.framework。

2. 播放器相關SDK需要升級到AliyunPlayer，請參考SDK及Demo中使用的SDK。

3. 如果接入Queen智能美化特效，請在Demo中查看使用方式，方便美顏SDK及UI的接入。

4. 相關API會有部分調整，請根據下文核心接口比對排查并更新當前代碼中的API。

5. 推流主流程接口有部分變更，請根據下文推流主流程接口變更修改當前代碼。

核心接口對比

• 基礎接口

  V4.0.2	V4.1.0及以上版本	描述
  getSdkVersion	getSdkVersion	獲取版本號。
  initWithConfig	initWithConfig	創建推流實例。
  destorySdk	destroy	銷毀推流。
  setStatusDelegate setRtsDelegate setVidePreProcessDelegate setDataStatsDelegate	AlivcPublisherViewDelegate AlivcLivePusherInfoDelegate AlivcLivePusherErrorDelegate	RTC推流模式下訂閱某個粉絲媒體相關回調，詳情請參見AliLiveRtsDelegate設置視頻前處理回調。設置直播媒體參數回調。
  setNetworkDelegate	AlivcLivePusherNetworkDelegate	設置推流網絡狀態相關回調。
  setLogDirPath	無：自定義Log寫入	設置SDK日志文件保存路徑。如需調用，請在調用所有API之前先調用此接口，避免日志出現丟失，同時保證指定的目錄已存在且可寫入。
  setLogLevel	無	設置日志輸出級別。

• 推流基礎接口

  V4.0.2	V4.1.0及以上版本	描述
  startPreview	startPreview	開始預覽（主播端接口）。
  stopPreview	stopPreview	停止預覽（主播端接口）。
  pausePush	pause	暫停攝像頭采集并進入墊片推流狀態（僅支持RTMP模式推流）。需要先調用startPush后才可以調用pausePush，否則調用順序會出錯。
  resumePush	resume()	恢復攝像頭采集并結束墊片推流狀態（僅支持RTMP模式推流）。需要先調用pausePush后才可以調用resumePush，否則調用順序會出錯。
  startPush	startPushWithURL	開始推流。
  stopPush	stopPush	停止推流。
  isPublishing	isPushing	查詢是否正在推流。
  getPublishUrl	getPushURL	獲取當前推流的地址。

• 視頻相關接口

  V4.0.2	V4.1.0及以上版本	描述
  setPreviewMode	setpreviewDisplayMode	設置預覽模式。
  switchCamera	switchCamera	切換前后攝像頭。
  setCameraZoom	setZoom	設置攝像頭縮放及是否允許閃光燈。
  isCameraExposurePointSupported	setExposure	攝像頭是否支持設置曝光區域。
  setCameraFocusPoint	setAutoFocus	設置攝像頭聚焦。

• 音頻相關接口

  V4.0.2	V4.1.0及以上版本	描述
  setMute	setMute	設置本地音頻采集是否為靜音幀。
  isAudioOnly	isAudioOnly	查詢是否純音頻推流。
  enableEarBack	setBGMEarsBack	啟用耳返。建議在插入耳機后開啟耳返，否則可能會引入回聲。
  playBGM	startBGMAsync	播放背景音樂。
  stopBGM	stopBGM	停止播放背景音樂。
  pauseBGM	pauseBGM	暫停播放背景音樂。
  resumeBGM	resumeBGM	恢復播放背景音樂。
  setBGMVolume	setBGMVolume	設置背景音樂音量。

推流主流程接口變更

1. 創建Engine。

   創建AliLiveEngine（V4.0.2）

   V4.1.0及以上版本改為：創建AlivcLivePusher

   //創建RTMP相關配置對象 頭文件引用。#import <AliLiveSdk/AliLiveSdk.h> 創建AliLiveEngine。AliLiveConfig *config = [[AliLiveConfig alloc] init]; config.videoProfile = AliLiveVideoProfile_540P; config.videoFPS = 20; myConfig.pauseImage = [UIImage imageNamed:@"background_img.png"]; myConfig.accountID = @""; AliLiveEngine *engine = [[AliLiveEngine alloc] initWithConfig:myConfig]; [engine setAudioSessionOperationRestriction:AliLiveAudioSessionOperationRestrictionDeactivateSession]; [engine setRtsDelegate:self]; [engine setStatusDelegate:self];

   在需要使用推流器的ViewController中引用頭文件#import <AlivcLivePusher/AlivcLivePusherHeader.h>，示例代碼如下： //初始化推流配置類，也可使用initWithResolution來初始化 AlivcLivePushConfig *config = [[AlivcLivePushConfig alloc] init]; //默認為540P，最大支持720P config.resolution = AlivcLivePushResolution540P; //建議用戶使用20fps config.fps = AlivcLivePushFPS20; // 打開碼率自適應，默認為true config.enableAutoBitrate = true; //默認值為2，關鍵幀間隔越大，延時越高。建議設置為1-2 config.videoEncodeGop = AlivcLivePushVideoEncodeGOP_2; // 單位為毫秒，重連時長2s，重連間隔設置不小于1秒，建議使用默認值即可 config.connectRetryInterval = 2000; // 默認為false，正常情況下都選擇false即可 config.previewMirror = false; // 默認為豎屏，可設置home鍵向左或向右橫屏 config.orientation = AlivcLivePushOrientationPortrait;

2. 創建預覽。

   V4.0.2	V4.1.0及以上版本
   開始預覽。[self.engine startPreview:self.renderView];	推流預覽顯示支持以下三種模式： 這三種模式可以在AlivcLivePushConfig中設置，也可以在預覽中和推流中通過API setpreviewDisplayMode 進行動態設置。 [self.livePusher startPreview:self.view];

3. 開始推流。

   V4.0.2	V4.1.0及以上版本
   [self.engine startPushWithURL:self.pushUrl];	[self.livePusher startPushWithURL:@"推流測試地址(rtmp://......)"];

4. 停止推流。

   V4.0.2	V4.1.0及以上版本
   [self.engine stopPush]; [self.engine stopPreview]; [self.engine destorySdk]; self.engine = nil;	[self.livePusher destory]; self.livePusher = nil; /*獲取推流狀態。*/ AlivcLivePushStatus status = [self.livePusher getLiveStatus];