すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo Live:リアルタイム音声・映像アプリケーションの管理

最終更新日:Nov 23, 2025

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

RTC アプリケーションの作成

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。

  3. アプリケーションの作成 をクリックします。ed34559efbe60c8073c93d6038eaaeaa

  4. カスタムの インスタンス名 を入力し、[利用規約] を選択してから、[今すぐ購入] をクリックします。

  5. アプリケーションが作成されたら、リアルタイムオーディオビデオ アプリケーション ページを更新してアプリケーションを表示します。

    説明

    アプリケーションの作成は無料です。実際の使用量に基づいて従量課金で課金されます。詳細については、「RTC の課金」をご参照ください。

ストリームリレーの設定

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。設定するアプリケーションを見つけて、管理 をクリックします。

  3. バイパス・プッシュ転送 をクリックします。次のいずれかの方法で バイパス・プッシュ転送 を設定できます:

    1. 方法1:バイパス・プッシュ転送を指定する

      StartLiveMPUTask - 混合ストリームおよびリレータスクの作成 (新規) 操作を呼び出して、特定のチャンネルのリアルタイム バイパス・プッシュ転送 (混合ストリームあり) を ApsaraVideo Live またはサードパーティプラットフォームに設定します。これには、少量のサーバーサイド開発が必要です。

    2. 方法2:Alibaba Cloud ライブへのグローバルバイパス・プッシュ転送を行う

      ストリームリレーを有効にすると、音声ストリームと映像ストリームが ApsaraVideo Live のオリジンサーバーにリレーされます。その後、再生ドメイン名を使用して、トランスコード、録画、スナップショットキャプチャなどの機能を設定したり、ライブストリームをプルして視聴したりできます。

      1. バイパス・プッシュ転送 スイッチをオンにします

      2. リレーパラメーターを設定します。

        パラメーター

        設定オプション

        説明

        バイパス・プッシュ転送

        オンまたはオフ

        シングルストリームリレーを有効にすると、すべての音声ストリームと映像ストリームがデフォルトで標準のライブストリーミングにリレーされます。リレー後も、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。

ストリーマーが配置されているペインのレイアウト情報。次のパラメーターに注意してください:

  • paneid: ペインの ID。有効な値: [0,8]。

  • zorder: エリアのスタックレベル。有効な値: [0,99]。

  • x: キャンバス内のエリアの x 座標。値は正規化されたパーセンテージです。

  • y: キャンバス内のエリアの y 座標。値は正規化されたパーセンテージです。

  • w: エリアの幅。値は正規化されたパーセンテージです。

  • h: エリアの高さ。値は正規化されたパーセンテージです。

  • vol: ストリーマーの音量 (デシベル (dB))。有効な値: [0,255]。

  • vad: 音声アクティビティ検出。有効な値: [0,150]。値 150 は、人間の音声が検出されたことを示します。150 以外の値は、音声が存在してからなくなるまでのテールオフ時間を示します。

説明

ユーザー 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 のチャンネル、ユーザー、バイパス、混合ストリームに関連するリアルタイムのステータス変更を受信できます:

  • チャンネルコールバック: チャンネルの作成やチャンネルの解散などのイベント。

  • ユーザーコールバック: ユーザーのチャンネルへの参加または退出、ロールの切り替え、ストリームのアップストリーミングとプルの開始または停止などのイベント。

  • バイパスおよび混合ストリームコールバック: バイパス・プッシュ転送 イベント。

チャンネルおよびユーザーコールバックの詳細については、「チャンネルイベントコールバックのサブスクライブ」をご参照ください。バイパスおよび混合ストリームコールバックの詳細については、「混合ストリームおよびリレーイベントコールバックのサブスクライブ」をご参照ください。

コールバックタスクの作成

チャンネルおよびユーザーコールバック

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。

  3. コールバックタスクを作成するアプリケーションを見つけ、管理 をクリックして、アプリケーション管理ページに移動します。

  4. 左側のナビゲーションウィンドウで、イベントコールバック > チャネルとユーザーのコールバック を選択し、タスクの作成 をクリックします。

  5. コールバックパラメーターを設定します。次の表にパラメーターを示します。

    パラメーター

    説明

    コールバック URL

    コールバック情報を受信するビジネスサーバーの URL。HTTP および HTTPS プロトコルがサポートされています。HTTPS の使用を推奨します。

    コールバックイベント範囲

    コールバックイベントには、ユーザーイベントチャンネルイベントが含まれます。

    • ユーザーイベントには以下が含まれます:

      • チャンネルに参加

      • 画面共有のアップストリーミングを開始

      • チャンネルから退出

      • 映像ストリームのアップストリーミングを停止

      • ロールを切り替え

      • 音声ストリームのアップストリーミングを停止

      • 映像ストリームのアップストリーミングを開始

      • 画面共有のアップストリーミングを停止

      • 音声ストリームのアップストリーミングを開始

    • チャンネルイベントには以下が含まれます:

      • チャンネル開始

      • チャンネル終了

    指定チャネル

    オプション。チャンネルを指定しない場合、デフォルトですべてのチャンネルのイベントに対してコールバックが生成されます。チャンネルを指定した場合、そのチャンネルのイベントに対してのみコールバックが生成されます。

    指定ユーザー

    オプション。このパラメーターはユーザーイベントに対してのみ有効です。ユーザー ID を指定する場合は、チャンネル ID も指定する必要があります。最大 20 個のユーザー ID をカンマ (,) で区切って入力できます。

  6. [OK] をクリックしてタスクを作成します。

バイパスおよび混合ストリームコールバック

  1. ApsaraVideo Live コンソールにログインします。

  2. 左側のナビゲーションウィンドウで、ライブストリーム + > リアルタイムオーディオビデオ > アプリケーション をクリックします。

  3. コールバックタスクを作成するアプリケーションを見つけ、管理 をクリックして、アプリケーション管理ページに移動します。

  4. 左側のナビゲーションウィンドウで、イベントコールバック > バイパスとミックスストリームのコールバック を選択し、設定 をクリックします。

  5. コールバックパラメーターを設定します。次の表にパラメーターを示します。

    パラメーター

    説明

    コールバック URL

    コールバック情報を受信するビジネスサーバーの URL。HTTP および HTTPS プロトコルがサポートされています。HTTPS の使用を推奨します。

    チャンネルスコープ

    オプション。コールバックを受信するチャンネル (ChannelID) を指定します。最大 20 個のチャンネル ID を指定できます。複数の ID はカンマ (,) で区切ります。各チャンネル ID は最大 64 文字で、大文字、小文字、数字、アンダースコア (_)、ハイフン (-) を含めることができます。このパラメーターを空のままにすると、すべてのチャンネルのコールバックが受信されます。

コールバックタスクの編集と削除

チャンネルおよびユーザーコールバック

チャンネルとユーザーのコールバックタスクを作成した後、タスクを更新または削除できます。

image

  1. チャネルとユーザーのコールバック ページに移動し、更新または削除するタスクを見つけます。

  2. [操作] 列で、編集 または 削除 をクリックしてタスクを修正または削除します。

バイパスおよび混合ストリームコールバック

バイパスおよび混合ストリームコールバックを設定した後、設定を修正または削除できます。image

コールバックレコードの表示

コールバックタスクを作成して有効になった後、コールバックレコードでコールバックイベントの詳細をクエリできます。

image

image