連携上の考慮事項
課金システムは、事業者側にインストールするオープンソースのコネクター(WHMCS、Blesta、WISECP、HostBill、ClientExec、FOSSBilling、Paymenter、Odoo など)、または Reseller API と Webhook で接続します。これらのコネクター以外に、特定の OSS/BSS 製品とのネイティブ連携や視聴者向けのシングルサインオンはありません。
通信事業者・ISP
加入者には、各拠点(POP)のノードから配信されるチャンネル構成と VOD ライブラリが提供されます。回線は課金システムから作成・更新され、リセラーは各自のダッシュボードでクレジットを使って販売します。

課題
テレビの提供は、独自のアカウントを持つ別システムとしてではなく、インターネットプランとともに販売・請求・解約される必要があります。
遠方のデータセンターから配信するとアップストリーム回線に負荷がかかり品質にも影響するため、配信は加入者の近くから始めるべきです。
地域のリセラーがサービスを販売・サポートし、各プランは世帯が同時に使える画面数を制限します。
Xtream UI Pro の支援内容
契約ティアごとのパッケージがブーケを付与し期間を持ちます。課金システムがコネクターまたは Reseller API で加入者の回線を作成・更新・無効化します。
ノードはパネルから登録して SSH 経由でインストールします。各ノードはライブチャンネルをオリジンから 1 回だけ取得し、VOD ライブラリをキャッシュして、振り分けられた加入者に配信します。
リセラーは、クレジット、権限グループ、専用回線を持つパートナーアカウント(リセラー)です。サブリセラーで代理店網を再現でき、同時接続数制限は契約ごとに設定します。
プラットフォームの機能
以下は、この導入が利用する機能です。いずれも現在の製品に搭載されており、予定中のものやご要望ベースのものはありません。
ご自身のソースからのライブチャンネルを、ソースが対応していれば EPG、キャッチアップ、タイムシフト付きで、視聴者のアプリやボックスに HLS または MPEG-TS で配信します。
チャンネルごとにアップストリーム1本のオリジンハブ · RTMP 入出力 · ffmpeg トランスコード
映画、シーズンとエピソードを持つシリーズ、ラジオをカテゴリとブーケで整理できます。TMDB メタデータと、ソースをダウンロードしてエンコードするインジェストジョブを備えています。
署名付き・時間制限付き再生リンク · ノードごとの VOD キャッシュ
パネルからエッジサーバーを登録できます。視聴者は負荷と国に応じてノードに振り分けられ、ノードがない間はオリジンが全員に配信します。
パネルから SSH 経由でインストール · GeoIP ルーティング · ハートビートとトラフィック統計
回線は視聴者ひとりぶんのアクセスで、パッケージ、ブーケ、有効期限、接続数の上限、出力フォーマットを持ちます。アクティベーションコード、トライアル、更新も、どこでも同じルールで動作します。
Xtream Codes API、M3U/XMLTV、MAG・Enigma2 ポータル、Web プレーヤー
クレジット、権限、専用ダッシュボードを持つ委任アカウントを、最大5階層まで作成できます。取引先のディストリビューター、事業者、リセラー向けです。
グループと権限 · クレジット台帳 · サブパートナー
Reseller API を通じて、ご自身のシステムからアクセスの作成・更新・停止ができます。署名付き Webhook を受信でき、用意されたコネクタで課金・コマースプラットフォームとも連携できます。
冪等なリクエスト ID を持つ Reseller API · Admin API キー · 17 種のコネクタ
接続とトラフィックのビュー、監査ログ、Prometheus メトリクス、メール・Telegram・Webhook によるアラート、メンテナンスモード、組み込みのアップデート確認を備えています。
/metrics エンドポイント · リース付きジョブキュー · 暗号化データベースバックアップ
パネル内
サンプルカタログを入れた新規インストール直後のダッシュボードのスクリーンショットです。合成画像ではありません。


インフラのアーキテクチャ
事業者のコアサイトにある管理サーバー、各 POP のノード、チャンネル構成と VOD ライブラリ、ISP の課金システムと連動する加入者回線、クレジットを持つパートナーアカウントのリセラー。
図の各部分を選ぶと、その役割が表示されます。
事業者向けの構成では、ソースはライセンス取得済みのチャンネルフィードと VOD ライブラリです。パネルがパッケージ、ブーケ、加入者の回線、リセラーのクレジットを管理し、オリジンと POP ごとのノードが加入者に配信します。課金システムはコネクターまたは Reseller API で接続します。
パネル、API、ワーカー、オリジンを事業者のサーバーで動かします。再生のベース URL は加入者がアクセスするアドレスにし、各 POP のノードを Servers から登録します。
基本チャンネル構成、プレミアムチャンネル、VOD ライブラリのブーケを作ります。契約ティアごとに 1 つのパッケージを作り、期間とクレジットでの価格を設定します。
WHMCS、Odoo などのコネクター、または課金システム自身による Reseller API の呼び出しが、契約開始時に回線を作成し、期間ごとに更新し、解約時に無効にします。
地域のリセラーには、クレジットを持ち回線のみに限定されたグループのパートナーアカウントを付与します。代理店の販売はパッケージのクレジットを消費します。
設定の対応づけ
プラットフォームに業種専用のオブジェクトはありません。ブーケ、回線、パッケージ、パートナーアカウントを、その業種に必要な概念として使います。これらは概念上の対応づけであり、その業種向けのネイティブ機能ではありません。
前提条件、コアサイトと POP への展開、プラン、課金システムとの連携、リセラー、セキュリティ、トラブルシューティングを順を追って説明します。
セットアップガイドを読む| あなたの業種では | プラットフォームでは |
|---|---|
| リセラーまたは地域パートナーのアカウント | パートナーアカウント(リセラー):クレジット、権限、専用回線を持つ委任ダッシュボード |
| チャンネルのティアまたはアドオンパック | ブーケ:パッケージが付与する、チャンネル・映画・シリーズの名前付きセット |
| テレビチャンネル | ライブチャンネル:ソース、EPG、出力フォーマットを持つストリーム |
| VOD ライブラリ | VOD カタログ:シーズンとエピソードを持つ映画とシリーズ、カテゴリ、メタデータ |
| 加入者のテレビアクセス | 回線:パッケージ、ブーケ、有効期限、接続数の上限、出力を持つ1件のアクセス |
| 請求期間の終了 | 回線の有効期限。パッケージ、クレジット、API で更新されます |
| 契約あたりの画面数 | 回線の最大接続数:同時に視聴できる端末の数 |
| 課金・プロビジョニングとの連携 | Reseller API と Webhook:ご自身のシステムからパネルの操作を行う手段 |
| POP ノード | 配信ノード:パネルから登録するエッジサーバー。拠点または建物ごとに1台 |
課金システムは、事業者側にインストールするオープンソースのコネクター(WHMCS、Blesta、WISECP、HostBill、ClientExec、FOSSBilling、Paymenter、Odoo など)、または Reseller API と Webhook で接続します。これらのコネクター以外に、特定の OSS/BSS 製品とのネイティブ連携や視聴者向けのシングルサインオンはありません。
加入者の回線には同時接続数制限があり、アドレス、国、ISP に紐づけられます。再生リンクは署名付きで期限があり、リバースプロキシの背後では TRUSTED_PROXIES によりログと IP ルールに実際のアドレスが残ります。パネルアカウントは二要素認証、権限グループ、IP 許可リスト付きの Admin API キーを使い、監査ログと暗号化バックアップで補完します。
事業者は、加入者に提供するすべてのチャンネルとタイトルの権利を用意する必要があります。プラットフォームはコンテンツも権利も提供しません。標準プランが適用され、Enterprise の契約では連携作業と SLA が加わります。
コンテンツの権利と利用規定ヘルプセンター
導入前に運用者からよく寄せられる質問です。一般的な質問はヘルプセンターに掲載しています。
ヘルプセンターはい。ティアごとのパッケージと、課金システムからのコネクターまたは API 呼び出しにより、契約開始時に回線が作成され、終了時に無効になります。
17 種類のオープンソースコネクターが WHMCS、Blesta、HostBill、FOSSBilling、Odoo などをカバーします。それ以外のシステムは Reseller API と Webhook を使います。独自仕様の BSS 製品向けコネクターはありません。
リセラーはクレジットと専用回線を持つパートナーアカウントで、必要に応じてその配下にサブリセラーを置けます。委任アカウントであり、分離されたインストールではありません。