博物館・文化施設向けセットアップガイド

概念の対応づけ

パネルに展示室や会員という名前のものはありません。どのオブジェクトがどの役割を担うかを表で示し、以降の章ではその順にセットアップします。

1前提条件

インストール前に用意するもの。

1. 館内のサーバー（Ubuntu 22.04 または 24.04）、インストーラー、スクリーンと会員のデバイスが使う展示室ネットワーク。
2. 展示映像、権利を持つアーカイブ録画、講堂用のエンコーダー、展示室用のスクリーンまたはメディアプレーヤー。
3. ライセンスキー、建物にインターネットがない場合はオフラインアクティベーションの手順、窓口で誰が会員資格を販売するかの決定。

2インフラの導入

館内のサーバーを現地でアクティベート。

1. サーバーでインストーラーを実行し、再生のベース URL を展示室ネットワークから到達できるアドレスに設定します。
2. パネルからライセンスキーをオフラインでアクティベートします。アクティベート後は、インターネットなしでローカルネットワーク上でサービスが動作します。
3. 展示映像を Movies に、講堂のフィードを Streams に追加し、ウェブプレーヤーで確認します。
4. 2 つ目の拠点や大規模な公開プログラムがある場合は、Servers からノードを登録します。パネルが SSH でインストールし、その拠点の視聴者をノードへ振り分けます。

3コンテンツの整理

展示室、アーカイブ、会員向けコレクション。

1. 展覧会と年ごとにカテゴリを作成し、講演シリーズには講演ごとに 1 エピソードのシリーズを作ります。
2. 展示室スクリーン用のブーケと、講演とアーカイブ映像の会員ライブラリ用のブーケを作成します。
3. 展示室用のパッケージと、会員の種類ごとのパッケージを作成し、それぞれにブーケを付与します。会員パッケージの期間が会員期間です。
4. すべての映画にポスターと短い説明を追加し、プレーヤーでライブラリが見やすくなるようにします。

4パートナー（リセラー）の設定

窓口とショップを委任アカウントに。

1. 権限を回線とアクティベーションコードに限定し、カタログやサーバーへのアクセスを許可しないグループを作成します。
2. 窓口またはショップを、そのグループ、会員パッケージ、クレジット残高を持つリセラーとして追加します。
3. 複数の会場を運営する文化施設は、会場ごとにリセラーを追加でき、それぞれが自分の残高から会員資格を販売します。

5来館者と会員のアクセス設定

スクリーンと会員を回線で。

1. Lines → 追加 で展示室スクリーンごとに 1 つの回線を展示室用パッケージで作成し、ネットワークが固定アドレスを割り当てている場合はスクリーンのアドレスに紐づけます。
2. 窓口で販売した会員資格ごとにアクティベーションコードを作成します。会員がプレーヤーにコードを入力すると回線が開始されます。
3. 会員資格ごとの最大接続数を、会員が使えるデバイスの数（通常は 2 台）に設定します。
4. 会員には、端末に合わせてプレーヤーアプリ、M3U プレイリスト、またはウェブプレーヤーのアドレスのいずれかを渡します。

6展示映像とアーカイブ

オンデマンドのライブラリ。

1. 展示映像とデジタル化したアーカイブを映画としてアップロードするか、VOD 取り込みジョブでメディアルートに取り込みます。
2. TMDB のメタデータがあれば追加し、ないものはタイトルと説明を自分で書きます。
3. 一般公開しないアーカイブは会員用ブーケだけに入れ、テスト用回線で各パッケージに何が見えるかを確認します。

7オープニングと講演

イベントをライブチャンネルに。

1. 講堂のエンコーダー（RTMP プッシュ）用にライブストリームを追加し、会員用ブーケに入れます。スクリーンに映すオープニングの場合は展示室用ブーケに入れます。
2. キャッチアップを有効にして、遅れて来た会員が巻き戻せるようにし、終了後に録画をライブラリにアップロードします。
3. イベントの前に、観客が使うのと同じネットワークでテスト用回線を使ってエンコーダーとストリームをテストします。

8会員資格の有効期限と更新

会員資格が回線の有効期間になる。

1. 回線はパッケージの期間の終了時に失効します。窓口での更新でもう 1 期間が加算されます。
2. 会員資格が解約されたら回線を無効にします。一度も使われていないアクティベーションコードは、引き換えられるまで未使用のままです。
3. ショップまたは会員管理システムを Webhook に登録し、失効間近または失効済みの回線を把握します。

9ショップ・会員管理システムとの連携

システムがアクセスを販売し、プレーヤーが再生する。

1. ショップまたは会員管理システム用に Reseller API キーを作成します。create_line、renew_line、disable_line を呼び出し、書き込みのたびにリクエスト ID を付けます。
2. 会員資格をオンラインで販売する場合はコマースコネクターを使います。それ以外のシステムは Reseller API と Webhook を使います。
3. 視聴者向けのシングルサインオンはありません。会員は、回線の認証情報またはアクティベーションコードでプレーヤーにログインします。

10セキュリティ上の考慮事項

コレクションをあるべき場所に留める。

1. 展示室ネットワークを来館者のネットワークから分離し、公開アクセスは TLS 付きのリバースプロキシの背後で提供して TRUSTED_PROXIES を設定します。
2. すべてのパネルアカウントに二要素認証を使い、窓口には回線とコードに限定した権限グループを付与します。
3. 署名付きで期限のある再生リンク、会員資格ごとの同時接続数制限、展示室スクリーンのアドレス紐づけ。
4. オフサイトコピー付きの暗号化データベースバックアップを有効にし、監査ログで回線とカタログの変更を確認します。

11トラブルシューティング

最初に確認する一般的なポイント。

1. 展示室のスクリーンが真っ黒：回線が有効で期限切れでないこと、スクリーンのアドレス紐づけ、展示室ネットワークからサーバーに到達できることを確認します。
2. 会員のコードが使えない：コードがすでに引き換えられていないか、開くパッケージがまだ窓口に割り当てられているかを確認します。
3. オフラインでライセンスのアクティベーションに失敗する：アクティベーションファイルをライセンスキーと照合し、サーバーの時計を確認します。
4. ライブのオープニングがカクつく：エンコーダーのビットレートをアップリンクと照らし合わせ、Streams でストリームの状態を確認します。