ApsaraVideo Live:機能の使用

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://......)"];

   説明

   • 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：オートフォーカスを有効にするかどうかを指定します。このパラメーターは、この API 呼び出しのフォーカス操作にのみ有効です。後続のオートフォーカス操作では、オートフォーカス API で設定された値が使用されます。*/
[self.livePusher focusCameraAtAdjustedPoint:CGPointMake(50, 50) autoFocus:true];
/* オートフォーカスを有効にするかどうかを設定します。*/
[self.livePusher setAutoFocus:false];
/* ミラーリングを設定します。ミラーリングインターフェイスには、アップストリーミングストリームミラーリング用の PushMirror とプレビューミラーリング用の PreviewMirror の 2 つがあります。PushMirror の設定は再生画面にのみ有効です。PreviewMirror の設定はプレビュー画面にのみ有効です。2 つの設定は互いに影響しません。*/
[self.livePusher setPushMirror:false];
[self.livePusher setPreviewMirror:false];

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

画面録画（画面共有）のアップストリーミング

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

1. App Group の作成

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

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

   2. [Identifier] ページに戻り、[App IDs] を選択し、App ID をクリックして App Group 機能を有効にします。メインアプリプロセスと Extension 画面録画プロセスの App ID は同じように設定する必要があります。詳細については、「 App Group の有効化」をご参照ください。

   3. 操作が完了したら、対応する Provisioning Profile を再度ダウンロードし、Xcode で設定します。

   操作を正しく実行すると、Extension 画面録画プロセスがメインアプリプロセスと通信できるようになります。

   説明

   App Group を作成したら、App Group Identifier の値を保存してください。この値は後続のステップで必要になります。

2. Extension 画面録画プロセスの作成

   iOS Push SDK のデモでは、ライブストリーミングの画面共有をサポートする AlivcLiveBroadcast および AlivcLiveBroadcastSetupUI App Extension を提供しています。アプリで Extension 画面録画プロセスを作成するには、次の手順を実行します。

   1. 既存のプロジェクトで、[New > Target…] を選択し、[Broadcast Upload Extension] を選択します。次の図を参照してください。

   2. [Product Name] を変更し、[Include UI Extension] を選択して、[Finish] をクリックしてライブストリーミング Extension と UI を作成します。次の図を参照してください。

   3. ライブストリーミング Extension の Info.plist ファイルを設定します。新しく作成されたターゲットでは、Xcode はデフォルトで SampleHandler という名前のヘッダーファイルとソースファイルを作成します。次の図を参照してください。

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

      
      #import "SampleHandler.h"
      #import <AlivcLibReplayKitExt/AlivcLibReplayKitExt.h>
      
      @implementation SampleHandler
      
      - (void)broadcastStartedWithSetupInfo:(NSDictionary<NSString *,NSObject *>
      *)setupInfo {
      
       // ユーザーがブロードキャストの開始を要求しました。UI Extension からのセットアップ情報は提供できますが、オプションです。
       [[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 ターゲットを作成します。この Extension Target で、画面録画 Extension モジュール用にカスタマイズされた AlivcLibReplayKitExt.framework を統合します。

3. 画面共有アップストリーミングのために Live SDK をメインアプリプロセスに統合

   画面共有アップストリーミングのメインアプリプロセスで、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; // ターゲットビットレートは 1,400 kbit/s です。
config.minVideoBitrate = 600; // 最小ビットレートは 600 kbit/s です。
config.initialVideoBitrate = 1000; // 初期ビットレートは 1,000 kbit/s です。

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

アダプティプ解像度

動的解像度調整が有効な場合、ネットワーク状態が悪いとアップストリーミング解像度が自動的に低下します。これにより、動画の滑らかさと鮮明さが向上します。サンプルコード：

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

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

Push SDK は、バックグラウンドミュージックの再生、オーディオミキシング、ノイズ除去、インイヤーモニタリング、ミュートをサポートしています。関連する API 操作は、プレビューが開始された後にのみ呼び出してください。次のコードは例です。

/* バックグラウンドミュージックの再生を開始します。*/
[self.livePusher startBGMWithMusicPathAsync:musicPath];
/* バックグラウンドミュージックの再生を停止します。バックグラウンドミュージックの再生中に曲を切り替えたい場合は、startBGMWithMusicPathAsync 操作を呼び出すだけで、現在の再生を停止する必要はありません。*/
[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.livePushersetSnapshotDelegate:self];
/* スナップショット API を呼び出します。*/
[self.livePushersnapshot:1interval:1];

ライブクイズ機能の設定

ライブクイズ機能は、ライブストリームに補足的な拡張情報 (SEI) を挿入することで機能します。プレーヤーはその後 SEI を解析します。Push SDK は SEI メッセージを挿入するメソッドを提供します。このメソッドはアップストリーミング中にのみ呼び出してください。次のコードは例です。

/*
msg: ストリームに挿入する SEI メッセージの本文。JSON 形式を推奨します。ApsaraVideo Player SDK はこのメッセージを受信して解析し、表示できます。
repeatCount: メッセージを送信するフレーム数。SEI メッセージがドロップされるのを防ぐために、繰り返し回数を設定します。たとえば、値 100 はメッセージを次の 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]) {
 // ...
}

外部音声の再生

アップストリーミングページで外部音声を再生するには、AVAudioPlayer を使用してください。なぜなら、SDK は一時的に AudioServicesPlaySystemSound と互換性がないためです。再生後、AVAudioSession の設定を更新してください。以下はサンプルコードです。

- (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 は音声ストリームのアップストリーミングを継続し、ビデオは最後のフレームで一時停止します。アプリがバックグラウンドで音声を収集できるようにするには、アプリの Capabilities に移動し、Background Mode を有効にして、[Audio, AirPlay and Picture in Picture] を選択します。

アプリがバックグラウンドに移動したときに音声のアップストリーミングを停止するには、アップストリーミングエンジンを破棄します。アプリがフォアグラウンドに戻ったときに、エンジンを再作成してストリームを再開します。

コールバック

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];
/* SDK のバージョン番号を取得します。*/
NSString *sdkVersion = [self.livePusher getSDKVersion];
/* 必要に応じてデバッグ情報をフィルタリングするためにログレベルを設定します。*/
[self.livePusher setLogLevel:(AlivcLivePushLogLevelDebug)];

デバッグツール

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

サンプルコード：

[AlivcLivePusher showDebugView];// DebugView を開きます。