提供された平日料金ウィンドウは現在のエネルギー価格、次の変更、今日の帯を決定します。日付付きオーバーライドは終日例外をカバーし、夜間をまたぐウィンドウは開始曜日に従います。日次タイムラインは夏時間変更を通じてローカルクロックを追跡し、未カバー期間は不明のままです。
ライブカード
カテゴリ: ファイナンス。タグ: 価格と料金、スケジュール、オフィスと職場。
レイアウト
この全画面カードはランドスケープまたはポートレートで画面全体を埋め、コーナー、チップ、ストリップとして配置されません。
レイアウト：フル。フォーム：ランドスケープ、ポートレート。
データとプライバシー
このカードは設定されたプロパティとライブカードデータを使用します。
料金表のみ。メーターや顧客の身元情報は不要です。
プロパティ
テーマ、背景、アクセント、位置については共通プロパティを参照してください。
カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。
静的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
currency | string | "CAD" | パターン："^[A-Z]{3}$" | |
priceDecimals | integer | 3 | 最小値：0；最大値：6 | |
perPage | integer | 6 | 最小値：2；最大値：8 | |
pageSeconds | integer | 12 | 最小値：8；最大値：120 | |
followCurrent | boolean | true | ||
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})?$" | メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。 |
動的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
title | string | "Electricity rates" | maxLength：100 | |
provider | string | "" | maxLength：120 | |
footnote | string | "" | maxLength：240 | |
updatedAt | string | "" | maxLength：64 | |
bands | array | [] | maxItems：24 | 最初に一致した間隔が勝ちます。夜間のウィンドウは開始曜日を使用します。開始と終了が同じ場合は翌日の現地時間までの期間です。カバーされていない時間は不明のままです。 |
bands[].id | string | minLength：1；maxLength：48；必須 | ||
bands[].label | string | minLength：1；maxLength：60；必須 | ||
bands[].days | array | minItems：1；maxItems：7；必須 | ||
bands[].start | string | パターン："^([01][0-9]|2[0-3]):[0-5][0-9]$"；必須 | ||
bands[].end | string | パターン："^([01][0-9]|2[0-3]):[0-5][0-9]$"；必須 | ||
bands[].rateUnits | integer | 最小値：0；最大値：100000000；必須 | 通貨単位あたりの価格kWh、10^priceDecimalsでスケール。 | |
bands[].kind | string | "custom" | "off-peak", "shoulder", "peak", "custom" | |
bands[].note | string | "" | maxLength：140 | |
dayOverrides | array | [] | maxItems：120 | 各明示的なローカル日付は、参照されたバンド価格を終日使用し、週次ウィンドウを上書きします。最初の日付エントリが優先されます。未知のバンドIDは不明な価格を示します。 |
dayOverrides[].date | string | パターン："^[1-9][0-9]{3}-[0-9]{2}-[0-9]{2}$"；必須 | ||
dayOverrides[].bandId | string | minLength：1；maxLength：48；必須 |
キャンバス例
静的プロパティを params.json として保存し、カードを作成します。結果にはその crd_ ID が含まれます。
{
"theme": "neomustard"
}screenrig card create --type tou-rates --major 1 --file params.jsonこのアイテムをプレイリストページのprimitivesに追加し、サンプルの ID をその ID に置き換えます。プレイリストを公開してスクリーンに割り当ててください。
{
"id": "tou-rates",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}ライブデータを書き込む
カードを作成した後にドキュメントを書き込み、画面を再公開せずに更新するには置き換えます。カードは書き込みのたびに動的プロパティと照合し、受け付けないドキュメントは拒否します。プレイリストと同じプロジェクトを使用してください。
ドキュメントを card-data.json として保存します。CLIはラッパーなしでドキュメント自体を読み取ります。
{
"title": "Electricity rates",
"provider": "",
"footnote": "",
"updatedAt": "",
"bands": [],
"dayOverrides": []
}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":{"title":"Electricity rates","provider":"","footnote":"","updatedAt":"","bands":[],"dayOverrides":[]}}'