これらのガイドは、業種の概念を、プラットフォームに現在あるオブジェクト（ブーケ、回線、パッケージ、パートナーアカウント、ノード、API）に対応づけるものです。概念上の対応づけであり、業種専用の機能ではありません。また、パートナーアカウントは委任アカウントであり、分離されたテナントではありません。
概念の対応づけ
パネルには「客室」や「滞在」と呼ばれるものはありません。下の表は、どのオブジェクトがどの役割を担うかを示しており、以降の章ではその順に設定します。
| あなたの業種では | プラットフォームでは | パネル内の場所 |
|---|---|---|
| ホテル運営者または認定パートナー | パートナーアカウント（リセラー）：クレジット、権限、専用回線を持つ委任ダッシュボード | Users → リセラーを追加。権限は Groups で設定 |
| ブーケ | ブーケ：パッケージが付与する、チャンネル・映画・シリーズの名前付きセット | Bouquets。Streams と Movies / Series から作成 |
| 客室または端末 | 回線：パッケージ、ブーケ、有効期限、接続数の上限、出力を持つ1件のアクセス | Lines → 追加、またはアクティベーションコード、または Reseller API |
| ホテルの案内動画 | VOD カタログ：シーズンとエピソードを持つ映画とシリーズ、カテゴリ、メタデータ | Movies と Series、または VOD インジェストジョブ |
| ライセンス取得済みのテレビチャンネル | ライブチャンネル：ソース、EPG、出力フォーマットを持つストリーム | Streams → ライブストリームを追加（ソース URL または RTMP プッシュ） |
| 滞在期間 | 回線の有効期限。パッケージ、クレジット、API で更新されます | 回線の有効期限とパッケージの期間 |
| 建物または棟ごとに1つのノード | 配信ノード：パネルから登録するエッジサーバー。拠点または建物ごとに1台 | Servers → ノードを追加（SSH 経由でインストール） |
前提条件
インストール前に用意するもの。
- 施設ネットワーク上のサーバー（Ubuntu 22.04 または 24.04）、インストーラー、客室の端末から到達できるアドレス。
- 施設が権利を持つチャンネルフィード（プル URL または RTMP）、ホテルの案内動画、客室の端末（Android TV ボックス、MAG または Enigma2 ボックス、プレーヤーアプリまたはブラウザのあるスマートテレビ）。
- チェックイン時とチェックアウト時に PMS から HTTP API を呼び出せること、またはフロントがパネルで操作する手順。
インフラの導入
中央サーバーと、建物ごとのノード。
- 中央サーバーでインストーラーを実行します。再生のベースを施設の内部アドレスに設定し、客室がローカルネットワークに留まるようにします。
- Streams にチャンネルフィードを、Movies に案内動画を追加し、Web プレーヤーで確認します。
- Servers から、棟または建物ごとにノードを登録します。パネルが SSH 経由でインストールし、その建物の客室をノードに振り分けます。
- サーバーにライセンスキーを設定します。アクティベーションは現地で行われ、サービスは外部回線なしで動作します。
コンテンツの整理
ブーケとホテルの動画。
- 施設のチャンネルから、ブーケ（標準客室、スイート、会議）ごとに1つのブーケを作成します。
- ホテルの動画（ウェルカム、施設案内、安全）のブーケを作成し、すべてのパッケージに追加します。
- 客室カテゴリごとに、付与するブーケと期間1日のパッケージを1つ作成します。チェックイン時に客室の回線を宿泊数ぶん（1泊につき1回）更新し（更新のたびにパッケージの期間が加算されます）、チェックアウト時に無効化します（第8章）。
- テレビのメニューが見やすくなるよう、チャンネルを並べ替えてロゴを設定します。
パートナー（リセラー）の設定
施設、または複数の施設を運営する事業者を、委任アカウントとして設定します。
- 権限を回線（客室）に限定し、カタログの変更を認めないグループを作成します。
- 施設のフロント、または運営事業者を、そのグループと客室パッケージを持つリセラーとして追加します。
- 複数の施設を持つ事業者には、施設ごとに1つのリセラーを作成し、それぞれに独自の客室とクレジットを持たせます。
客室（回線）の設定
客室ごとに1つの回線。名前は部屋番号。
- Lines で、部屋番号を名前、客室カテゴリのパッケージを指定して、客室ごとに1つの回線を作成します。
- 最大接続数を1（テレビ1台）、または客室内の画面数に設定します。
- ネットワークが端末に固定アドレスを割り当てている場合は、回線を客室端末のアドレスに紐づけます。
- 端末を一度だけ設定します（回線の認証情報を使う Xtream Codes API または M3U、あるいは MAG / Enigma2 ポータル）。認証情報は客室に残ります。
ホテルの案内動画
施設独自の動画をオンデマンドで。
- ウェルカム動画と案内動画を映画としてアップロードします。施設の言語別バージョンは、別のエントリまたは音声トラックにします。
- それらをホテル動画のブーケに入れ、すべての客室カテゴリが受け取れるようにします。
- 情報が変わるたびにパネルから更新します。客室には新しいバージョンがすぐに表示されます。
ライセンス取得済みのテレビチャンネル
施設のチャンネルをライブストリームとして設定します。
- Streams で、ライセンス取得済みの各チャンネルをフィードとともに追加します。タイムシフトやキャッチアップは、ライセンスが許す場合にのみ有効にします。
- テレビの番組表に番組が表示されるよう、EPG ソースを追加します。
- 地域限定のチャンネルは、適切なパッケージだけが付与するブーケに入れておきます。
チェックイン、チェックアウト、有効期限
滞在を回線の有効期間として扱います。
- チェックイン時に客室の回線を有効にし、滞在期間ぶん更新します（PMS が API 経由で、またはフロントがパネルで）。
- チェックアウト時に回線を無効にします。次の滞在で再度有効にするため、認証情報が客室の外に出ることはありません。
- PMS またはフロントを Webhook に登録し、有効化、無効化、期限切れの回線を確認します。
PMS との連携
チェックインとチェックアウトが客室を制御します。
- PMS 用の Reseller API キーを作成し、PMS の設定に保管します。
- チェックイン時に PMS が、客室の回線に対して action=enable_line と action=renew_line をリクエスト ID 付きで呼び出し、チェックアウト時に action=disable_line を呼び出します。
- ゲストサービスアプリ（スタッフ呼び出し、ハウスキーピング、エクスプレスチェックアウト、ルームサービス）とそのバックオフィス接続は Enterprise プランに含まれ、施設と一緒に範囲を定めます。
セキュリティ上の考慮事項
チャンネルを施設内に留めます。
- 再生のベースとノードは施設のネットワーク内に置き、客室に不要なものをインターネットに公開しないでください。
- 客室ごとに1接続で端末に紐づけます。署名付きリンクは期限が切れるため、コピーされたリンクは使えなくなります。
- パネルは2要素ログインを使い、フロントには限定された権限グループを与えます。
- 暗号化データベースバックアップを有効にします。客室の認証情報がそこに含まれます。
トラブルシューティング
最初に確認する一般的なポイント。
- 客室でテレビが映らない：回線が有効で期限切れでないことを確認し、続いて端末の認証情報とアドレスを確認します。
- 客室でチャンネルが見つからない：客室カテゴリのパッケージのブーケを確認します。
- インターネット障害中にテレビが止まる：再生のベースとソースが内部アドレスであることを確認します。外部フィードは外部回線に依存します。
- PMS の呼び出しが失敗する：API キー、書き込みが POST であること、再試行時のリクエスト ID を確認します。