ApsaraVideo Live:機能の使用

SDK の登録

ライセンスの申請と設定については、「プッシュ SDK ライセンスの統合」をご参照ください。

ライセンス登録インターフェイスは、プッシュ 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：通知とステータス検出に使用されるコールバック。

   • Error：エラー発生時に返されるコールバック。

   • Network：ネットワーク関連のコールバック。

   対応するコールバックを受け取るためにデリゲートを登録します。サンプルコード：

   [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:@"テスト用アップストリーミング 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];
/* ミラーリングを設定します。ミラーリングインターフェイスには、アップストリーミングストリーム用の PushMirror とプレビュー用の PreviewMirror の 2 つがあります。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 destory];
self.livePusher = nil;
/* 現在のアップストリーミングステータスを取得します。*/
AlivcLivePushStatus status = [self.livePusher getLiveStatus];

画面共有インジェスト

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

1. App Group の作成

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

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

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

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

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

   説明

   App Group を作成した後、App Group 識別子を保存してください。後のステップで必要になります。

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

   iOS 向けプッシュ 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
      
      

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

3. ライブ SDK をホストアプリに統合

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

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

   2. プッシュ 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 を、以前に作成した App Group 識別子 に置き換える必要があります。サンプルコード：

        [self.livePusher startScreenCapture:kAPPGROUP];

      • アップストリーミングを開始します。

        サンプルコード：

        [self.livePusher startPushWithURL:self.pushUrl]

      • アップストリーミングを停止します。

        サンプルコード：

        [self.livePusher stopPush];
        [self.livePusher destory];
        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"];// ネットワーク状態が悪いときにアップストリーミングする画像を設定します。

外部オーディオとビデオのインジェスト

プッシュ 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];

ウォーターマークの設定

プッシュ 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) です。

BGM

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

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

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

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

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

ライブクイズの設定

ライブクイズ機能は、SEI メッセージをライブストリームに挿入し、プレーヤーがそれを解析することで機能します。プッシュ SDK は SEI を挿入するインターフェイスを提供します。このインターフェイスは、アップストリーミングがアクティブな場合にのみ呼び出すことができます。サンプルコード：

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

iPhone X 対応

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

取り込み中のビューのサイズ変更

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

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

外部効果音

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

- (void)setupAudioPlayer {
 NSString *filePath = [[NSBundle
mainBundle] pathForResource:@"sound" ofType:@"wav"];
 NSURL *fileUrl = [NSURL URLWithString: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 は音声のアップストリーミングを継続し、ビデオストリームは最後のフレームで一時停止します。アプリでバックグラウンドモード機能を有効にし、Audio, AirPlay and Picture in Picture を選択する必要があります。これにより、アプリがバックグラウンドで音声をキャプチャできるようになります。

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

コールバック

プッシュ 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]; // デバッグツールを開きます。