これらのガイドは、業種の概念を、プラットフォームに現在あるオブジェクト（ブーケ、回線、パッケージ、パートナーアカウント、ノード、API）に対応づけるものです。概念上の対応づけであり、業種専用の機能ではありません。また、パートナーアカウントは委任アカウントであり、分離されたテナントではありません。
概念の対応づけ
パネルに住戸や入居者という名前のものはありません。どのオブジェクトがどの役割を担うかを表で示し、以降の章ではその順にセットアップします。
| あなたの業種では | プラットフォームでは | パネル内の場所 |
|---|---|---|
| 物件管理者のアカウント | パートナーアカウント（リセラー）：クレジット、権限、専用回線を持つ委任ダッシュボード | Users → リセラーを追加。権限は Groups で設定 |
| チャンネル構成 | ブーケ：パッケージが付与する、チャンネル・映画・シリーズの名前付きセット | Bouquets。Streams と Movies / Series から作成 |
| チャンネルまたは案内チャンネル | ライブチャンネル：ソース、EPG、出力フォーマットを持つストリーム | Streams → ライブストリームを追加（ソース URL または RTMP プッシュ） |
| ウェルカム動画とお知らせ動画 | VOD カタログ：シーズンとエピソードを持つ映画とシリーズ、カテゴリ、メタデータ | Movies と Series、または VOD インジェストジョブ |
| 住戸のアクセス | 回線：パッケージ、ブーケ、有効期限、接続数の上限、出力を持つ1件のアクセス | Lines → 追加、またはアクティベーションコード、または Reseller API |
| 賃貸または入居期間 | 回線の有効期限。パッケージ、クレジット、API で更新されます | 回線の有効期限とパッケージの期間 |
| 建物のノード | 配信ノード：パネルから登録するエッジサーバー。拠点または建物ごとに1台 | Servers → ノードを追加（SSH 経由でインストール） |
前提条件
インストール前に用意するもの。
- 管理会社用のサーバー（Ubuntu 22.04 または 24.04）、インストーラー、入居者のネットワークに到達できる建物ごとのサーバー。
- コミュニティが再送信できるチャンネルフィード（プル URL または RTMP）、管理会社のお知らせとウェルカム動画、入居者のデバイス（セットトップボックス、プレーヤーアプリを入れたスマートテレビ、またはブラウザ）。
- 住戸タイプ（標準、シニア、学生）の決定と、管理会社の誰が回線を開設・更新するかの決定。
インフラの導入
中央サーバー、次に建物ごとのノード。
- 中央サーバーでインストーラーを実行し、再生のベース URL を各建物から到達できるアドレスに設定します。
- チャンネルフィードを Streams に、お知らせを Movies に追加し、ウェブプレーヤーで確認します。
- Servers から建物ごとにノードを登録します。パネルが SSH でインストールするか、ノードがワンタイムコードで登録し、その建物の入居者をノードへ振り分けます。
- Users → リセラーを追加 で物件管理者を追加し、回線を扱え、カタログは変更できないグループを割り当てます。
コンテンツの整理
住戸タイプごとのチャンネル構成。
- 住戸タイプごとのチャンネルからチャンネル構成ごとにブーケを 1 つ作成し、管理会社の案内用のブーケも作成します。
- 案内ブーケをすべてのパッケージに追加し、入居者全員がお知らせを受け取れるようにします。
- 住戸タイプごとに、そのブーケと、賃貸契約または入居期間に合った期間を持つパッケージを 1 つ作成します。
- テレビのメニューが見やすくなるよう、チャンネルを並べ替えてロゴを設定します。
パートナー（リセラー）の設定
物件管理者を委任アカウントに。
- 権限を回線に限定し、カタログやサーバーへのアクセスを許可しないグループを作成します。
- 各物件管理者を、そのグループ、担当する住戸のパッケージ、クレジット残高を持つリセラーとして追加します。
- 複数の建物を管理する管理者は、建物ごとにサブリセラーを追加でき、それぞれが自分の住戸とクレジットを持ちます。
住戸（回線）の設定
住戸ごとに 1 つの回線、部屋番号で命名。
- Lines → 追加 で住戸ごとに回線を 1 つ作成し、名前は部屋番号、パッケージはその住戸タイプのものにします。
- 最大接続数を住戸内のテレビの台数に設定します。
- 入居者がデバイスで短いコードを入力する形にしたい場合は、パスワードの代わりにアクティベーションコードを使います。
- デバイスは一度だけ設定します（回線の認証情報を使った Xtream Codes API または M3U、あるいは MAG や Enigma2 のポータル）。認証情報は回線に新しい認証情報が設定されるまで、その住戸に残ります。
ウェルカム動画とお知らせ動画
管理会社の動画をオンデマンドで。
- ウェルカム動画、住まいのルール、メンテナンスガイドを映画としてアップロードし、トピックごとにカテゴリを付けます。
- それらを案内ブーケに入れ、すべてのパッケージに含まれるようにします。
- 情報が変わったらパネルから動画を差し替えます。入居者には新しいバージョンがすぐに表示されます。
チャンネルと案内チャンネル
チャンネル構成とお知らせチャンネルをライブストリームで。
- ライセンス取得済みの各チャンネルをフィードとともに Streams に追加し、テレビの番組表に番組が表示されるよう EPG ソースを追加します。
- 案内チャンネルをライブストリームとして追加します。ソースは RTMP のエンコーダーまたはループするソースで、案内ブーケに入れます。
- 地域制限のあるチャンネルは、該当するパッケージだけが付与するブーケに入れておきます。
入居、退去、有効期限
入居期間が回線の有効期間になる。
- 回線はパッケージの期間の終了時に失効します。賃貸契約の新しい期間ごとにパッケージまたはクレジットで更新します。
- 入居者が退去したら回線を無効にします。次の入居者は新しい認証情報で再び有効にするため、以前の世帯には何も残りません。
- 住宅管理システムまたは管理者を Webhook に登録し、失効間近または失効済みの回線を把握します。
住宅管理・請求システムとの連携
システムがアクセスを開き、プレーヤーが再生する。
- 住宅管理・請求システム用に Reseller API キーを作成します。create_line、renew_line、enable_line、disable_line を呼び出し、書き込みのたびにリクエスト ID を送ります。
- 入居者が追加パッケージをオンラインで購入する場合はコマースコネクターを使います。それ以外のシステムは Reseller API と Webhook を使います。
- 視聴者向けのシングルサインオンはありません。入居者は回線の認証情報でプレーヤーにログインします。
セキュリティ上の考慮事項
サービスをコミュニティの内側に留める。
- パネルは TLS 付きのリバースプロキシの背後で提供し、TRUSTED_PROXIES を設定して、監査ログと IP ルールが実際のアドレスを認識できるようにします。
- すべての管理アカウントに二要素認証を使い、物件管理者には回線に限定した権限グループを付与します。
- 回線ごとの同時接続数制限、署名付きで期限のある再生リンク、デバイスに固定アドレスがある場合のアドレス紐づけ。
- オフサイトコピー付きの暗号化データベースバックアップを有効にします。回線の認証情報がその中にあります。
トラブルシューティング
最初に確認する一般的なポイント。
- 住戸でテレビが映らない：回線が有効で期限切れでないことを確認し、次にデバイスの認証情報と再生アドレスを確認します。
- 夜に建物でバッファリングする：建物のノードのハートビートと、入居者がそのノードに振り分けられているかを確認します。
- ある住戸タイプでチャンネルがない：そのパッケージのブーケを確認します。
- 管理者が回線を作成できない：リセラーのクレジット残高、グループの権限、割り当てられたパッケージを確認します。