ここでの「ヘッドレス」の意味
ヘッドレス構成では、コントロールプレーンはWebページではなくAPIです。エージェント、スクリプト、CIジョブが、人がダッシュボードで行うのと同じ操作を、CLI、REST API、リモートMCPサーバー経由で実行します。各スクリーンのPlayerは、指示されたコンテンツをダウンロードしてローカルストレージから再生し、表示中の内容、ヘルス、デバイスが対応する操作を報告します。ダッシュボードは、使いたい人のために引き続き用意されていますが、開いていなくても何も困りません。このモデルについてはヘッドレスデジタルサイネージで、すべてのインターフェースについてはAPIのページで説明しています。
ステップ1：エージェント、またはコード用のサービスクライアントを接続する
AIエージェントには、一文を貼り付けるだけで、スキルとscreenrig CLIを同梱した公式screenRIGプラグインがインストールされます。初回の実行時に登録が行われ、組織とプロジェクトが作成されて、招待メールが届きます。その一文と各エージェント向けのインストールコマンドはクイックスタートにあります。
Claude、ChatGPT、GrokなどのMCPクライアントは、代わりにリモートMCPサーバーに接続できます。ダッシュボードで人が承認し、読み取り専用、提案、管理のいずれかを選びます。上のセッションのように見守るだけのエージェントなら、読み取り専用で十分です。プラグインは、メディアの変換やアプリのパッキングなど、お使いのマシン上で実行される手順を補います。サーバーのアドレスとサインインの方法はMCPクライアントを接続するをご覧ください。
スクリプト、CIジョブ、自社サービス向けには、必要なアクセス権だけを持つサービスクライアントを作成します：
screenrig service-client create --name "rollout-pipeline" --access manage読み取り専用のクライアントは監視ジョブに向いています。提案のクライアントによる変更は、人がレビューするまで保留されます。キーまたはシークレットによるサインインはサービスクライアントで説明しています。
ステップ2：スクリーンごとにプレーヤーを選ぶ
自動で起動し、遠隔で復旧できるデバイスを選びましょう。キオスクインストールの Raspberry Pi や Linux PC、BrightSign プレーヤー、Windows PC、管理対象の Android デバイスは、いずれも指示で再起動できます。スティックやテレビアプリは安価ですが、再起動はできません。比較はデジタルサイネージプレーヤーの選び方に、対応デバイスの一覧はダウンロードにあります。
ステップ3：ペアリングコードではなくフリートリンクでプロビジョニングする
ペアリングコードは、スクリーン1台なら十分です。10台なら、フリートリンクが便利です。これはPlayerのURL 1つで、開いたデバイスがそれぞれ独立したスクリーンとしてプロジェクトに追加され、リンクに設定したタグ、フィールド、プレイリストが適用されます。コードを読み上げる必要もありません。
screenrig fleet-links create --name "Kitsilano counters" --tag Kitsilano --tag Counter --playlist-id pl_MENU --max-screens 6 --expires-at 2026-11-30T23:59:59Z応答にはURLが含まれます。これはスクリーンを作成できる認証情報なので、デバイスのセットアップにだけ渡し、ページやチャットには絶対に渡さないでください。そのうえで、デバイスが見つけられる場所に置きます：
- Raspberry PiとLinux。リンクを指定して、インストーラーをキオスクとして実行します：
curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk --fleet-link URL。デバイスはPlayerに直接起動してプロジェクトに参加し、停電後も自動で復帰します。 - Android、Google TV、Amazon Signage Stick。デバイス管理ツールで、アプリの管理対象構成に
fleet_linkキーを設定します（パッケージはai.screenrig.player）。 - 工場出荷時にリセットした、カメラ付きのAndroid 10以降のデバイス。ウェルカム画面で、リンクのAndroidデバイスオーナー用QRコードをスキャンします。管理対象のPlayerがデバイスのホームアプリとして全画面で自動的にインストールされ、デバイス管理ツールは不要です。
- Mac、Apple TV、iPhone、iPad。MDMのマネージドApp構成に
fleet_linkを設定します。 - ChromeOS。Google管理コンソールで、キオスクアプリのURLにリンクを設定します。
--max-screensと--expires-atにより、流出したリンクがスクリーンを際限なく作り続けることを防ぎます。すでに作成されたスクリーンは再生を続けます。初期化（パワーウォッシュ）または再インストールされたデバイスは、以前のIDが10分間応答しなくなると、同じスクリーンとして復帰します。各デバイス管理ツールの設定はPlayerガイドに載っています。
ステップ4：各スクリーンにタイムゾーンと稼働時間を設定する
スケジュールは各スクリーン自身のタイムゾーンで動くため、まずそれを設定し、そのうえでスクリーンがオンになる時間を指定します：
screenrig screen set-timezone scr_KITS_COUNTER_1 --timezone America/Vancouver
screenrig screen display-schedule set --tag Window --file store-hours.jsonディスプレイスケジュールはプレーヤー上で動くため、店舗のインターネットが落ちていても、閉店時刻になれば画面は消灯します。対応するプレーヤーは、HDMI-CEC、DDC/CI、バックライトでテレビ自体を切り替え、それ以外は映像を黒くします。デジタルサイネージのHDMI-CECをご覧ください。すべてのプランで、再起動スケジュールにより、"Mon-Sun 04:00-04:30"のような静かな時間帯にデバイスを再起動できます。
ステップ5：公開して、再生されていることを確認する
エージェントは一文の指示で公開します。コードからは、screen publishが用意したファイルからプレイリストを作成して割り当て、Playerが表示中だと報告するまで待ちます：
screenrig screen publish scr_KITS_COUNTER_1 menu.json
screenrig screen screenshot --tag Kitsilano --output shots/割り当ては再生の証拠ではないため、公開はPlayerを待ち、スクリーンショットでスクリーンに映っているものを確認します。フリートの変更はタグまたはフォルダーで行い、フリート操作は届くスクリーン数に関係なく1リクエストです。書き込みにはリビジョンチェック（--expect-rev）を付けられるので、2人の書き手が気付かないうちに上書きし合うことはありません。
ステップ6：スクリーンに対応が必要になったら通知を受ける
どのプロジェクトも、スクリーンが10分間オフラインになると、オーナーにメールが1通届く状態から始まります。気になる条件を追加しましょう：
screenrig notifications create --email owner --conditions screen_offline,display_disconnected,not_playing,glass_blank,glass_frozen --tag Kitsilano通知では、デバイスの高温、ストレージの満杯、止まってしまったコンテンツ更新、クラッシュを繰り返すPlayer、進まなくなったプレイリストも監視できます。メールと署名付きWebhookはすべてのプランに含まれ、Slack、Teams、PagerDuty、TelegramへのルーティングはPlusに含まれます。自分で反応するエージェント向けには、screenrig events followがプロジェクトのイベントをストリーミングし、スクリーンのイベントはリッスンストリームでは無料です。
各Playerは、15分ごと、およびディスプレイの接続や電源が変わったときにただちに、稼働時間、メモリ、温度（デバイスが対応している場合）、ネットワーク、クラッシュといったヘルス情報を報告します。screen showはこれをスクリーンのホスト機能とあわせて返すため、エージェントは試す前にそのスクリーンにできることを把握できます。
ステップ7：現地に行かずに復旧する
スクリーンに障害が起きると、エージェントは最も手軽な対処から順に進め、そのPlayerが宣言している機能だけを使います：
- 確認する。
screen showは、スクリーンの直近の停止と、ヘルスレポートで判定できた場合はその原因の見込み（デバイスの再起動、アプリのクラッシュ、ネットワーク、screenRIG）を報告します。スクリーンショットで、画面に何が映っているかを確認できます。 - 再読み込み。
screen reloadは、デバイスには手を加えずにコンテンツを更新します。 - アプリの再起動またはキャッシュの消去。
screen restart-appはPlayerを再起動します。screen clear-cacheはダウンロード済みのコンテンツを破棄し、ペアリングは保持したまま、再ダウンロードします。 - 再起動。
screen rebootは、対応するPlayerでデバイスを再起動します。オフラインのスクリーンに送った場合は、最長24時間キューに保持され、スクリーンが復帰したときに実行されます。依頼した再起動では、デバイスが再起動している間もオフラインアラートは発生しません。 - 機器を交換する。デバイスが故障したら、交換用のデバイスをペアリングして
screen replaceを実行します。新しいデバイスが、古いスクリーンの名前、タグ、タイムゾーン、プレイリスト、スケジュール、履歴を引き継ぎます。
CLIリファレンスに、デバイスのすべてのコマンドと、対応するPlayerが一覧されています。
導入チェックリスト
- エージェントを接続済み、または必要最小限のアクセス権を持つサービスクライアントを用意済み
- 現地訪問のコストが高い場所では、遠隔再起動できるプレーヤーを選定済み
- 店舗またはグループごとに1つのフリートリンク。タグ、プレイリスト、スクリーン数の上限、有効期限を設定
- 各スクリーンのタイムゾーンを設定済み
- 営業時間外に消灯したいスクリーンのためのディスプレイスケジュール
- 最初の公開を、全スクリーンのスクリーンショットで確認済み
- オフライン、ディスプレイの切断、再生停止、画面のブランクやフリーズの通知
- アラートの受信者を指名済み
よくある質問
そもそもダッシュボードは必要ですか？
いいえ。このガイドの内容はすべて、エージェント、CLI、APIから実行できます。ダッシュボードはもうひとつのクライアントで、人が画面で確認したいときに役立ちます。
ペアリングコードを読み上げずに導入できますか？
はい。フリートリンクは、デバイス管理ツール、Linuxインストーラーのフラグ、AndroidのQRコードのいずれからでも、開いたすべてのデバイスを登録します。
店舗でインターネットが切れたらどうなりますか？
ネイティブPlayerはダウンロード済みのコンテンツの再生を続け、ディスプレイスケジュールもデバイス上で動き続けます。オフライン通知は、スクリーンが設定した待機時間オフラインのままになった時点で届きます。
導入にはいくらかかりますか？
screenRIGは無料で、Standardならスクリーン数も無制限です。有料プランで追加される内容は料金をご覧ください。