フッターカード

画面の下端に沿ったバーです。左右にスロットがあり、メッセージは静止、スクロール、またはページ送りで表示されます。

画面の幅いっぱいで下端にぴったりのバーです。画面に必要な小さな情報をまとめます。左右のスロットはそれぞれ単語、タグ、時計、現在の天気、アイコン、日付、ステータスドット、ロゴ、カウントダウン、数字、現在のページ、または静かなアラート(温かくまたは赤く変わる)を表示します。中央は静止メッセージ、長い場合はスクロール、最大8ページのページ送りが可能です。項目とメッセージは設定・変更でき、バーはすべての画面で位置を保持します。

ライブカード

このカードはブラウザでプレーヤーと同じコードで描画され、サンプルデータを使用します。

カテゴリ: メッセージ。タグ: ロビーと受付、オフィスと職場、店舗。

レイアウト

このバーカードはフッターとして配置されます:全幅のバーで高さ80、下端にぴったり合わせます。レイアウトやアンカーは使用しません。

レイアウト:フッター。フォーム:ストリップ。

カードレイアウト、テーマ、公開。カードを閲覧。

データとプライバシー

フィード:screenrig.weather/v1。

フィードドキュメントは情報源の帰属を含みます。プレーヤーがカードにフィードを提供します。

天気の帰属:フィードドキュメントに記載されているWeatherbitによる天気データ。

プロパティ

テーマ、背景、アクセントについては共通プロパティを参照してください。バーカードにはlayoutやanchorのプロパティはなく、常にフッターとして配置されます。

カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。

静的プロパティ

名前タイプデフォルト値と制限説明
locationオブジェクト、nullnulladditionalProperties:false天気情報の取得場所。指定なしは天気データなしで空欄。
location.namestringmaxLength:40;必須
location.latitudenumber最小値:-90;最大値:90;必須
location.longitudenumber最小値:-180;最大値:180;必須
timeZone文字列、nullnullmaxLength:64時計、日付、カウントダウン項目のIANAゾーン。nullの場合はスクリーンのゾーンを使用。
backgroundColor文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"カードの背景とプレートをフラットなCSS順序の色で上書きします。#RRGGBBAAは不透明度を指定します。background noneが優先されます。
textColor文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。

動的プロパティ

名前タイプデフォルト値と制限説明
leftオブジェクト、nullnulladditionalProperties: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.kindstring"text"、"tag"、"clock"、"weather"、"icon"、"date"、"status"、"logo"、"countdown"、"number"、"page"、"alert";必須スロットが表示するもの。
left.textstring""maxLength:60テキスト、タグ、ステータスまたはアラート項目の単語です。
left.sizestring"small""small", "medium", "large"テキスト、タグ、ステータス、アラート項目の文字サイズ(1080p で 24、32、44 px。小サイズのテキストは 2 行、ほかは 1 行)、日付の文字サイズ(32、44、56 px、1 行)、時計、天気、カウントダウン、ページ、アイコン項目の数字のサイズ。
left.color文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"#RRGGBB または #RRGGBBAA のテキストまたはアイコンの色。null の場合はテーマのテキスト色を使用します。
left.fill文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"タグの角丸長方形:#RRGGBB または #RRGGBBAA。nullはテキスト色の半透明(Clearテーマではアウトライン)。
left.iconnull、文字列nullnull, "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.tonestring"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.pulsebooleanfalse1秒に1回点滅するステータスドット。
left.hourCyclestring"auto""auto", "12", "24"時計の時間:自動はPlayerのロケールに従います(通常12時間制の場所では2:05 PM、それ以外は14:05);12はどのロケールでも2:05 PM、24は14:05です。
left.timeZone文字列、nullnullmaxLength:64時計、日付、カウントダウンのIANAゾーン。nullの場合はバーのゾーンを使用し、それ以外はスクリーンのゾーン。
left.dateStylestring"short""short", "long"日付アイテム:短縮はWed 21 Oct、長い形式はWednesday 21 October;米国ロケールでは月が先に来ます(Wed Oct 21、Wednesday, October 21)。曜日と月名は英語;長い日付が収まらない場合は短縮形式に切り替わります。
left.at文字列、nullnullmaxLength:40カウントダウンのISO 8601瞬間。オフセットなしは項目のゾーンの壁時計時間。
left.labelstring""maxLength:24数値のラベルは値の上に表示します。カウントダウンのラベルは、カウント中の数字と、時刻に達したあとに表示される言葉の上に表示します(全体が収まらない場合は省略)。
left.valuestring""maxLength:16数値の値を、読みやすい形式で表示します(例:1,284 または 98%)。
left.mediastring""maxLength:200ロゴアイテムの画像:240×70に収まるプロジェクトのメディア参照(media:<id>)。
left.pageinteger1最小値:1;最大値:999ページ項目の現在のページ番号(1から始まる)。
left.ofinteger1最小値:1;最大値:999ページ項目の総ページ数。
left.stylestring"numbers""dots", "numbers"ページ項目を 3 / 8 またはドットで表示します(ドットは最大12ページまで)。
left.activebooleanfalseアラート項目:false は静かなチェックマーク、true は重大度の色と文言を表示します。
left.severitystring"warm""warm", "danger"アクティブなアラート項目の色:ウォッチはウォーム、アラームは危険色です。
left.unitstring"auto""auto", "c", "f"天気アイテムの温度スケール:autoはPlayerのロケール地域が使用する場合は華氏(US PR GU VI AS MP BS BZ KY PW LR)、それ以外は摂氏。cとfはすべてのロケールで摂氏または華氏を強制。
rightオブジェクト、nullnulladditionalProperties:false右スロット:幅 250 px(内側は 240 x 70)、コンテンツは末尾側に寄せ、スクリーンの端から 24 px 離します。項目は左スロットと同じで、ロケールのルールも同じです。
right.kindstring"text"、"tag"、"clock"、"weather"、"icon"、"date"、"status"、"logo"、"countdown"、"number"、"page"、"alert";必須スロットが表示するもの。
right.textstring""maxLength:60テキスト、タグ、ステータスまたはアラート項目の単語です。
right.sizestring"small""small", "medium", "large"テキスト、タグ、ステータス、アラート項目の文字サイズ(1080p で 24、32、44 px。小サイズのテキストは 2 行、ほかは 1 行)、日付の文字サイズ(32、44、56 px、1 行)、時計、天気、カウントダウン、ページ、アイコン項目の数字のサイズ。
right.color文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"#RRGGBB または #RRGGBBAA のテキストまたはアイコンの色。null の場合はテーマのテキスト色を使用します。
right.fill文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"タグの角丸長方形:#RRGGBB または #RRGGBBAA。nullはテキスト色の半透明(Clearテーマではアウトライン)。
right.iconnull、文字列nullnull, "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.tonestring"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.pulsebooleanfalse1秒に1回点滅するステータスドット。
right.hourCyclestring"auto""auto", "12", "24"時計の時間:自動はPlayerのロケールに従います(通常12時間制の場所では2:05 PM、それ以外は14:05);12はどのロケールでも2:05 PM、24は14:05です。
right.timeZone文字列、nullnullmaxLength:64時計、日付、カウントダウンのIANAゾーン。nullの場合はバーのゾーンを使用し、それ以外はスクリーンのゾーン。
right.dateStylestring"short""short", "long"日付アイテム:短縮はWed 21 Oct、長い形式はWednesday 21 October;米国ロケールでは月が先に来ます(Wed Oct 21、Wednesday, October 21)。曜日と月名は英語;長い日付が収まらない場合は短縮形式に切り替わります。
right.at文字列、nullnullmaxLength:40カウントダウンのISO 8601瞬間。オフセットなしは項目のゾーンの壁時計時間。
right.labelstring""maxLength:24数値のラベルは値の上に表示します。カウントダウンのラベルは、カウント中の数字と、時刻に達したあとに表示される言葉の上に表示します(全体が収まらない場合は省略)。
right.valuestring""maxLength:16数値の値を、読みやすい形式で表示します(例:1,284 または 98%)。
right.mediastring""maxLength:200ロゴアイテムの画像:240×70に収まるプロジェクトのメディア参照(media:<id>)。
right.pageinteger1最小値:1;最大値:999ページ項目の現在のページ番号(1から始まる)。
right.ofinteger1最小値:1;最大値:999ページ項目の総ページ数。
right.stylestring"numbers""dots", "numbers"ページ項目を 3 / 8 またはドットで表示します(ドットは最大12ページまで)。
right.activebooleanfalseアラート項目:false は静かなチェックマーク、true は重大度の色と文言を表示します。
right.severitystring"warm""warm", "danger"アクティブなアラート項目の色:ウォッチはウォーム、アラームは危険色です。
right.unitstring"auto""auto", "c", "f"天気アイテムの温度スケール:autoはPlayerのロケール地域が使用する場合は華氏(US PR GU VI AS MP BS BZ KY PW LR)、それ以外は摂氏。cとfはすべてのロケールで摂氏または華氏を強制。
middleオブジェクト、nullnulladditionalProperties:falseスロット間のメッセージ。テキスト(またはページ)がない場合、中央は空白のままでスペースを保持します。幅が100px未満になる場合は非表示。
middle.textstring""maxLength:160静的またはクロールするメッセージの単語です。
middle.sizestring"small""small", "medium", "large"1080p で、2 行までは 28 px、1 行では 38 px または 52 px。
middle.alignstring"center""start", "center", "end"単語の中央配置。
middle.color文字列、nullnullパターン:"^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$"#RRGGBB または #RRGGBBAA のテキスト色。null の場合はテーマのテキスト色を使用します。
middle.modestring"static""static", "crawl", "pages"static は、収まりきらないメッセージを文単位で 1 つずつ順に表示します。crawl は動きが有効な間、メッセージを中央に流します(収まるときは静止し、静止状態や動きを減らす設定では文単位で表示します)。pages は pages の文字列を 1 つずつ順に表示します。
middle.pagesarray[]maxItems:8ページモードのメッセージを順に表示。
middle.pageSecondsinteger8最小値: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}}'