リアルタイム音声・映像 (RTC) を使用するには、まず RTC アプリケーションを作成する必要があります。これにより、通話、チャット、会議などの機能を構築できます。このトピックでは、RTC アプリケーションの作成方法について説明します。
RTC アプリケーションの作成
ApsaraVideo Live コンソールにログインします。
左側のナビゲーションウィンドウで、 をクリックします。
アプリケーションの作成 をクリックします。

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

チャネルとユーザーのコールバック ページに移動し、更新または削除するタスクを見つけます。
[操作] 列で、編集 または 削除 をクリックしてタスクを修正または削除します。
バイパスおよび混合ストリームコールバック
バイパスおよび混合ストリームコールバックを設定した後、設定を修正または削除できます。
コールバックレコードの表示
コールバックタスクを作成して有効になった後、コールバックレコードでコールバックイベントの詳細をクエリできます。

