これらのガイドは、業種の概念を、プラットフォームに現在あるオブジェクト（ブーケ、回線、パッケージ、パートナーアカウント、ノード、API）に対応づけるものです。概念上の対応づけであり、業種専用の機能ではありません。また、パートナーアカウントは委任アカウントであり、分離されたテナントではありません。
概念の対応づけ
パネルにステージやチケットという名前のものはありません。どのオブジェクトがどの役割を担うかを表で示し、以降の章ではその順にセットアップします。
| あなたの業種では | プラットフォームでは | パネル内の場所 |
|---|---|---|
| ステージのチャンネル | ライブチャンネル：ソース、EPG、出力フォーマットを持つストリーム | Streams → ライブストリームを追加（ソース URL または RTMP プッシュ） |
| チケット種別 | ブーケ：パッケージが付与する、チャンネル・映画・シリーズの名前付きセット | Bouquets。Streams と Movies / Series から作成 |
| チケットまたはパス | 回線：パッケージ、ブーケ、有効期限、接続数の上限、出力を持つ1件のアクセス | Lines → 追加、またはアクティベーションコード、または Reseller API |
| イベント終了 | 回線の有効期限。パッケージ、クレジット、API で更新されます | 回線の有効期限とパッケージの期間 |
| チケットあたりのデバイス数 | 回線の最大接続数：同時に視聴できる端末の数 | 回線の最大接続数 |
| チケット販売・参加登録との連携 | Reseller API と Webhook：ご自身のシステムからパネルの操作を行う手段 | リセラーのダッシュボードにある Reseller API キーと Webhook |
| 会場ノード | 配信ノード：パネルから登録するエッジサーバー。拠点または建物ごとに1台 | Servers → ノードを追加（SSH 経由でインストール） |
前提条件
インストール前に用意するもの。
- 公開アドレスまたはドメインを持ち、想定するピーク時の視聴者に十分なアップリンクを持つサーバー（Ubuntu 22.04 または 24.04）と、会場ノード用に会場のネットワーク上のマシン。
- RTMP をプッシュできるステージごとのエンコーダーと、ステージ・日程・チケット種別の一覧。
- チケットをパネルに届ける方法の決定。アクティベーションコードの一括生成、またはチケット販売システムによる Reseller API の呼び出し。
インフラの導入
まずオリジン、次に会場。
- 管理サーバーでインストーラーを実行し、パネルを TLS 付きのリバースプロキシの背後に置きます。信頼するプロキシを設定して、IP ルールが視聴者の実際のアドレスを認識できるようにします。
- 再生のベース URL を、参加者がアクセスする公開アドレスに設定します。
- 会場のマシンに Servers からノードを登録します。パネルが SSH でインストールし、ローカルスクリーンがそのノードへ振り分けられます。
- チケット窓口用に、回線の権限があり、カタログの権限がないパートナーアカウント（リセラー）を作成します。
コンテンツの整理
ステージはチャンネル、チケットはパッケージ。
- 日ごとまたはトラックごとにカテゴリを追加し、チャンネル一覧がプログラムのように読めるようにします。
- チケット種別ごとにブーケを 1 つ作成します。そのチケットで視聴できるステージを入れます。
- チケット種別ごとにイベントの長さを期間とするパッケージを 1 つ作成し、必要に応じて報道関係者や講演者向けの体験パッケージも作ります。
- スポンサーのステージまたはラウンジのフィード用ブーケを作成し、スポンサーパッケージでのみ付与します。
パートナー（リセラー）の設定
アクセスを発行する場合のチケット窓口。
- チケット窓口用に、回線の権限を持ち、カタログの権限を持たないグループを作成します。
- 窓口をそのグループと、発行するコードに十分なクレジットを持つリセラーとして追加します。
- 独自にチケットを販売する共同主催者や地域パートナーには、専用のパートナーアカウントとパッケージを付与します。
参加者のアクセス設定
チケットごとに 1 つの回線。
- チケットごとに 1 つ、そのチケット種別のパッケージに紐づくアクティベーションコードを一括生成し、チケットとともに印刷またはメールで送ります。
- オンラインのチケット販売では、コマース基盤のコネクターをインストールするか、チケット販売システムがパッケージとリクエスト ID を指定して action=create_line を呼び出します。
- 最大接続数をチケットあたり 1〜2 台に設定し、コードが観客全体で共有されないようにします。
- 開場前に体験回線でテストし、参加者が使うのと同じプレーヤーを使います。
セッションの録画
イベント後の録画。
- 各ステージを録画し、そのファイルをトラックごとのシリーズのエピソードとしてライブラリに追加するか、VOD 取り込みジョブで取り込みます。
- 録画は専用のブーケとパッケージで付与し、ライブ用の回線が失効した後も参加者がアクセスできるようにします。
- 告知する前に、そのパッケージのテスト用回線で録画の再生を確認します。
ステージチャンネル
ステージをライブチャンネルに。
- エンコーダーの RTMP プッシュでステージごとにライブストリームを追加し、視聴できるチケット種別のブーケに入れます。
- キャッチアップを有効にして、セッションの冒頭を見逃した参加者が巻き戻せるようにします。
- 最初のセッションの前に、会場ノードが各ステージをオリジンから 1 回だけ取得していること、スクリーンがそこに振り分けられていることを確認します。
有効期限
アクセスはイベントとともに終わる。
- すべてのチケットパッケージの期間をイベント最終日に終わるように設定すると、何もしなくても回線が失効します。
- 講演者や遅れて来たスポンサーには、新しいパッケージを作る代わりに、回線を 1 つ延長するか、短期間のコードを発行します。
- 紛失または共有されたチケットの回線は Lines から無効にします。監査ログに記録が残ります。
チケット販売システムとの連携
システムがアクセスを動かし、プレーヤーが再生する。
- チケット販売・参加登録システムは Reseller API で回線を作成し、line.created や line.expired などの Webhook を受信します。
- 対応するコマース基盤でのオンラインチケット販売はそのコネクターを使います。特定のチケット販売製品向けのネイティブコネクターはありません。
- 視聴者向けのシングルサインオンはありません。参加者は、回線の認証情報またはアクティベーションコードでプレーヤーにログインします。
セキュリティ上の考慮事項
チケットは 1 人分。
- パネルと再生のベース URL は TLS で提供し、TRUSTED_PROXIES をリバースプロキシに設定します。
- すべてのパネルアカウントに二要素認証を使い、チケット窓口がステージを変更できないよう権限グループを設定します。
- 署名付きで期限のある再生リンクと、チケットごとの低い同時接続数制限。
- オフサイトコピー付きの暗号化データベースバックアップと、回線とステージのすべての変更を記録する監査ログ。
トラブルシューティング
最初に確認する一般的なポイント。
- 参加者がステージを開けない：回線のパッケージ、ステージを含むブーケ、有効期限を確認します。
- 会場ではステージが固まるがオンラインでは問題ない：会場ノードのハートビートと、スクリーンからそのノードへの経路を確認します。
- アクティベーションコードが拒否される：すでに使用されていないか、そのパッケージがまだ有効かを確認します。
- 監査ログにプロキシのアドレスが表示される：TRUSTED_PROXIES をそのプロキシに設定し、パネルを再起動します。