呼び出しは指定された条件と設定された制限に従います。オフィスのオーバーライドで屋内または屋外の休憩をメモ付きで設定できます。4つのチェックはその下に表示されたままです。
ライブカード
カテゴリ:学校。タグ:学校とキャンパス、天気と環境。
レイアウト
この全画面カードはランドスケープまたはポートレートで画面全体を埋め、コーナー、チップ、ストリップとして配置されません。
レイアウト:フル。フォーム:ランドスケープ、ポートレート。
データとプライバシー
フィード:screenrig.recess/v1。
フィードドキュメントは情報源の帰属を含みます。プレーヤーがカードにフィードを提供します。
プロパティ
テーマ、背景、アクセント、位置については共通プロパティを参照してください。
カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。
静的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
title | string | "Recess call" | maxLength:40 | |
school | string | "" | maxLength:60 | タイトルの横に表示されます。フィードの場所名が空の場合に表示されます。 |
units | string | "metric" | "metric", "imperial" | 画面に温度、風、雨を表示。以下の制限はメートル法のままです。 |
minFeelsLikeC | number | -15 | 最小値:-50;最大値:10 | 休憩はこの気温以下(風冷込み、摂氏)で屋内に移動します。 |
maxFeelsLikeC | number | 32 | 最小値:20;最大値:55 | 休憩はこの気温以上(摂氏)で屋内に移動します。 |
maxWindKph | number | 50 | 最小値:15;最大値:120 | 休憩はこの風速またはその1.4倍の突風時に屋内に移動します(km/h)。 |
maxAqi | integer | 100 | 最小値:50;最大値:300 | 休憩は米国の大気質指数がこれを超えた場合に屋内に移動します。 |
staleMinutes | integer | 90 | 最小値:10;最大値:1440 | |
hour12 | boolean | false | ||
timeZone | 文字列、null | 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})?$" | メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。 |
動的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
current | オブジェクト、null | null | additionalProperties:false | 現在の条件、データストアから。フィード(screenrig.recess/v1)がある場合は優先されます。 |
current.temperatureC | number | 最小値:-80;最大値:60 | ||
current.apparentC | number | 最小値:-90;最大値:70 | 体感温度。これがない場合、カードは温度と風速から風冷効果を計算します。 | |
current.windKph | number | 最小値:0;最大値:400 | ||
current.gustKph | number | 最小値:0;最大値:500 | ||
current.condition | string | "clear", "partly-cloudy", "cloudy", "fog", "drizzle", "rain", "heavy-rain", "snow", "sleet", "thunderstorm", "wind" | ||
current.precipitationMm | number | 最小値:0;最大値:500 | 過去1時間の雨または溶けた雪。 | |
aqi | 数値、null | null | 最小値:0;最大値:1000 | データストアからの米国大気質指数。 |
observedAt | string | "" | maxLength:32 | 条件が読み込まれたとき、ISO 8601(データストアのみ;フィードはobservedAtを含む)。 |
outlook | array | [] | minItems:0;maxItems:12 | データストアからの次の時間。フィードの見通しがある場合は優先。 |
outlook[].at | string | maxLength:32;必須 | ||
outlook[].apparentC | number | 最小値:-90;最大値:70 | ||
outlook[].temperatureC | number | 最小値:-80;最大値:60 | ||
outlook[].windKph | number | 最小値:0;最大値:400 | ||
outlook[].condition | string | "clear", "partly-cloudy", "cloudy", "fog", "drizzle", "rain", "heavy-rain", "snow", "sleet", "thunderstorm", "wind" | ||
outlook[].precipitationPct | number | 最小値:0;最大値:100 | ||
override | string | "auto" | "auto", "outdoor", "indoor" | オフィスの呼び出し。autoは条件に従います。 |
note | string | "" | maxLength:80 | なぜオフィスが通話したのか。オーバーライドが自動でない場合、判決の下に表示されます。 |
キャンバス例
静的プロパティを params.json として保存し、カードを作成します。結果にはその crd_ ID が含まれます。
{
"theme": "neomustard"
}
screenrig card create --type recess-call --major 1 --file params.json
このアイテムをプレイリストページのprimitivesに追加し、サンプルの ID をその ID に置き換えます。プレイリストを公開してスクリーンに割り当ててください。
{
"id": "recess-call",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
ライブデータを書き込む
カードを作成した後にドキュメントを書き込み、画面を再公開せずに更新するには置き換えます。カードは書き込みのたびに動的プロパティと照合し、受け付けないドキュメントは拒否します。プレイリストと同じプロジェクトを使用してください。
ドキュメントを card-data.json として保存します。CLIはラッパーなしでドキュメント自体を読み取ります。
{
"current": null,
"aqi": null,
"observedAt": "",
"outlook": [],
"override": "auto",
"note": ""
}
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":{"current":null,"aqi":null,"observedAt":"","outlook":[],"override":"auto","note":""}}'