画面の幅いっぱいで下端にぴったりのバーです。画面に必要な小さな情報をまとめます。左右のスロットはそれぞれ単語、タグ、時計、現在の天気、アイコン、日付、ステータスドット、ロゴ、カウントダウン、数字、現在のページ、または静かなアラート(温かくまたは赤く変わる)を表示します。中央は静止メッセージ、長い場合はスクロール、最大8ページのページ送りが可能です。項目とメッセージは設定・変更でき、バーはすべての画面で位置を保持します。
ライブカード
カテゴリ: メッセージ。タグ: ロビーと受付、オフィスと職場、店舗。
レイアウト
このバーカードはフッターとして配置されます:全幅のバーで高さ80、下端にぴったり合わせます。レイアウトやアンカーは使用しません。
レイアウト:フッター。フォーム:ストリップ。
データとプライバシー
フィード:screenrig.weather/v1。
フィードドキュメントは情報源の帰属を含みます。プレーヤーがカードにフィードを提供します。
天気の帰属:フィードドキュメントに記載されているWeatherbitによる天気データ。
プロパティ
テーマ、背景、アクセントについては共通プロパティを参照してください。バーカードにはlayoutやanchorのプロパティはなく、常にフッターとして配置されます。
カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。
静的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
location | オブジェクト、null | null | additionalProperties:false | 天気情報の取得場所。指定なしは天気データなしで空欄。 |
location.name | string | maxLength:40;必須 | ||
location.latitude | number | 最小値:-90;最大値:90;必須 | ||
location.longitude | number | 最小値:-180;最大値:180;必須 | ||
timeZone | 文字列、null | null | maxLength:64 | 時計、日付、カウントダウン項目のIANAゾーン。nullの場合はスクリーンのゾーンを使用。 |
backgroundColor | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | カードの背景とプレートをフラットなCSS順序の色で上書きします。#RRGGBBAAは不透明度を指定します。background noneが優先されます。 |
textColor | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。 |
動的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
left | オブジェクト、null | null | additionalProperties:false | 左スロット:幅 250 px(内側は 240 x 70)、コンテンツは先頭側に寄せ、スクリーンの端から 24 px 離します。null を指定すると空になり、スペースはそのまま確保されます。kind が読み取る項目:テキストとタグは text、時計は hourCycle と timeZone、天気は unit(天気フィードから)、アイコンは icon、日付は dateStyle と timeZone、ステータスは text、tone、pulse、ロゴは media、カウントダウンは at と label、数値は label と value、ページは page、of、style、アラートは active、severity、text。時計の hourCycle、天気項目の unit、日付の順序は、項目で指定しない限り Player のロケールに従います。 |
left.kind | string | "text"、"tag"、"clock"、"weather"、"icon"、"date"、"status"、"logo"、"countdown"、"number"、"page"、"alert";必須 | スロットが表示するもの。 | |
left.text | string | "" | maxLength:60 | テキスト、タグ、ステータスまたはアラート項目の単語です。 |
left.size | string | "small" | "small", "medium", "large" | テキスト、タグ、ステータス、アラート項目の文字サイズ(1080p で 24、32、44 px。小サイズのテキストは 2 行、ほかは 1 行)、日付の文字サイズ(32、44、56 px、1 行)、時計、天気、カウントダウン、ページ、アイコン項目の数字のサイズ。 |
left.color | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | #RRGGBB または #RRGGBBAA のテキストまたはアイコンの色。null の場合はテーマのテキスト色を使用します。 |
left.fill | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | タグの角丸長方形:#RRGGBB または #RRGGBBAA。nullはテキスト色の半透明(Clearテーマではアウトライン)。 |
left.icon | null、文字列 | null | null, "activity-01", "air-vent", "airplane-01", "alert-01", "alert-02", "american-football", "analytics-up", "apple", "arrow-down-01", "arrow-down-right-01", "arrow-up-01", "arrow-up-right-01", "award-01", "baseball", "basketball-01", "battery-full", "bell-ring", "bicycle", "birthday-cake", "bitcoin", "bus-01", "calendar-03", "calendar-04", "calendar-add-01", "calendar-check", "call-02", "camera-01", "cancel-circle", "car-01", "champion", "chart-decrease", "chart-increase", "checkmark-circle-02", "clock-01", "clock-02", "cloud", "cloud-angled-rain", "cloud-angled-zap", "cloud-big-rain", "cloud-drizzle", "cloud-fog", "cloud-hailstone", "cloud-snow", "coffee-01", "coffee-02", "contact-01", "container-truck-01", "cricket-bat", "crown", "delivery-truck-01", "dices", "discord", "discount-tag-01", "dollar-02", "door-closed-locked", "door-open", "drink", "droplet", "ethereum", "euro", "exchange-01", "facebook-01", "factory", "fast-wind", "favourite", "ferry-boat", "fire", "fire-02", "first-aid-kit", "flag-01", "flag-02", "flash", "flower-01", "football", "gauge", "gift", "git-branch", "globe-02", "google", "hand-prayer", "heart", "help-circle", "home-01", "hourglass", "humidity", "ice-hockey", "information-circle", "instagram", "lamp-01", "lantern", "leaf-01", "leaf-02", "lightbulb", "link-01", "linkedin-01", "litecoin", "location-01", "location-04", "mail-01", "medal-first-place", "medical-mask", "meeting-room", "megaphone-01", "message-01", "money-exchange-02", "moon-02", "moon-cloud", "moon-star", "music-note-01", "navigation-03", "new-releases", "new-twitter", "news", "news-01", "noodles", "package-delivered", "parking-area-square", "party", "party-popper", "pause-circle", "percent-circle", "pinterest", "pizza-01", "play-circle", "play-store", "podium", "pound", "pumpkin", "qr-code", "qr-code-01", "queue-01", "quote-down", "quote-up", "ranking", "restaurant-01", "rocket-01", "rss", "running-shoes", "sale-tag-01", "security-check", "shop-sign", "shopping-bag-01", "siren", "smart-phone-01", "snapchat", "snowflake", "sparkles", "spotify", "star", "star-half", "star-off", "stop-circle", "store-01", "sun-03", "sun-cloud-02", "sunrise", "sunset", "swimming", "tag-01", "target-02", "temperature", "tennis-ball", "thermometer", "thermometer-cold", "thermometer-warm", "threads", "ticket-01", "tiktok", "time-quarter-pass", "timer-01", "tornado-02", "train-01", "tram", "trophy", "tropical-storm", "tsunami", "user-02", "user-group", "user-love-01", "vegetarian-food", "volleyball", "volume-high", "vote", "walking", "warehouse", "waves", "whatsapp", "wheat-off", "wifi-01", "wifi-full-signal", "wifi-lock", "wrench-01", "yen", "youtube" | アイコン項目のアイコンです。 |
left.tone | string | "cool" | パターン:"^(success|warm|danger|cool|accent|muted|#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?)$" | ステータスドットの色:パレットキー(成功はokまたはopen、警告はwatchまたはsoon、危険はalarmまたはclosed、情報はcool)または #RRGGBB。 |
left.pulse | boolean | false | 1秒に1回点滅するステータスドット。 | |
left.hourCycle | string | "auto" | "auto", "12", "24" | 時計の時間:自動はPlayerのロケールに従います(通常12時間制の場所では2:05 PM、それ以外は14:05);12はどのロケールでも2:05 PM、24は14:05です。 |
left.timeZone | 文字列、null | null | maxLength:64 | 時計、日付、カウントダウンのIANAゾーン。nullの場合はバーのゾーンを使用し、それ以外はスクリーンのゾーン。 |
left.dateStyle | string | "short" | "short", "long" | 日付アイテム:短縮はWed 21 Oct、長い形式はWednesday 21 October;米国ロケールでは月が先に来ます(Wed Oct 21、Wednesday, October 21)。曜日と月名は英語;長い日付が収まらない場合は短縮形式に切り替わります。 |
left.at | 文字列、null | null | maxLength:40 | カウントダウンのISO 8601瞬間。オフセットなしは項目のゾーンの壁時計時間。 |
left.label | string | "" | maxLength:24 | 数値のラベルは値の上に表示します。カウントダウンのラベルは、カウント中の数字と、時刻に達したあとに表示される言葉の上に表示します(全体が収まらない場合は省略)。 |
left.value | string | "" | maxLength:16 | 数値の値を、読みやすい形式で表示します(例:1,284 または 98%)。 |
left.media | string | "" | maxLength:200 | ロゴアイテムの画像:240×70に収まるプロジェクトのメディア参照(media:<id>)。 |
left.page | integer | 1 | 最小値:1;最大値:999 | ページ項目の現在のページ番号(1から始まる)。 |
left.of | integer | 1 | 最小値:1;最大値:999 | ページ項目の総ページ数。 |
left.style | string | "numbers" | "dots", "numbers" | ページ項目を 3 / 8 またはドットで表示します(ドットは最大12ページまで)。 |
left.active | boolean | false | アラート項目:false は静かなチェックマーク、true は重大度の色と文言を表示します。 | |
left.severity | string | "warm" | "warm", "danger" | アクティブなアラート項目の色:ウォッチはウォーム、アラームは危険色です。 |
left.unit | string | "auto" | "auto", "c", "f" | 天気アイテムの温度スケール:autoはPlayerのロケール地域が使用する場合は華氏(US PR GU VI AS MP BS BZ KY PW LR)、それ以外は摂氏。cとfはすべてのロケールで摂氏または華氏を強制。 |
right | オブジェクト、null | null | additionalProperties:false | 右スロット:幅 250 px(内側は 240 x 70)、コンテンツは末尾側に寄せ、スクリーンの端から 24 px 離します。項目は左スロットと同じで、ロケールのルールも同じです。 |
right.kind | string | "text"、"tag"、"clock"、"weather"、"icon"、"date"、"status"、"logo"、"countdown"、"number"、"page"、"alert";必須 | スロットが表示するもの。 | |
right.text | string | "" | maxLength:60 | テキスト、タグ、ステータスまたはアラート項目の単語です。 |
right.size | string | "small" | "small", "medium", "large" | テキスト、タグ、ステータス、アラート項目の文字サイズ(1080p で 24、32、44 px。小サイズのテキストは 2 行、ほかは 1 行)、日付の文字サイズ(32、44、56 px、1 行)、時計、天気、カウントダウン、ページ、アイコン項目の数字のサイズ。 |
right.color | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | #RRGGBB または #RRGGBBAA のテキストまたはアイコンの色。null の場合はテーマのテキスト色を使用します。 |
right.fill | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | タグの角丸長方形:#RRGGBB または #RRGGBBAA。nullはテキスト色の半透明(Clearテーマではアウトライン)。 |
right.icon | null、文字列 | null | null, "activity-01", "air-vent", "airplane-01", "alert-01", "alert-02", "american-football", "analytics-up", "apple", "arrow-down-01", "arrow-down-right-01", "arrow-up-01", "arrow-up-right-01", "award-01", "baseball", "basketball-01", "battery-full", "bell-ring", "bicycle", "birthday-cake", "bitcoin", "bus-01", "calendar-03", "calendar-04", "calendar-add-01", "calendar-check", "call-02", "camera-01", "cancel-circle", "car-01", "champion", "chart-decrease", "chart-increase", "checkmark-circle-02", "clock-01", "clock-02", "cloud", "cloud-angled-rain", "cloud-angled-zap", "cloud-big-rain", "cloud-drizzle", "cloud-fog", "cloud-hailstone", "cloud-snow", "coffee-01", "coffee-02", "contact-01", "container-truck-01", "cricket-bat", "crown", "delivery-truck-01", "dices", "discord", "discount-tag-01", "dollar-02", "door-closed-locked", "door-open", "drink", "droplet", "ethereum", "euro", "exchange-01", "facebook-01", "factory", "fast-wind", "favourite", "ferry-boat", "fire", "fire-02", "first-aid-kit", "flag-01", "flag-02", "flash", "flower-01", "football", "gauge", "gift", "git-branch", "globe-02", "google", "hand-prayer", "heart", "help-circle", "home-01", "hourglass", "humidity", "ice-hockey", "information-circle", "instagram", "lamp-01", "lantern", "leaf-01", "leaf-02", "lightbulb", "link-01", "linkedin-01", "litecoin", "location-01", "location-04", "mail-01", "medal-first-place", "medical-mask", "meeting-room", "megaphone-01", "message-01", "money-exchange-02", "moon-02", "moon-cloud", "moon-star", "music-note-01", "navigation-03", "new-releases", "new-twitter", "news", "news-01", "noodles", "package-delivered", "parking-area-square", "party", "party-popper", "pause-circle", "percent-circle", "pinterest", "pizza-01", "play-circle", "play-store", "podium", "pound", "pumpkin", "qr-code", "qr-code-01", "queue-01", "quote-down", "quote-up", "ranking", "restaurant-01", "rocket-01", "rss", "running-shoes", "sale-tag-01", "security-check", "shop-sign", "shopping-bag-01", "siren", "smart-phone-01", "snapchat", "snowflake", "sparkles", "spotify", "star", "star-half", "star-off", "stop-circle", "store-01", "sun-03", "sun-cloud-02", "sunrise", "sunset", "swimming", "tag-01", "target-02", "temperature", "tennis-ball", "thermometer", "thermometer-cold", "thermometer-warm", "threads", "ticket-01", "tiktok", "time-quarter-pass", "timer-01", "tornado-02", "train-01", "tram", "trophy", "tropical-storm", "tsunami", "user-02", "user-group", "user-love-01", "vegetarian-food", "volleyball", "volume-high", "vote", "walking", "warehouse", "waves", "whatsapp", "wheat-off", "wifi-01", "wifi-full-signal", "wifi-lock", "wrench-01", "yen", "youtube" | アイコン項目のアイコンです。 |
right.tone | string | "cool" | パターン:"^(success|warm|danger|cool|accent|muted|#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?)$" | ステータスドットの色:パレットキー(成功はokまたはopen、警告はwatchまたはsoon、危険はalarmまたはclosed、情報はcool)または #RRGGBB。 |
right.pulse | boolean | false | 1秒に1回点滅するステータスドット。 | |
right.hourCycle | string | "auto" | "auto", "12", "24" | 時計の時間:自動はPlayerのロケールに従います(通常12時間制の場所では2:05 PM、それ以外は14:05);12はどのロケールでも2:05 PM、24は14:05です。 |
right.timeZone | 文字列、null | null | maxLength:64 | 時計、日付、カウントダウンのIANAゾーン。nullの場合はバーのゾーンを使用し、それ以外はスクリーンのゾーン。 |
right.dateStyle | string | "short" | "short", "long" | 日付アイテム:短縮はWed 21 Oct、長い形式はWednesday 21 October;米国ロケールでは月が先に来ます(Wed Oct 21、Wednesday, October 21)。曜日と月名は英語;長い日付が収まらない場合は短縮形式に切り替わります。 |
right.at | 文字列、null | null | maxLength:40 | カウントダウンのISO 8601瞬間。オフセットなしは項目のゾーンの壁時計時間。 |
right.label | string | "" | maxLength:24 | 数値のラベルは値の上に表示します。カウントダウンのラベルは、カウント中の数字と、時刻に達したあとに表示される言葉の上に表示します(全体が収まらない場合は省略)。 |
right.value | string | "" | maxLength:16 | 数値の値を、読みやすい形式で表示します(例:1,284 または 98%)。 |
right.media | string | "" | maxLength:200 | ロゴアイテムの画像:240×70に収まるプロジェクトのメディア参照(media:<id>)。 |
right.page | integer | 1 | 最小値:1;最大値:999 | ページ項目の現在のページ番号(1から始まる)。 |
right.of | integer | 1 | 最小値:1;最大値:999 | ページ項目の総ページ数。 |
right.style | string | "numbers" | "dots", "numbers" | ページ項目を 3 / 8 またはドットで表示します(ドットは最大12ページまで)。 |
right.active | boolean | false | アラート項目:false は静かなチェックマーク、true は重大度の色と文言を表示します。 | |
right.severity | string | "warm" | "warm", "danger" | アクティブなアラート項目の色:ウォッチはウォーム、アラームは危険色です。 |
right.unit | string | "auto" | "auto", "c", "f" | 天気アイテムの温度スケール:autoはPlayerのロケール地域が使用する場合は華氏(US PR GU VI AS MP BS BZ KY PW LR)、それ以外は摂氏。cとfはすべてのロケールで摂氏または華氏を強制。 |
middle | オブジェクト、null | null | additionalProperties:false | スロット間のメッセージ。テキスト(またはページ)がない場合、中央は空白のままでスペースを保持します。幅が100px未満になる場合は非表示。 |
middle.text | string | "" | maxLength:160 | 静的またはクロールするメッセージの単語です。 |
middle.size | string | "small" | "small", "medium", "large" | 1080p で、2 行までは 28 px、1 行では 38 px または 52 px。 |
middle.align | string | "center" | "start", "center", "end" | 単語の中央配置。 |
middle.color | 文字列、null | null | パターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | #RRGGBB または #RRGGBBAA のテキスト色。null の場合はテーマのテキスト色を使用します。 |
middle.mode | string | "static" | "static", "crawl", "pages" | static は、収まりきらないメッセージを文単位で 1 つずつ順に表示します。crawl は動きが有効な間、メッセージを中央に流します(収まるときは静止し、静止状態や動きを減らす設定では文単位で表示します)。pages は pages の文字列を 1 つずつ順に表示します。 |
middle.pages | array | [] | maxItems:8 | ページモードのメッセージを順に表示。 |
middle.pageSeconds | integer | 8 | 最小値:3;最大値:60 | 各ページが表示される秒数。表示されるページは時計に従い、すべてのスクリーンで同じページを表示します。 |
キャンバス例
静的プロパティを params.json として保存し、カードを作成します。結果にはその crd_ ID が含まれます。
{
"theme": "neomustard",
"location": {
"name": "Vancouver",
"latitude": 49.25,
"longitude": -123.0
}
}
screenrig card create --type footer --major 1 --file params.json
このアイテムをプレイリストページのprimitivesに追加し、サンプルの ID をその ID に置き換えます。プレイリストを公開してスクリーンに割り当ててください。
{
"id": "footer",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "footer",
"content_fit": "fill"
}
ライブデータを書き込む
カードを作成した後にドキュメントを書き込み、画面を再公開せずに更新するには置き換えます。カードは書き込みのたびに動的プロパティと照合し、受け付けないドキュメントは拒否します。プレイリストと同じプロジェクトを使用してください。
ドキュメントを card-data.json として保存します。CLIはラッパーなしでドキュメント自体を読み取ります。
{
"left": null,
"right": null,
"middle": null
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json
またはAPIを直接呼び出します。APIは同じドキュメントをdocumentフィールドにラップします。エージェントトークンはすでにプロジェクト名を含むため、プロジェクトヘッダーは送信しません。ScreenRig-Projectを送信する場合はトークンのプロジェクトと一致する必要があります。API認証は環境変数で提供してください。詳細はAPI認証を参照。
curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
--header "Authorization: Bearer $SCREENRIG_TOKEN" \
--header "Content-Type: application/json" \
--data '{"document":{"left":null,"right":null,"middle":null}}'