ApsaraVideo Real-time Communication を使用するには、通話、チャット、会議などの機能をサポートするアプリケーションを作成する必要があります。
ApsaraVideo Real-time Communication アプリケーションの作成
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。
-
アプリケーションの作成 をクリックします。
-
[Billing Method] で [利用時間課金] または [月次 95 パーセンタイル] を選択します。
-
任意の インスタンス名 を入力し、[Terms of Service] に同意してから、[Purchase] をクリックします。
-
成功メッセージが表示されたら、リアルタイムオーディオビデオ > アプリケーション ページを更新し、作成したアプリケーションを確認します。
説明アプリケーションの作成は無料です。実際のクラウド利用量に基づき、従量課金で課金されます。詳細については、「ApsaraVideo Real-time Communication pricing」をご参照ください。
バイパスインジェストの設定
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。設定するアプリケーションを選択し、管理 をクリックします。
-
バイパス・プッシュ転送 をクリックします。バイパス・プッシュ転送 は、次のいずれかの方法で設定できます。
-
[方法1:バイパス・プッシュ転送を指定する]
CreateLiveMixJob (New) 操作を呼び出して、特定のチャネルから ApsaraVideo Live またはサードパーティプラットフォームへのリアルタイム バイパス・プッシュ転送 (ストリームミキシングあり) を設定します。 これには、軽微なサーバー側の開発が必要です。
-
[方法2:Alibaba Cloud ライブへのグローバルバイパス・プッシュ転送を行う]
バイパスインジェストを有効にすると、音声・映像ストリームが Alibaba Cloud ライブセンターのオリジンサーバーにインジェストされます。その後、再生ドメイン名を使用して、トランスコード、録画、スナップショットなどの機能を設定したり、ライブストリームをプルして視聴したりできます。
-
バイパス・プッシュ転送 スイッチをオンにします。
-
インジェストパラメータを設定します。
パラメータ
設定オプション
説明
バイパス・プッシュ転送
[On] または [Off]
単一ストリームインジェストを有効にすると、デフォルトで全ての音声・映像ストリームが ApsaraVideo Live にインジェストされます。SDK またはサーバー側 API を使用して、ストリームミキシングのレイアウトを引き続き更新できます。
再生ドメイン名
例:play.example.com
ApsaraVideo Live にインジェストするストリームのストリーミングドメインです。このドメイン名を使用して、ライブストリームを再生したり、トランスコードや録画などの機能を設定したりできます。
説明-
ストリーミングドメインがない場合は、[Domain Names] コンソールで追加してください。
-
ストリーミングドメインは、遅延が 400 ms ~ 600 ms のリアルタイムストリーミング (RTS) をサポートしていません。RTS を使用すると、インジェストに失敗します。
[AppName]
最大 255 文字。数字、英大文字、英小文字、ハイフン (-)、アンダースコア (_)、イコール (=) を使用できます。
デフォルト値は「live」です。この値はカスタマイズできます。
インジェスト後のストリーミング URL に含まれる AppName です。詳細については、「Generate streaming URLs」をご参照ください。
説明インジェスト済みストリームにトランスコード、録画、またはスナップショットのテンプレートを関連付けるには、この AppName をテンプレート内の AppName と同じに設定し、テンプレートを有効にする必要があります。
グローバル自動 SEI 設定
-
一定間隔で SEI を挿入:指定した間隔で補助拡張情報 (SEI) フレームを挿入します。間隔は 1000 ms ~ 5000 ms で設定できます。
-
I フレームに SEI を挿入:映像ストリームの I フレームに SEI を挿入します。
補助拡張情報 (SEI) は、UID などの基本的なユーザー情報や、ストリームミキシングのレイアウトパラメータを、システム SEI を使用してストリームに挿入します。例えば、共同ストリーミングのシナリオでストリームミキシングのレイアウトが変更された場合、視聴者側のアプリケーションは SEI からレイアウト情報をリアルタイムに解析し、インタラクティブ UI を調整できます。詳細については、「Supplemental Enhancement Information (SEI) format」をご参照ください。
説明Domain Names コンソールにストリーミングドメインがない場合は、先に追加する必要があります。詳細については、「Add a domain name」をご参照ください。
-
-
-
補助拡張情報 (SEI) の形式
|
データ型 |
パラメータ名 |
値 |
|
映像ストリーム情報 |
stream |
配信者情報: uid:配信者のユーザー ID。 |
|
配信者のウィンドウ領域のレイアウト情報。次のパラメータに注意してください。
|
例えば、UID が 111 と 222 の 2 人のユーザーにストリームミキシングのレイアウトを適用する場合、SEI メッセージは次のとおりです。
{"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"ms":0,"vol":60,"vad":123}]}
コールバックイベント
ApsaraVideo Real-time Communication は、チャンネル、ユーザー、バイパスインジェスト、ストリームミキシング用のコールバックイベントを提供します。これらのコールバックイベントはコンソールで設定できます。
コールバックの概要
コールバックイベントを使用すると、ビジネスサーバーで、チャンネル、ユーザー、バイパスインジェスト、ストリームミキシングのリアルタイムなステータス変更を受信できます。
-
チャンネルコールバック:チャンネルの作成や解散などのイベント。
-
ユーザーコールバック:ユーザーのチャンネル参加/退出、ロール切り替え、ストリームインジェストまたはプルの開始/停止などのイベント。
-
バイパスおよびストリームミキシングコールバック:[バイパス・プッシュ転送] イベント。
チャンネルおよびユーザーコールバックの詳細については、「Subscribe to channel message callbacks」をご参照ください。バイパスおよびストリームミキシングコールバックの詳細については、「Subscribe to stream mixing and ingest events」をご参照ください。
コールバックタスクの作成
チャンネルおよびユーザーコールバック
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。
-
コールバックタスクを作成するアプリケーションを選択し、管理 をクリックして、アプリケーション管理ページに移動します。
-
左側のナビゲーションペインで、イベントコールバック > チャネルとユーザーのコールバック を選択し、タスクの作成 をクリックします。
-
コールバックパラメータを設定します。パラメータは次の表のとおりです。
パラメータ
説明
コールバック URL
コールバックメッセージを受信するビジネスサーバーのアドレスです。HTTP と HTTPS をサポートしています。HTTPS の使用を推奨します。
コールバックイベント範囲
コールバックイベントには、[User events] と [Channel events] が含まれます。
-
[User events] には次のイベントが含まれます。
-
チャンネル参加
-
画面共有の開始
-
退出
-
映像インジェストの停止
-
ロールの切り替え
-
音声インジェストの停止
-
映像インジェストの開始
-
画面共有の停止
-
音声インジェストの開始
-
-
[Channel events] には次のイベントが含まれます。
-
チャンネル開始
-
チャンネル終了
-
指定チャネル
オプションです。チャンネルを指定しない場合、デフォルトでは全てのチャンネルのイベントについてコールバックが生成されます。チャンネルを指定した場合、そのチャンネルのイベントについてのみコールバックが生成されます。
指定ユーザー
オプションです。このパラメータはユーザーイベントにのみ適用されます。ユーザー ID を指定する場合は、チャンネル ID も指定する必要があります。最大 20 件のユーザー ID を指定できます。複数の ID はカンマ (,) で区切って入力します。
-
-
[OK] をクリックしてタスクを作成します。
バイパスおよびストリームミキシングコールバック
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。
-
コールバックタスクを作成するアプリケーションを選択し、管理 をクリックします。
-
左側のナビゲーションペインで、イベントコールバック > バイパスとミックスストリームのコールバック を選択し、設定 をクリックします。
-
コールバックパラメータを設定します。パラメータは次の表のとおりです。
パラメータ
説明
[Webhook アドレス]
コールバックメッセージを受信するビジネスサーバーのアドレスです。HTTP と HTTPS をサポートしています。HTTPS の使用を推奨します。
[Channel scope]
オプションです。コールバックを受信するチャンネル (ChannelIDs) を指定します。最大 20 件のチャンネルを指定できます。複数の ID はカンマ (,) で区切ります。各チャンネル ID には、英大文字、英小文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。最大長は 64 文字です。空欄の場合は、デフォルトで全てのチャンネルからコールバックを受信します。
コールバックタスクの編集と削除
チャンネルおよびユーザーコールバック
チャンネルおよびユーザーのコールバックタスクを作成した後、タスクを更新または削除できます。
-
チャネルとユーザーのコールバック ページに移動し、更新または削除するタスクを探します。
-
[操作] 列で、編集 をクリックしてタスクを変更するか、削除 をクリックしてタスクを削除します。
バイパスおよびストリームミキシングコールバック
バイパスおよびストリームミキシングコールバックを設定した後、設定を変更または削除できます。
リレーおよびミキシングのコールバックタスクを設定すると、ステータスは [Configured] と表示されます。[Modify Configuration]、削除、[Callback Example] を使用して、コールバックタスクを管理できます。また、このページには設定済みのコールバック URL とチャンネルスコープ (例:[All Channels]) も表示されます。
コールバックレコードの表示
コールバックタスクが有効になると、コールバックレコードでコールバックイベントの詳細を確認できます。
コールバックレコードには、直近 7 日間のコールバック成功/失敗データが保持されます。時間範囲 ([Today]、[Last 3 Days]、[Last 7 Days]、[Custom]) と [Callback ID] でレコードを絞り込めます。レコードには次のフィールドが含まれます。
-
Callback ID
-
Callback Time
-
Callback Content
-
Callback URL
-
Request Result
[Callback Records] タブをクリックして、時間範囲 ([Today]、[Last 3 Days]、[Last 7 Days]、または [Custom]) でレコードを絞り込み、[Callback Time]、[Callback Content]、コールバック URL、[Request Result] を確認します。