ApsaraVideo Real-time Communication を使用するには、通話、雑談、会議などの機能をサポートするアプリケーションを作成する必要があります。
ApsaraVideo Real-time Communication アプリケーションの作成
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。
-
アプリケーションの作成 をクリックします。

-
カスタムの インスタンス名 を入力し、[利用規約] に同意してから、[購入] をクリックします。
-
成功メッセージが表示されたら、リアルタイムオーディオビデオ > アプリケーション ページを更新して、作成したコラボ配信アプリケーションを表示します。
説明アプリケーションの作成は無料です。 実際のクラウド使用量に対して、従量課金で請求されます。 詳細については、「ApsaraVideo Real-time Communication の価格」をご参照ください。
ストリームリレーの設定
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。 設定するアプリケーションを選択し、管理 をクリックします。
-
バイパス・プッシュ転送 をクリックします。 [バイパス・プッシュ転送] は、次のいずれかの方法で設定できます。
-
[方法1:バイパス・プッシュ転送を指定する]
CreateLiveMixJob (New) API を呼び出して、特定のチャネルのリアルタイム [バイパス・プッシュ転送] (ストリームミキシングあり) を ApsaraVideo Live またはサードパーティのプラットフォームに設定します。 これには、軽微なサーバーサイド開発が必要です。
-
[方法2:Alibaba Cloud ライブへのグローバルバイパス・プッシュ転送を行う]
ストリームリレーを有効にすると、音声ストリームと映像ストリームが Alibaba Cloud ライブセンターのオリジンサーバーにインジェストされます。 その後、再生ドメイン名を使用して、トランスコーディング、録画、スナップショットなどの機能を設定したり、ライブストリームをプルして表示したりできます。
-
バイパス・プッシュ転送 スイッチをオンにします。
-
インジェストパラメーターを設定します。
パラメーター
設定オプション
説明
[バイパス・プッシュ転送]
オンまたはオフ
シングルストリームインジェストを有効にすると、すべての音声ストリームと映像ストリームがデフォルトで ApsaraVideo Live にインジェストされます。 ソフトウェア開発キット (SDK) またはサーバーサイド API を使用して、ストリームミキシングのレイアウトを更新することもできます。
再生ドメイン名
例: play.example.com
ApsaraVideo Live にインジェストされたストリームの再生ドメイン名です。 このドメイン名を使用して、ライブストリームの再生や、トランスコーディング、録画などの機能も設定できます。
説明-
再生ドメイン名がない場合は、ドメイン名コンソールに移動して追加します。
-
再生ドメイン名は、遅延が 400 ms ~ 600 ms のリアルタイムストリーミング (RTS) をサポートしていません。 RTS を使用すると、インジェストが失敗します。
AppName
最大 255 文字。 数字、大文字と小文字、ハイフン (-)、アンダースコア (_)、等号 (=) をサポートします。
デフォルト値は "live" です。 この値はカスタマイズできます。
インジェスト後のストリーミング URL 内の AppName です。 詳細については、「ストリーミング URL の生成」をご参照ください。
説明トランスコーディング、録画、またはスナップショットのテンプレートをインジェストされたストリームにアタッチするには、テンプレートが有効になるように、この AppName をテンプレートの AppName と同じに設定する必要があります。
[グローバル自動 SEI 設定]
-
一定間隔で SEI を挿入:指定された間隔で Supplemental Enhancement Information (SEI) フレームを挿入します。 間隔は 1000 ms から 5000 ms の範囲で設定できます。
-
I フレームに SEI を挿入:映像ストリームの I フレームに SEI を挿入します。
Supplemental Enhancement Information (SEI) は、ユーザー ID (UID) やストリームミキシングのレイアウトパラメーターなどの基本的なユーザー情報を、システム SEI を介してストリームに挿入します。 たとえば、コラボ配信のシナリオでは、ストリームミキシングのレイアウトが変更されると、視聴者のアプリケーションは SEI からレイアウト情報をリアルタイムで解析して、インタラクティブ UI を調整できます。 詳細については、「Supplemental Enhancement Information (SEI) のフォーマット」をご参照ください。
説明ドメイン名コンソールに再生ドメイン名がない場合は、まずドメイン名を追加する必要があります。 詳細については、「ドメイン名の追加」をご参照ください。
-
-
-
Supplemental Enhancement Information (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 は、チャネル、ユーザー、ストリームリレー、およびストリームミキシングのコールバックイベントを提供します。 これらのコールバックイベントはコンソールで設定できます。
コールバックの概要
コールバックイベントを使用すると、ビジネスサーバーは、チャネル、ユーザー、ストリームリレー、およびストリームミキシングのリアルタイムのステータス変更を受信できます。
-
チャネルコールバック:チャネルの作成や解散などのイベント。
-
ユーザーコールバック:ユーザーのチャネルへの参加または退出、ロールの切り替え、ストリームのインジェストまたはプルの開始または停止などのイベント。
-
ストリームリレーとストリームミキシングのコールバック:[バイパス・プッシュ転送] イベント。
チャネルとユーザーのコールバックの詳細については、「チャネルメッセージコールバックの購読」をご参照ください。 ストリームリレーとストリームミキシングのコールバックの詳細については、「ストリームミキシングとインジェストイベントの購読」をご参照ください。
コールバックタスクの作成
チャネルとユーザーのコールバック
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。
-
コールバックタスクを作成するアプリケーションを見つけ、管理 をクリックしてアプリケーション管理ページに移動します。
-
左側のナビゲーションペインで、イベントコールバック > チャネルとユーザーのコールバック を選択し、タスクの作成 をクリックします。
-
コールバックパラメーターを設定します。 パラメーターについては、次の表で説明します。
パラメーター
説明
[コールバック URL]
コールバックメッセージを受信するビジネスサーバーのアドレスです。 HTTP と HTTPS がサポートされています。 HTTPS の使用を推奨します。
[コールバックイベント範囲]
コールバックイベントには、ユーザーイベント と チャネルイベント が含まれます。
-
ユーザーイベントには次のものが含まれます。
-
チャネルへの参加
-
画面共有の開始
-
退出
-
映像インジェストの停止
-
ロールの切り替え
-
音声インジェストの停止
-
映像インジェストの開始
-
画面共有の停止
-
音声インジェストの開始
-
-
チャネルイベントには次のものが含まれます。
-
チャネルの開始
-
チャネルの終了
-
[指定チャネル]
オプション。 チャネルを指定しない場合、コールバックはデフォルトですべてのチャネルのイベントに対して生成されます。 チャネルを指定した場合、コールバックはそのチャネルのイベントに対してのみ生成されます。
[指定ユーザー]
オプション。 このパラメーターはユーザーイベントにのみ適用されます。 ユーザー ID を指定する場合は、チャネル ID も指定する必要があります。 最大 20 個のユーザー ID を入力でき、コンマ (,) で区切ります。
-
-
[OK] をクリックしてタスクを作成します。
ストリームリレーとストリームミキシングのコールバック
-
ApsaraVideo Live コンソールにログインします。
-
左側のナビゲーションペインで、 をクリックします。
-
コールバックタスクを作成するアプリケーションを見つけ、管理 をクリックします。
-
左側のナビゲーションペインで、イベントコールバック > バイパスとミックスストリームのコールバック を選択し、設定 をクリックします。
-
コールバックパラメーターを設定します。 パラメーターについては、次の表で説明します。
パラメーター
説明
Webhook URL
コールバックメッセージを受信するビジネスサーバーのアドレスです。 HTTP と HTTPS がサポートされています。 HTTPS の使用を推奨します。
チャネルスコープ
オプション。 コールバックを受信するチャネル (ChannelID) を指定します。 最大 20 個のチャネルを指定できます。 複数の ID はコンマ (,) で区切ります。 各チャネル ID には、大文字、小文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。 最大長は 64 文字です。 このパラメーターを空欄にした場合、デフォルトですべてのチャネルからコールバックを受信します。
コールバックレコードの編集と削除
チャネルとユーザーのコールバック
チャネルとユーザーのコールバックタスクを作成した後、タスクを更新または削除できます。

-
左側のナビゲーションペインで チャネルとユーザーのコールバック ページに移動し、更新または削除するタスクを見つけます。
-
「操作」列で、タスクを編集するには編集を、タスクを削除するには削除をクリックします。
ストリームリレーとストリームミキシングのコールバック
ストリームリレーとストリームミキシングのコールバックを設定した後、設定を変更または削除できます。
コールバックレコードの表示
コールバックタスクが有効になると、コールバックレコードでコールバックイベントの詳細を表示できます。

