ApsaraVideo Live:Push SDK for iOS の使用

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 です。GOP 間隔が長いほど、レイテンシーが高くなります。これを 1 または 2 に設定することをお勧めします。
config.connectRetryInterval = 2000; // 単位: ミリ秒。再接続時間は 2 秒です。再接続間隔は少なくとも 1 秒に設定してください。デフォルト値を使用することをお勧めします。
config.previewMirror = false; // デフォルト値は false です。通常は false を選択します。
config.orientation = AlivcLivePushOrientationPortrait; // デフォルトは縦向きモードです。横向きモードでは、ホームボタンを左または右に設定できます。

カメラストリームを取り込む

1. 初期化

   アップストリーミングパラメーターを設定した後、Push SDK の initWithConfig メソッドを使用して初期化できます。以下はサンプルコードです。

   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];
/* ミラー設定。ミラー関連のインターフェイスは 2 つあります: アップストリーミングミラーリング用の PushMirror とプレビューミラーリング用の PreviewMirror です。PushMirror 設定は再生画面にのみ影響します。PreviewMirror 設定はプレビュー画面にのみ影響します。2 つは互いに影響しません。*/
[self.livePusher setPushMirror:false];
[self.livePusher setPreviewMirror:false];

/* ユーザーは pauseImage を設定し、pause インターフェイスを呼び出して、カメラストリームのアップストリーミングから静止画のアップストリーミングに切り替えることができます。音声ストリームのアップストリーミングは継続します。*/
[self.livePusher pause];
/* 静止画のアップストリーミングからカメラストリームのアップストリーミングに切り替えます。音声ストリームのアップストリーミングは継続します。*/
[self.livePusher resume];
/* アップストリーミング中に stopPush を呼び出すことができます。完了後、アップストリーミングは停止します。*/
[self.livePusher stopPush];
/* プレビュー状態でのみ stopPreview を呼び出すことができます。アップストリーミング中に stopPreview を呼び出しても効果はありません。プレビューが停止すると、プレビュー画面は最後のフレームでフリーズします。*/
[self.livePusher stopPreview];
/* アップストリーミング中、または Error 関連のコールバックを受信したときに restartPush を呼び出すことができます。Error 状態では、このインターフェイス (または再接続用の reconnectPushAsync) を呼び出すか、destroy を呼び出してアップストリーミングを破棄することしかできません。完了後、アップストリーミングが再開され、プレビューとアップストリーミングを含む ALivcLivePusher のすべての内部リソースが再起動されます。*/
[self.livePusher restartPush];
/* このインターフェイスは、アップストリーミング中、または AlivcLivePusherNetworkDelegate 関連の Error コールバックを受信したときに呼び出すことができます。Error 状態では、このインターフェイス (またはアップストリーミングを再開するための restartPush) を呼び出すか、destroy を呼び出してアップストリーミングを破棄することしかできません。完了後、アップストリーミングは RTMP サーバーに再接続します。*/
[self.livePusher reconnectPushAsync];
/* アップストリーミングを破棄すると、アップストリーミングとプレビューが停止し、プレビュー画面が削除されます。AlivcLivePusher に関連するすべてのリソースが破棄されます。*/
[self.livePusher destory];
self.livePusher = nil;
/* アップストリーミングのステータスを取得します。*/
AlivcLivePushStatus status = [self.livePusher getLiveStatus];

画面共有ストリームのインジェスト

ReplayKit は iOS 9 で導入された画面録画機能です。iOS 10 では、サードパーティのアプリ拡張機能を呼び出して画面コンテンツをライブストリーミングする機能が追加されました。iOS 10 以降では、Push SDK を機能拡張画面録画プロセスと組み合わせて使用することで、ライブストリーミングのための画面共有を実現できます。

1. App Group の作成

   Apple Developer にログオンし、次の操作を実行します。

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

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

   3. 完了したら、対応するプロビジョニングプロファイルを再ダウンロードし、Xcode で設定します。

   操作を正しく完了すると、Extension App は Host App と通信できるようになります。

   説明

   App Group を作成した後、後続のステップで使用するために App Group Identifier の値を保存します。

2. 機能拡張画面録画プロセスの作成

   Push SDK for iOS デモには、ライブストリーミングのための画面共有をサポートする AlivcLiveBroadcast および AlivcLiveBroadcastSetupUI アプリ拡張機能が含まれています。アプリで機能拡張画面録画プロセスを作成するには、次のステップに従います。

   1. 既存のプロジェクトで、[新規] > [ターゲット...] を選択し、[Broadcast Upload Extension] を選択します。次の図に示します。

   2. [製品名] を変更し、[UI 拡張機能を含める] を選択し、[完了] をクリックしてブロードキャスト拡張機能と UI を作成します。次の図に示します。

   3. ブロードキャスト拡張機能の Info.plist を設定します。新しく作成されたターゲットでは、Xcode はデフォルトで SampleHandler という名前のヘッダーファイルとソースファイルを作成します。次の図に示します。

      AlivcLibReplayKitExt.framework をプロジェクトにドラッグして、Extension Target がそれに依存するようにします。SampleHandler.m のコードを次のコードに置き換えます。コード内の `KAPPGroup` を、最初のステップで作成した App Group Identifier に置き換えます。以下はサンプルコードです。

      
      #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 Target を作成します。この Extension Target で、画面録画拡張モジュール用にカスタマイズされた AlivcLibReplayKitExt.framework を統合します。

3. Live SDK をホストアプリに統合する

   Host App で、AlivcLivePushConfig および AlivcLivePusher オブジェクトを作成します。`ExternMainStream` を `True` に、`AudioFromExternal` を `False` に設定します。この設定は、音声が引き続き SDK によってキャプチャされることを示します。`StartScreenCapture` を呼び出して Extension App からの画面データの受信を開始し、その後アップストリーミングを開始および停止します。詳細については、次のステップに従ってください。

   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 を、以前に作成した App Group Identifier に置き換えます。以下はサンプルコードです。

        [self.livePusher startScreenCapture:kAPPGROUP];

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

        以下はサンプルコードです。

        [self.livePusher startPushWithURL:self.pushUrl]

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

        以下はサンプルコードです。

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

プレビュー表示モードの設定

Push 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 はバックグラウンド画像のアップストリーミングと、ビットレートが低すぎる場合の画像のアップストリーミングの設定を提供します。アプリがバックグラウンドに移動すると、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. 外部ビデオデータを挿入します。

以下はコード例です。

/* YUV または RGB 形式の外部ビデオの連続バッファーデータのみが sendVideoData メソッドを使用して送信できます。このメソッドを使用して、ビデオバッファー、長さ、幅、高さ、タイムスタンプ、および回転角度を送信できます。*/
[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 kbit/s
config.minVideoBitrate = 600; // 最小ビットレート: 600 kbit/s
config.initialVideoBitrate = 1000; // 初期ビットレート: 1000 kbit/s

カスタムビットレートを設定する場合、Alibaba Cloud の推奨設定を参照してビットレートを設定します。推奨設定については、次の表をご参照ください。

適応解像度

アップストリーミング解像度を動的に調整する機能を有効にすると、ネットワークが貧弱な場合に解像度が自動的に低下し、ビデオの流暢さと鮮明さが向上します。以下はサンプルコードです。

config.enableAutoResolution = YES; // 適応解像度を有効にします。デフォルトは NO です。

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

Push SDK は、バックグラウンドミュージックの再生、ミキシング、ノイズリダクション、インイヤーモニタリング、ミュートなどの機能を提供します。バックグラウンドミュージック関連のインターフェイスは、プレビューが開始された後にのみ呼び出すことができます。以下はサンプルコードです。

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

スナップショットのキャプチャ

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

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

ライブクイズ機能の設定

ライブクイズ機能は、ライブストリームに SEI メッセージを挿入し、それをプレーヤーで解析することで実装できます。Push 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 でプレビュービューを全画面サイズに設定すると、画像が引き伸ばされます。iPhone X では、プレビューに全画面ビューを使用しないことをお勧めします。

アップストリーミング中のビューサイズの変更

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

[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 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 はデフォルトで音声のアップストリーミングを継続し、ビデオは最後のフレームのままになります。アプリの機能でバックグラウンドモードオプションを開き、[オーディオ、AirPlay、ピクチャ・イン・ピクチャ] を選択する必要があります。これにより、アプリがバックグラウンドにあるときに正常に音声をキャプチャできるようになります。次の図を参照してください。

アプリがバックグラウンドにあるときに音声ストリームのアップストリーミングを維持する必要がない場合は、アプリがバックグラウンドに入ったときにアップストリーミングを停止し、アプリがフォアグラウンドに戻ったときに再開できます。これを行うには、アプリがバックグラウンドに入ったときにアップストリーミングエンジンを破棄し、アプリがフォアグラウンドに戻ったときに再作成してアップストリーミングを再開します。

コールバックのリスニング

Push SDK には、主に次のコールバックが含まれています。

一般的なメソッドとインターフェイス

/* カスタムモードでは、ユーザーは最小ビットレートとターゲットビットレートをリアルタイムで調整できます。*/
[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];
/* バージョン番号を取得します。*/
NSString *sdkVersion = [self.livePusher getSDKVersion];
/* ログレベルを設定して、必要に応じて目的のデバッグ情報をフィルタリングします。*/
[self.livePusher setLogLevel:(AlivcLivePushLogLevelDebug)];

デバッグツール

SDK は、DebugView という名前の UI デバッグツールを提供します。DebugView は、追加された後、常にビューの最前面に表示される移動可能なグローバルフローティングウィンドウです。これには、アップストリーミングログの表示、アップストリーミングパフォーマンスパラメーターのリアルタイム検出、主要なパフォーマンスメトリックの折れ線グラフなどのデバッグ機能が含まれています。

以下はサンプルコードです。

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