:機能の使用方法

アップストリーミング パラメーターの構成

AlivcLivePushConfig クラスを使用して、アップストリーミングパラメーターを構成できます。各パラメーターにはデフォルト値があります。基本的なアップストリーミングでは、デフォルト値を使用することをお勧めします。これにより、構成なしで簡単な初期化を実行できます。

AlivcLivePushConfig config;

ストリームのアップストリーミング（カメラから）

AlivcLivePusher は、Push SDK のアップストリーミング用コアクラスです。初期化、アップストリーミングコールバック、カメラプレビュー、アップストリーミングコントロール、アップストリーミング中のパラメーター調整などの機能を提供します。

1. 初期化。

   アップストリーミングパラメーターを構成した後、Push SDK の init メソッドを呼び出して初期化を実行できます。次のコードに例を示します。

   AlivcLivePushConfig config;
   pusher->init(config);

2. アップストリーミング コールバックを登録します。

   アップストリーミングコールバックは 3 つのタイプに分類されます。

   • Info: 通知とステータス検出に使用されます。

   • Error: エラーが発生したときに返されます。

   • Network: ネットワークイベントに関連します。

   特定のタイプのイベントが発生すると、対応するコールバック関数がトリガーされて通知されます。次のコードに例を示します。

   pusher->setLivePushErrorListener(errorListener);
   pusher->setLivePushInfoListener(errorListener);
   pusher->setLivePushNetworkListener(errorListener);

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

   livePusher オブジェクトが初期化され、コールバックが構成された後、プレビューを開始できます。次のコードに例を示します。

   pusher->startPreview(view, width, height);

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

   pusher->startPush(url);

pusher->stopPush();

画面録画からのストリームのアップストリーミング (画面共有)

画面録画からのストリームのアップストリーミングは、[画面共有アップストリーミング] とも呼ばれます。この機能を使用するには、共有ソースのリストを取得し、アップストリーミング用の共有ソースを指定する必要があります。プロシージャは次のとおりです。

1. 共有ソースのリストを取得します。

   pusher->getScreenShareSourceInfo();

2. 共有ストリームのアップストリーミングを開始します。

   pusher->startScreenShareByDesktopId(desktopId);

   説明

   • desktopId: デスクトップの ID。GetScreenShareSourceInfo インターフェイスを呼び出すことで ID を取得できます。

ビットレートコントロール

ビットレートコントロールは 2 つのモードで構成できます。

1. enableBitrateControl 初期化パラメーターを使用したコントロール。

   config.enableBitrateControl = true;

   説明

   このパラメーターを有効にすると、SDK 内で設定されたターゲットビットレートと最小ビットレートの間でビットレートが自動的に調整されます。このパラメーターを有効にすることをお勧めします。このパラメーターを無効にすると、ビットレートは初期ビットレートに固定されます。これにより、ネットワークが不安定な場合に再生が途切れる可能性があります。このパラメーターは注意して使用してください。

2. カスタムビットレート。

   mInitialVideoBitrate、mMinVideoBitrate、および mTargetVideoBitrate パラメーターを使用して、初期、最小、およびターゲットビットレートを構成できます。

   config.mTargetVideoBitrate = 1400; // ターゲットビットレートは 1,400 kbit/s です。
   config.mMinVideoBitrate = 600; // 最小ビットレートは 600 kbit/s です。
   config.mInitialVideoBitrate = 1000; // 初期ビットレートは 1,000 kbit/s です。

   次の表に、これらのパラメーターの推奨値を示します。

   解決策	初期ビットレート initialVideoBitrate	最小ビットレート minVideoBitrate	ターゲットビットレート targetVideoBitrate
   360P	600	300	1000
   480P	800	300	1200
   540P	1000	600	1400
   720P	1500	600	2000
   1080P	1800	1200	2500

   解決策	初期ビットレート initialVideoBitrate	最小ビットレート minVideoBitrate	ターゲットビットレート targetVideoBitrate
   360P	400	200	600
   480P	600	300	800
   540P	800	300	1000
   720P	1000	300	1200
   1080P	1500	1200	2200

   説明

   ターゲット、最小、または初期ビットレートを構成しない場合、SDK は解像度に基づいて適切な送信ビットレートを自動的に割り当てます。デフォルトの構成はカメラ用です。

イメージストリームのアップストリーミング

ユーザーエクスペリエンスを向上させるために、Push SDK では、アプリケーションがバックグラウンドで実行されているときやビットレートが低すぎるときにイメージをアップストリーミングできます。

SDK がバックグラウンドに切り替わると、デフォルトでビデオストリームのアップストリーミングは一時停止され、音声ストリームのみがアップストリーミングされます。この場合、イメージをアップストリーミングできます。たとえば、[ストリーマーはまもなく戻ります。] などのメッセージを含むイメージを表示してユーザーに通知できます。

config.mPausePushImagePath = "Path of the PNG image for background stream ingest";//アプリケーションがバックグラウンドで実行されているときのアップストリーミング用のイメージを設定します。

コールバックをリッスンする

Push SDK コールバックを介して、アップストリーミングの例外とエラーを受信して処理できます。Push SDK for Windows には、次の主要なコールバックが含まれています。

一般的なクラスのリスト