概要

本機能は、複数の参加者の音声・映像を SkyWay のサーバー上で合成し、YouTube や Twitch などの映像配信サービスを通じて視聴者に届ける機能です。

オープンベータ版について

配信機能は現在オープンベータ版として提供しています。本機能のご利用をご希望の方は、SkyWayお問い合わせよりご連絡ください。

主な特徴

  • サーバーサイド合成: 参加者から送信された音声・映像データは SkyWay のサーバー上で自動的に合成されます。
  • 複数レイアウト対応: グリッド表示や画面共有のピクチャーインピクチャー表示など、用途に合わせた合成レイアウトが選択可能です。
  • 主要な配信サービスとの連携: YouTube や Twitch といった主要な配信プラットフォームと連携できます。

利用方法

本機能を利用するには、SkyWay LiveStreaming API (REST API) をお客様のサーバーから操作する必要があります。詳細な実装手順は「クイックスタート」セクションで解説しています。

システム構成図

仕様

Base URL

SkyWay LiveStreaming API の Base URL は、オープンベータ版についてお問い合わせ頂ければご案内いたします。

対応プロトコル、対応配信サービス

RTMP による出力に対応しています。以下の配信サービスでの動作確認を行っています。

  • YouTube
  • Twitch

その他のサービスでのサポートが必要な場合はお問い合わせください。

対応通信方式

本機能は SFU を利用している場合のみ利用可能です。

Room ライブラリを用いて P2P ルームを利用している場合と、SFU Bot ライブラリを使わずに Core ライブラリを利用している場合は配信機能は利用できません。

認証

SkyWay LiveStreaming API のリクエストには SkyWay Admin Auth Token による認証が必要です。

SkyWay Admin Auth Token の仕様については次のリンクを参照してください。

SkyWay Admin Auth Token

SkyWay LiveStreaming API の HTTP リクエストのリクエストヘッダーには Authorization: Bearer <token> が含まれている必要があります。

以下に curl コマンドでリクエストヘッダーを指定する例を示します。

curl -X POST ENDPOINT_URL \ -H "Authorization: Bearer YOUR_SKYWAY_ADMIN_AUTH_TOKEN"

ライフサイクル

LiveStreamingSession の状態の遷移と基本的な配信の流れについて説明します。

状態の遷移

LiveStreamingSession は以下の 5 種類の状態を持ちます。

  • Preparing
    • 配信の準備中です。最大で 10 分程度の待ち時間の後、自動的に Available に遷移します。
  • Available
    • 配信の準備が完了した状態です。startSession のリクエストが送られると、Livestreaming に遷移します。
  • Livestreaming
    • 配信中です。deleteSession のリクエストが送られると、Deleting に遷移します。
  • Deleting
    • 配信の削除中です。このプロセスが完了すると、LiveStreamingSession は自動的に削除されます。
  • Unavailable
    • 配信が利用できない状態です。回復不能なエラーが発生した場合に遷移します。getSession のリクエストを送ることでエラーの内容を確認できます。deleteSession のリクエストを送ることで LiveStreamingSession の削除を行います。

状態遷移図

基本的な配信の流れ

配信の開始

配信開始フロー

配信の終了

配信終了フロー