行にアイテム、列にサイズを配置し、価格は交差する位置に置きます。コーヒー、タップ、ワイン、薬局の重量、燃料に同じクリアグリッドを使用し、アドオンも併せて表示します。
ライブカード
カテゴリ: 飲食。タグ: レストランとカフェ、バーとパブ、店舗、価格と料金。
レイアウト
この全画面カードはランドスケープまたはポートレートで画面全体を埋め、コーナー、チップ、ストリップとして配置されません。
レイアウト:フル。フォーム:ランドスケープ、ポートレート。
データとプライバシー
このカードは設定されたプロパティとライブカードデータを使用します。
プロパティ
テーマ、背景、アクセント、位置については共通プロパティを参照してください。
カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。
静的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
title | string | "Coffee" | maxLength:40 | |
metaLabel | string | "" | maxLength:16 | 追加列のヘッダー、例:ABV。 |
glyph | string | "cup" | "none", "cup", "glass" | 各サイズの上に成長するカップまたはグラス。 |
currency | string | "$" | maxLength:3 | |
decimals | 数値、文字列 | "auto" | "auto", 0, 1, 2, 3 | 自動はすべての価格が整数の場合に整数を使用します。 |
perPage | integer | 0 | 最小値:0;最大値:20 | 1ページあたりの行数。0は部屋の設定から自動設定されます。 |
pageSeconds | number | 10 | 最小値:5;最大値:120 | |
footnote | string | "" | maxLength:120 | |
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})?$" | メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。 |
動的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
columns | array | ["Small","Medium","Large"] | minItems:1;maxItems:6 | 上部のサイズ:S/M/L、12/16/20オンス、パイント/ハーフ、グラス/ボトル、1g/3.5g/28g、現金/クレジット。 |
sections | array | [{"name":"Espresso bar","items":[{"name":"Espresso","prices":[3.25,3.75,null],"note":"Double shot"},{"name":"Americano","prices":[3.5,4.0,4.5]},{"name":"Flat white","prices":[4.5,5.0,5.5],"note":"Whole or oat milk","badge":"House"},{"name":"Latte","prices":[4.75,5.25,5.75],"note":"Vanilla, caramel or maple"}]},{"name":"Cold","items":[{"name":"Iced latte","prices":[5.0,5.5,6.0]},{"name":"Cold brew","prices":[4.5,5.0,5.5],"note":"Steeped 18 hours"}]}] | maxItems:12 | 側面にアイテムのグループ。グループ名が最初の行の見出し。 |
sections[].name | string | maxLength:80 | ||
sections[].items | array | maxItems:40;必須 | ||
sections[].items[].name | string | minLength:1;maxLength:80;必須 | ||
sections[].items[].note | string | maxLength:160 | 名前の下の一行。 | |
sections[].items[].meta | string | maxLength:24 | 追加の列:ABV、THC、原産地。 | |
sections[].items[].badge | string | maxLength:16 | ||
sections[].items[].prices | array | maxItems:6 | 列ごとに一つの価格。提供されていないサイズは空欄。 | |
sections[].items[].soldOut | boolean | false | ||
addOns | array | [{"name":"Oat milk","price":0.7},{"name":"Extra shot","price":1},{"name":"Syrup","price":0.5}] | maxItems:8 | 表の下に連続した追加項目。 |
addOns[].name | string | maxLength:40;必須 | ||
addOns[].price | 数値、null | |||
featuredItem | string | "" | maxLength:80 | プライムタイムに表示する正確な行名。空の場合は最初に利用可能なバッジ付き行を使用。 |
featuredColumn | integer | 2 | 最小値:1;最大値:6 | Primetimeの1始まりの注目サイズ列。 |
updatedAt | string | "" | maxLength:40 | 同期された価格変更強調のISO時刻。 |
キャンバス例
静的プロパティを params.json として保存し、カードを作成します。結果にはその crd_ ID が含まれます。
{
"theme": "neomustard"
}
screenrig card create --type price-matrix --major 1 --file params.json
このアイテムをプレイリストページのprimitivesに追加し、サンプルの ID をその ID に置き換えます。プレイリストを公開してスクリーンに割り当ててください。
{
"id": "price-matrix",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
ライブデータを書き込む
カードを作成した後にドキュメントを書き込み、画面を再公開せずに更新するには置き換えます。カードは書き込みのたびに動的プロパティと照合し、受け付けないドキュメントは拒否します。プレイリストと同じプロジェクトを使用してください。
ドキュメントを card-data.json として保存します。CLIはラッパーなしでドキュメント自体を読み取ります。
{
"columns": [
"Small",
"Medium",
"Large"
],
"sections": [
{
"name": "Espresso bar",
"items": [
{
"name": "Espresso",
"prices": [
3.25,
3.75,
null
],
"note": "Double shot"
},
{
"name": "Americano",
"prices": [
3.5,
4.0,
4.5
]
},
{
"name": "Flat white",
"prices": [
4.5,
5.0,
5.5
],
"note": "Whole or oat milk",
"badge": "House"
},
{
"name": "Latte",
"prices": [
4.75,
5.25,
5.75
],
"note": "Vanilla, caramel or maple"
}
]
},
{
"name": "Cold",
"items": [
{
"name": "Iced latte",
"prices": [
5.0,
5.5,
6.0
]
},
{
"name": "Cold brew",
"prices": [
4.5,
5.0,
5.5
],
"note": "Steeped 18 hours"
}
]
}
],
"addOns": [
{
"name": "Oat milk",
"price": 0.7
},
{
"name": "Extra shot",
"price": 1
},
{
"name": "Syrup",
"price": 0.5
}
],
"featuredItem": "",
"featuredColumn": 2,
"updatedAt": ""
}
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":{"columns":["Small","Medium","Large"],"sections":[{"name":"Espresso bar","items":[{"name":"Espresso","prices":[3.25,3.75,null],"note":"Double shot"},{"name":"Americano","prices":[3.5,4.0,4.5]},{"name":"Flat white","prices":[4.5,5.0,5.5],"note":"Whole or oat milk","badge":"House"},{"name":"Latte","prices":[4.75,5.25,5.75],"note":"Vanilla, caramel or maple"}]},{"name":"Cold","items":[{"name":"Iced latte","prices":[5.0,5.5,6.0]},{"name":"Cold brew","prices":[4.5,5.0,5.5],"note":"Steeped 18 hours"}]}],"addOns":[{"name":"Oat milk","price":0.7},{"name":"Extra shot","price":1},{"name":"Syrup","price":0.5}],"featuredItem":"","featuredColumn":2,"updatedAt":""}}'