ApsaraVideo Live:機能の使用方法

SDK の登録

ライセンスの申請および設定については、「Push SDK ライセンスの統合」をご参照ください。

ライセンス登録インターフェイスは、[早い]段階 (Push SDK を使用する前) で呼び出してください。

[AlivcLiveBase registerSDK];

• AlivcLiveBase クラスでは、ログレベルの設定、ローカルログパスの指定、SDK バージョンの取得ができます。

• AlivcLiveBase#setObserver インターフェイスのonLicenceCheck メソッドを使用すると、ライセンスが正常に設定されたかどうかを非同期に確認できます。

ストリームパラメーターの設定

プッシャーを使用する ViewController で、ヘッダーファイルをインポートします：#import <AlivcLivePusher/AlivcLivePusher.h>。

基本的なアップストリーミング パラメーターには推奨されるデフォルト値が設定されているため、追加の設定を行わずに簡単に初期化できます。

AlivcLivePushConfig *config = [[AlivcLivePushConfig alloc] init]; // アップストリーミング設定クラスを初期化します。initWithResolution も使用できます。
config.resolution = AlivcLivePushResolution540P; // デフォルトの解像度は 540p です。最大は 720p です。
config.fps = AlivcLivePushFPS20; // フレームレートは 20 fps を推奨します。
config.enableAutoBitrate = true; // ビットレート制御を有効にします。デフォルト値は true です。
config.videoEncodeGop = AlivcLivePushVideoEncodeGOP_2; // デフォルト値は 2 です。キーフレーム間隔が大きいほどレイテンシーが大きくなります。値は 1 または 2 を推奨します。
config.connectRetryInterval = 2000; // 再接続間隔 (ミリ秒) です。デフォルトは 2000 ms (2s) です。間隔は 1s 以上である必要があります。デフォルト値の使用を推奨します。
config.previewMirror = false; // デフォルト値は false です。通常は false にしてください。
config.orientation = AlivcLivePushOrientationPortrait; // デフォルトの向きは縦向きです。ホームボタンが左または右にある横向きに設定できます。

カメラストリームのインジェスト

1. SDK を初期化します。

   インジェストパラメーターを設定した後、initWithConfig メソッドを呼び出して SDK を初期化します。サンプルコード：

   self.livePusher = [[AlivcLivePusher alloc] initWithConfig:config];

   説明

   AlivcLivePusher は複数インスタンスをサポートしていません。そのため、各 init 呼び出しに対して、対応する destroy 呼び出しを行う必要があります。

2. インジェストのコールバックを登録します。

   次のストリーム取り込みコールバックがサポートされています。

   • Info: 通知とステータス検出に使用されるコールバック。

   • エラー: エラーが発生したときに返されるコールバック。

   • ネットワーク: ネットワークに関連するコールバック。

   デリゲートを登録して、対応するコールバックを受信します。サンプルコード：

   [self.livePusher setInfoDelegate:self];
   [self.livePusher setErrorDelegate:self];
   [self.livePusher setNetworkDelegate:self];

3. プレビューを開始します。

   livePusher オブジェクトを初期化した後、プレビューを開始できます。カメラプレビュー用に、UIView のサブクラスである表示ビューを渡す必要があります。サンプルコード：

   [self.livePusher startPreview:self.view];

4. インジェストを開始します。

   プレビューが成功した後にのみ、インジェストを開始できます。これを行うには、AlivcLivePusherInfoDelegate の onPreviewStarted コールバックをリッスンし、コールバック内に次のコードを追加します。

   [self.livePusher startPushWithURL:@"Test ingest URL (rtmp://......)"];

   説明

   • インジェスト URL は、RTMP および RTS (artc://) プロトコルをサポートしています。URL の取得方法については、「インジェスト URL とストリーミング URL の生成」をご参照ください。

   • ApsaraVideo Live では、同じ URL へ複数のストリームを同時にインジェストすることはできません。2 つ目のインジェスト リクエストは拒否されます。

/* フロントカメラとリアカメラを切り替えます。 */
[self.livePusher switchCamera];
/* フラッシュをオンまたはオフにします。フロントカメラではフラッシュを使用できません。 */
[self.livePusher setFlash:false]; 
/* 焦点距離を調整して、キャプチャした画像をズームします。正の値で拡大し、負の値で縮小します。 */
CGFloat max = [_livePusher getMaxZoom];
[self.livePusher setZoom:MIN(1.0, max)]; 
/* フォーカスを手動で設定します。次の 2 つのパラメーターを渡す必要があります：1. point：フォーカスポイントの座標。2. autoFocus：この操作に対してオートフォーカスを有効にするかどうか。以降のオートフォーカスの動作は、前回設定した値に従います。 */
[self.livePusher focusCameraAtAdjustedPoint:CGPointMake(50, 50) autoFocus:true];
/* オートフォーカスを有効または無効にします。 */
[self.livePusher setAutoFocus:false];
/* ミラーリングを設定します。ミラーリングのインターフェイスは 2 つあります。インジェスト ストリーム用の PushMirror と、プレビュー用の PreviewMirror です。PushMirror は再生表示にのみ影響し、PreviewMirror はプレビュー表示にのみ影響します。両者は独立しています。 */
[self.livePusher setPushMirror:false];
[self.livePusher setPreviewMirror:false];

/* pauseImage を設定してから pause を呼び出し、カメラ配信から静止画配信に切り替えます。オーディオのインジェストは継続されます。 */
[self.livePusher pause];
/* 静止画配信からカメラ配信に戻します。オーディオのインジェストは継続されます。 */
[self.livePusher resume];
/* 現在のインジェストを停止します。これは、ストリームがアクティブな場合にのみ呼び出すことができます。 */
[self.livePusher stopPush];
/* プレビューを停止します。これはプレビュー 状態のときにのみ呼び出すことができ、アクティブなインジェスト中には呼び出せません。停止後、プレビュー表示は最後のフレームでフリーズします。 */
[self.livePusher stopPreview];
/* ストリームを再起動します。これは、アクティブなストリームのインジェスト中、またはエラー状態で呼び出すことができます。エラー状態の場合、呼び出せるのはこのメソッド、reconnectPushAsync、または destroy のみです。この操作により、プレビューとインジェストを含む、内部の AlivcLivePusher リソースがすべて再起動されます。 */
[self.livePusher restartPush];
/* ストリームを非同期に再接続します。これは、アクティブなストリーム中、または AlivcLivePusherNetworkDelegate からのネットワーク関連エラー状態で呼び出すことができます。エラー状態の場合、restartPush または destroy も呼び出せます。この操作は、RTMP 接続の再確立を試みます。 */
[self.livePusher reconnectPushAsync];
/* インジェストインスタンスを破棄します。これにより、インジェストとプレビューが停止し、プレビュー表示が削除されます。AlivcLivePusher に関連するすべてのリソースが解放されます。 */
[self.livePusher destroy];
self.livePusher = nil;
/* 現在のインジェストステータスを取得します。 */
AlivcLivePushStatus status = [self.livePusher getLiveStatus];

画面共有インジェスト

iOS 9 で導入された ReplayKit は、画面収録をサポートしています。iOS 10 では、ReplayKit を使用して、サードパーティの App 拡張機能を通じて画面コンテンツをライブブロードキャストできるようになりました。iOS 10 以降では、Push SDK と App 拡張機能を使用して、ライブ画面ブロードキャストを実装できます。

1. App Group の作成

   Apple Developer にログインし、次の手順を実行します。

   1. [Certificates, IDs & Profiles] ページで、App Group を登録します。詳細については、「Register an App Group」をご参照ください。

   2. [Identifier] ページに戻り、[App IDs] を選択し、App ID をクリックして App Group 機能を有効にします。ホストアプリと拡張アプリの両方の App ID に対して同じ設定を実行する必要があります。詳細については、「Enable App Group」をご参照ください。

   3. 設定が完了したら、更新されたプロビジョニングプロファイルをダウンロードし、Xcode にインストールします。

   これらの手順が正しく実行されると、拡張アプリとホストアプリは相互に通信できるようになります。

   説明

   App Group を作成した後、App Group 識別子を控えておいてください。後の手順で必要になります。

2. 画面収録機能拡張の作成

   iOS 向け Push SDK デモには、画面共有用の AlivcLiveBroadcast および AlivcLiveBroadcastSetupUI 拡張機能が含まれています。アプリで画面収録機能拡張を作成するには、次の手順に従います。

   1. 既存のプロジェクトで、[New] > [Target…] を選択し、[Broadcast Upload Extension] を選択します。

   2. [Product Name] を変更し、[Include UI Extension] チェックボックスにチェックを入れ、[Finish] をクリックしてブロードキャストおよび UI 拡張機能を作成します。たとえば、[Product Name] を AlivcLiveBroadcast に設定します。

   3. ブロードキャスト拡張機能の Info.plist ファイルを設定します。新しいターゲットでは、Xcode は SampleHandler という名前のヘッダーファイルとソースファイルを自動的に作成します。このターゲットディレクトリの名前は AlivcLiveBroadcast です。

      AlivcLibReplayKitExt.framework をプロジェクトにドラッグし、拡張機能ターゲットの依存関係としてリンクします。 SampleHandler.m 内のコードを次のコードに置き換えます。コード内の kAPPGROUP を、ステップ 1 で作成した App Group 識別子に置き換える必要があります。サンプルコード：

      
      #import "SampleHandler.h"
      #import <AlivcLibReplayKitExt/AlivcLibReplayKitExt.h>
      
      @implementation SampleHandler
      
      - (void)broadcastStartedWithSetupInfo:(NSDictionary<NSString *,NSObject *>
      *)setupInfo {
      
       // ユーザーがブロードキャストの開始をリクエストしました。UI拡張機能からのセットアップ情報は任意で提供可能です。
       [[AlivcReplayKitExt sharedInstance] setAppGroup:kAPPGROUP];
      }
      
      - (void)processSampleBuffer:(CMSampleBufferRef)sampleBuffer withType:(RPSampleBufferType)sampleBufferType {
       if (sampleBufferType != RPSampleBufferTypeAudioMic) {
       // オーディオはホストアプリによってキャプチャおよび送信されます。
       [[AlivcReplayKitExt sharedInstance] sendSampleBuffer:sampleBuffer withType:sampleBufferType];
       }
      }
      
      - (void)broadcastFinished {
      
       [[AlivcReplayKitExt sharedInstance] finishBroadcast];
      }
      @end
      
      

   プロジェクトでブロードキャストアップロード機能拡張のターゲットを作成し、そのターゲットに、画面収録機能拡張モジュール用にカスタマイズされた AlivcLibReplayKitExt.framework を統合します。

3. ライブ SDK のホストアプリへの統合

   ホストアプリで、AlivcLivePushConfig オブジェクトと AlivcLivePusher オブジェクトを作成します。ExternMainStream を true に、AudioFromExternal を false に設定します。この設定では、オーディオは引き続き SDK によってキャプチャされます。startScreenCapture を呼び出して拡張アプリから画面データの受信を開始し、その後ストリームインジェストを開始および停止します。次の具体的な手順に従います。

   1. ホストアプリプロセスに、AlivcLivePusher.framework、AlivcLibRtmp.framework、RtsSDK.framework、および AlivcLibReplayKitExt.framework に依存関係を追加します。

   2. Push SDK を初期化し、外部ビデオソースを使用するように設定します。

      ExternMainStream を true に、ExternVideoFormat を AlivcLivePushVideoFormatYUV420P に設定します。オーディオキャプチャに内部 SDK を使用するには、AudioFromExternal を false に設定します。次のサンプルコードに示すように、他のストリームインジェストパラメーターを設定します。

       self.pushConfig.externMainStream = true;
       self.pushConfig.externVideoFormat = AlivcLivePushVideoFormatYUV420P;
       self.pushConfig.audioSampleRate = 44100;
       self.pushConfig.audioChannel = 2;
       self.pushConfig.audioFromExternal = false;
       self.pushConfig.videoEncoderMode = AlivcLivePushVideoEncoderModeSoft;
       self.pushConfig.qualityMode = AlivcLivePushQualityModeCustom;
       self.pushConfig.targetVideoBitrate = 2500;
       self.pushConfig.minVideoBitrate = 2000;
       self.pushConfig.initialVideoBitrate = 2000;
       self.livePusher = [[AlivcLivePusher alloc] initWithConfig:self.pushConfig];
      
                                      

   3. AlivcLivePusher の次のメソッドを呼び出して、ライブストリーミング機能を管理します。

      • 画面収録データの受信開始

        コード内の kAPPGROUP を、ステップ 1 で作成した App Group 識別子 に置き換える必要があります。サンプルコード：

        [self.livePusher startScreenCapture:kAPPGROUP];

      • ストリームインジェストの開始

        サンプルコード：

        [self.livePusher startPushWithURL:self.pushUrl]

      • ストリームインジェストの停止

        サンプルコード：

        [self.livePusher stopPush];
        [self.livePusher destroy];
        self.livePusher = nil;

プレビュー表示モード

プッシュ SDK は 3 つのプレビューモードをサポートしています。プレビュー表示モードは、インジェストストリームには影響しません。

• ALIVC_LIVE_PUSHER_PREVIEW_SCALE_FILL: プレビューがウィンドウを埋めます。ビデオとウィンドウのアスペクト比が異なる場合、プレビューが歪みます。

• ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FIT: (デフォルト) プレビューがビデオのアスペクト比を維持します。ビデオとウィンドウのアスペクト比が異なる場合、プレビューに黒帯が表示されます。

• ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FILL: プレビューがウィンドウのアスペクト比に合わせてビデオをクロップします。ビデオとウィンドウのアスペクト比が異なる場合、ビデオがクロップされます。

  サンプルコード：

mAlivcLivePushConfig.setPreviewDisplayMode(AlivcPreviewDisplayMode.ALIVC_LIVE_PUSHER_PREVIEW_ASPECT_FIT);

画像インジェスト

SDK は、アプリがバックグラウンドにある場合やビットレートが低すぎる場合に、静的画像をインジェストできます。アプリがバックグラウンドにある場合、ビデオインジェストはデフォルトで一時停止され、オーディオのみがインジェストされます。このとき、インジェストする画像を設定できます。たとえば、ホストはまもなく戻ります のようなメッセージを含む画像を表示できます。サンプルコード：

config.pauseImg = [UIImage imageNamed:@"image.png"];// バックグラウンドでのインジェスト用画像を設定します。

さらに、ネットワーク状態が悪い場合にインジェストする静的画像を設定できます。画像を設定すると、SDK は現在のビットレートが低いことを検出し、ビデオのスタッターを回避するためにこの画像をインジェストします。サンプルコード：

config.networkPoorImg = [UIImage imageNamed:@"image.png"];// ネットワーク状態が悪い場合にインジェストする画像を設定します。

外部音声・映像のインジェスト

Push SDK は、音声ファイルや映像ファイルなどの外部ソースからの音声・映像のインジェストをサポートしています。

1. アップストリーミング設定で、外部の音声・映像入力を設定します。

サンプルコード：

config.externMainStream = true;// 外部ストリーム入力を有効にします。
config.externVideoFormat = AlivcLivePushVideoFormatYUVNV21;// 映像データのカラーフォーマットを設定します。この例では YUVNV21 に設定していますが、必要に応じて他のフォーマットにも設定できます。
config.externAudioFormat = AlivcLivePushAudioFormatS16;// 音声データのビット深度フォーマットを設定します。この例では S16 に設定していますが、必要に応じて他のフォーマットにも設定できます。

2. 外部映像データを挿入します。

サンプルコード：

/* sendVideoData インターフェイスは、YUV や RGB などの外部映像フォーマットにおける連続バッファーデータのみをサポートしています。これを使用して、映像データのバッファー、長さ、幅、高さ、タイムスタンプ、および回転角度を送信できます。 */
[self.livePusher sendVideoData:yuvData width:720 height:1280 size:dataSize pts:nowTime rotation:0];
/* 外部映像データが CMSampleBufferRef フォーマットの場合は、sendVideoSampleBuffer インターフェイスを使用できます。 */
[self.livePusher sendVideoSampleBuffer:sampleBuffer]
/* CMSampleBufferRef フォーマットを連続バッファーに変換してから、sendVideoData インターフェイスに渡すこともできます。以下は変換の参考コードです。 */
// サンプルバッファのサイズを取得します。
- (int) getVideoSampleBufferSize:(CMSampleBufferRef)sampleBuffer {
if(!sampleBuffer) {
 return 0;
}
int size = 0;
CVPixelBufferRef pixelBuffer = CMSampleBufferGetImageBuffer(sampleBuffer);
CVPixelBufferLockBaseAddress(pixelBuffer, 0);
if(CVPixelBufferIsPlanar(pixelBuffer)) {
 int count = (int)CVPixelBufferGetPlaneCount(pixelBuffer);
 for(int i=0; i<count; i++) {
 int height = (int)CVPixelBufferGetHeightOfPlane(pixelBuffer,i);
 int stride = (int)CVPixelBufferGetBytesPerRowOfPlane(pixelBuffer,i);
 size += stride*height;
 }
}else {
 int height = (int)CVPixelBufferGetHeight(pixelBuffer);
 int stride = (int)CVPixelBufferGetBytesPerRow(pixelBuffer);
 size += stride*height;
}
CVPixelBufferUnlockBaseAddress(pixelBuffer, 0);
return size;
}
// サンプルバッファを連続バッファーに変換します。
- (int) convertVideoSampleBuffer:(CMSampleBufferRef)sampleBuffer toNativeBuffer:(void*)nativeBuffer
{
if(!sampleBuffer || !nativeBuffer) {
 return -1;
}
CVPixelBufferRef pixelBuffer = CMSampleBufferGetImageBuffer(sampleBuffer);
CVPixelBufferLockBaseAddress(pixelBuffer, 0);
int size = 0;
if(CVPixelBufferIsPlanar(pixelBuffer)) {
 int count = (int)CVPixelBufferGetPlaneCount(pixelBuffer);
 for(int i=0; i<count; i++) {
 int height = (int)CVPixelBufferGetHeightOfPlane(pixelBuffer,i);
 int stride = (int)CVPixelBufferGetBytesPerRowOfPlane(pixelBuffer,i);
 void *buffer = CVPixelBufferGetBaseAddressOfPlane(pixelBuffer, i);
 int8_t *dstPos = (int8_t*)nativeBuffer + size;
 memcpy(dstPos, buffer, stride*height);
 size += stride*height;
 }
}else {
 int height = (int)CVPixelBufferGetHeight(pixelBuffer);
 int stride = (int)CVPixelBufferGetBytesPerRow(pixelBuffer);
 void *buffer = CVPixelBufferGetBaseAddress(pixelBuffer);
 size += stride*height;
 memcpy(nativeBuffer, buffer, size);
}
CVPixelBufferUnlockBaseAddress(pixelBuffer, 0);
return 0;
}

3. 音声データを挿入します。

サンプルコード：

/* PCM フォーマットの連続バッファーデータのみをサポートしています。sendPCMData を使用して、音声データのバッファー、サイズ、タイムスタンプを送信します。 */
[self.livePusher sendPCMData:pcmData size:size pts:nowTime];

ウォーターマークの設定

Push SDK を使用すると、複数のウォーターマークを追加できます。ウォーターマーク画像は PNG フォーマットである必要があります。サンプルコード：

NSString *watermarkBundlePath = [[NSBundle mainBundle] pathForResource:
[NSString stringWithFormat:@"watermark"] ofType:@"png"];// ウォーターマーク画像のパスを設定します。
[config addWatermarkWithPath: watermarkBundlePath
 watermarkCoordX:0.1
 watermarkCoordY:0.1
 watermarkWidth:0.3];// ウォーターマークを追加します。

画質の設定

解像度優先モード、流暢性優先モード、カスタムモードの 3 つの画質モードがサポートされています。

config.qualityMode = AlivcLivePushQualityModeResolutionFirst; // 解像度優先モード

config.qualityMode = AlivcLivePushQualityModeFluencyFirst; // 流暢性優先モード

config.qualityMode = AlivcLivePushQualityModeCustom // カスタムモードに設定
config.targetVideoBitrate = 1400; // 目標ビットレート: 1400 Kbps
config.minVideoBitrate = 600; // 最小ビットレート: 600 Kbps
config.initialVideoBitrate = 1000; // 初期ビットレート: 1000 Kbps

カスタムビットレートを設定する際は、Alibaba Cloud の推奨設定を参照してください。推奨設定は次の各表のとおりです。

アダプティブ解像度

アダプティブ解像度を有効にすると、ネットワーク状態が悪い場合に SDK が解像度を自動的に下げ、動画の滑らかさを向上させます。

config.enableAutoResolution = YES; // アダプティブ解像度を有効にします。デフォルトでは無効 (NO) です。

バックグラウンドミュージック

プッシュ SDK は、バックグラウンドミュージックの再生、オーディオミキシング、ノイズ除去、インイヤーモニタリング、およびミュートをサポートしています。バックグラウンドミュージック関連のインターフェイスは、プレビュー開始後にのみ呼び出すことができます。サンプルコード：

/* バックグラウンドミュージックの再生を開始します。 */
[self.livePusher startBGMWithMusicPathAsync:musicPath];
/* バックグラウンドミュージックの再生を停止します。バックグラウンドミュージックの再生中に曲を切り替える場合は、再生開始インターフェイスを再度呼び出すだけです。現在のバックグラウンドミュージックを事前に停止する必要はありません。 */
[self.livePusher stopBGMAsync];
/* バックグラウンドミュージックを一時停止します。これは、バックグラウンドミュージックの再生開始後にのみ呼び出すことができます。 */
[self.livePusher pauseBGM];
/* バックグラウンドミュージックの再生を再開します。これは、バックグラウンドミュージックが一時停止中の場合にのみ呼び出すことができます。 */
[self.livePusher resumeBGM];
/* 音楽のループを有効にします。 */
[self.livePusher setBGMLoop:true];
/* ノイズ除去スイッチを設定します。有効にすると、キャプチャした音声に含まれる、人の声以外の音がフィルタリングされます。人の声がわずかに抑制される場合があります。ユーザーがこの機能を有効にするかどうかを選択できるようにすることを推奨します。デフォルトでは無効です。 */
[self.livePusher setAudioDenoise:true];
/* インイヤーモニタリングスイッチを設定します。この機能は主にカラオケのシナリオで使用されます。有効にすると、ホストの声がヘッドホンから聞こえます。無効にすると、声は聞こえません。ヘッドホンが接続されていない場合、インイヤーモニタリングは動作しません。 */
[self.livePusher setBGMEarsBack:true];
/* オーディオミキシングのボリュームを設定します。バックグラウンドミュージックとキャプチャした音声のボリュームを調整できます。 */
[self.livePusher setBGMVolume:50];// バックグラウンドミュージックのボリュームを設定します。
[self.livePusher setCaptureVolume:50];// キャプチャした音声のボリュームを設定します。
/* ミュートを設定します。ミュートすると、音楽と音声入力の両方が無音になります。音楽または音声のみをミュートする場合は、オーディオミキシングのボリューム設定を使用します。 */
[self.livePusher setMute:isMute?true:false];

ストリームスナップショット

Push SDK には、ローカルビデオストリームからスナップショットをキャプチャする機能があります。サンプルコード：

/* スナップショットコールバックを設定します。 */
[self.livePusher setSnapshotDelegate:self];
/* スナップショット API を呼び出します。 */
[self.livePusher snapshot:1 interval:1];

ライブクイズの設定

ライブクイズ機能は、プレーヤーが解析できるように、SEI メッセージ を ライブストリーム に挿入することで動作します。Push SDK は SEI を挿入するためのインターフェイスを提供します。このインターフェイスは、ストリームインジェスト 中にのみ呼び出せます。サンプルコード：

/*
msg: ストリームに挿入する SEI メッセージ本文。JSON 形式の使用を推奨します。ApsaraVideo Player SDK はこの SEI メッセージ を受信し、解析して内容を表示できます。
repeatCount: 送信するフレーム数。SEI メッセージ が失われないように、繰り返し回数を設定する必要があります。たとえば、値を 100 に設定すると、この SEI メッセージが次の 100 フレーム に挿入されます。プレーヤーは同一の SEI メッセージ を重複排除します。
delayTime: 送信までの遅延時間 (ミリ秒)。
KeyFrameOnly: キーフレームのみに送信するかどうか。
*/
[self.livePusher sendMessage:@"Question Information" repeatCount:100 delayTime:0 KeyFrameOnly:false];

iPhone X への対応

ほとんどのシナリオでは、プレビュービューのフレームをフルスクリーンに設定すると正しく動作します。ただし、iPhone X では、デバイス固有のアスペクト比により、フルスクリーンプレビューが引き伸ばされて表示される場合があります。iPhone X でのプレビューでは、フルスクリーンビューを避けることを推奨します。

インジェスト中のビューサイズ変更

startPreview または startPreviewAsync インターフェイスを呼び出すときに割り当てた UIView を反復処理し、プレビュービューのすべてのサブビューの frame を変更します。例：

[self.livePusher startPreviewAsync:self.previewView];
for (UIView *subView in [self.previewView subviews]) {
 // ...
}

外部の効果音

ストリーム取り込みページで効果音や音楽を再生する必要がある場合は、AVAudioPlayer の使用を推奨します。現在、SDK が AudioServicesPlaySystemSound と競合するためです。再生後、AVAudioSession の設定を更新する必要があります。以下は、AVAudioPlayer で効果音を再生するためのサンプルコードです。

- (void)setupAudioPlayer {
 NSString *filePath = [[NSBundle
mainBundle] pathForResource:@"sound" ofType:@"wav"];
 NSURL *fileUrl = [NSURL fileURLWithPath:filePath];
 self.player = [[AVAudioPlayer alloc] initWithContentsOfURL:fileUrl error:nil];
 self.player.volume = 1.0;
 [self.player prepareToPlay];
}
 - (void)playAudio {
 self.player.volume = 1.0;
 [self.player play];
 // AVAudioSession を設定します
 AVAudioSession *session = [AVAudioSession sharedInstance];
 [session setMode:AVAudioSessionModeVideoChat error:nil];
 [session overrideOutputAudioPort:AVAudioSessionPortOverrideSpeaker error:nil];
 [session setCategory:AVAudioSessionCategoryPlayAndRecord withOptions:AVAudioSessionCategoryOptionDefaultToSpeaker|AVAudioSessionCategoryOptionAllowBluetooth
|AVAudioSessionCategoryOptionMixWithOthers error:nil];
 [session setActive:YES error:nil];
}

バックグラウンドモードと電話

SDK はバックグラウンドモードを内部的に処理するため、ユーザー側での対応は不要です。デフォルトでは、アプリがバックグラウンドに入ると、SDK は音声インジェストを継続しますが、ビデオストリームは最後のフレームで一時停止します。アプリでバックグラウンドモード機能を有効にし、[オーディオ、AirPlay、ピクチャ・イン・ピクチャ] を選択する必要があります。これにより、アプリがバックグラウンドで音声をキャプチャできるようになります。

アプリがバックグラウンドにある間に音声インジェストを停止するには、アップストリーミングエンジンを破棄し、アプリが再びアクティブになったときに再作成する必要があります。

コールバック

プッシュ SDK には、次の主要なコールバックが含まれています。

共通 API

/* カスタムモードでは、最小ビットレートとターゲットビットレートをリアルタイムで調整できます。 */
[self.livePusher setTargetVideoBitrate:800];
[self.livePusher setMinVideoBitrate:200]
/* 現在のストリームプッシュ状態を取得します。 */
BOOL isPushing = [self.livePusher isPushing]; 
/* プッシュ URL を取得します。 */
NSString *pushURLString = [self.livePusher getPushURL];
/* ストリームプッシュのパフォーマンスデバッグ情報を取得します。具体的なパラメーターと説明については、API ドキュメントまたはインターフェイスコメントを参照してください。 */
AlivcLivePushStatsInfo *info = [self.livePusher getLivePushStatusInfo];
/* SDK バージョン番号を取得します。 */
NSString *sdkVersion = [self.livePusher getSDKVersion];
/* 必要に応じてデバッグ情報をフィルターするため、ログレベルを設定します。 */
[self.livePusher setLogLevel:(AlivcLivePushLogLevelDebug)];

デバッグツール

SDK には、DebugView という UI デバッグツールが用意されています。DebugView は移動可能なグローバルなフローティングウィンドウで、常にビュー階層の最前面に表示されます。ストリームインジェスト ログの表示、パフォーマンスパラメーターのリアルタイムモニタリング、主要なパフォーマンスメトリクスのラインチャートなどのデバッグ機能が含まれています。

[AlivcLivePusher showDebugView];// デバッグツールを開きます。