カレンダーの今後の日々は、現在の予定、次の予定、アジェンダを表示し、行はフルサイズで切り詰められ、縮小されません。画面全体に表示され、任意の長方形にフィットし、中央に配置されたり、隅に収まったり、隅の一行として表示されたり、端に沿って帯状に伸びたりします。全画面のアジェンダ、利用可能または使用中を表示し後の予約を示す部屋のドアサイン、または週の7列を選択します。表示する日数、最大アジェンダ行数、時計の12時間制、24時間制または軍用時間の設定、場所の表示有無、イベントが開始中または開始直前までカードを非表示にするかを設定します。
ライブカード
カテゴリ: イベント。タグ: スケジュール、イベントと会場、ロビーと受付、オフィスと職場、学校とキャンパス。
レイアウト
このコアカードはすべてのレイアウトに適合します：全画面、中央、ワイド、コーナー、チップ、ストリップ、または任意の自由な長方形。
レイアウト：フル、フリー、センター、ワイド、コーナー、チップ、ストリップ。フォーム：ランドスケープ、ポートレート。
データとプライバシー
フィード：screenrig.events/v1。
フィードドキュメントは情報源の帰属を含みます。プレーヤーがカードにフィードを提供します。
プロパティ
テーマ、背景、アクセント、位置については共通プロパティを参照してください。
カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。
静的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
title | string | "" | maxLength：60 | 空の場合はカレンダーの名前を使用します。 |
mode | string | "agenda" | "agenda", "next", "week" | 全画面構成：アジェンダ（現在、次、アジェンダ）、次（部屋のドアサイン：利用可能または使用中、その後の予定と当日の後の予約）、週（7日間の列）。センター、コーナー、チップ、ストリップは常に現在または次を表示します。 |
days | integer | 7 | 最小値：1；最大値：14 | |
maxEvents | integer | 8 | 最小値：1；最大値：20 | 最大この数のアジェンダ行；行は部屋に合わせて切り詰められますが、縮小はされません。 |
hourCycle | string | "24" | "12", "24", "military" | 12時間制: 午後2時05分。24時間制: 14:05。軍用時間: 1405、区切りなしの4桁（接尾辞がある場合は HRS）。 |
showLocation | boolean | true | ||
timeZone | 文字列、null | null | IANAゾーン。nullの場合はスクリーンのゾーンを使用。 | |
presence | string | "always" | "always", "active" | アクティブ：イベントが開始中かleadMinutes以内に開始するまでカードは表示されません。 |
leadMinutes | integer | 15 | 最小値：1；最大値：240 | プレゼンスがアクティブの場合、イベント開始の何分前にカードが表示されるか。 |
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})?$" | メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。 |
動的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
events | 配列、null | null | maxItems：200 | エージェント提供のカレンダーの予定。nullはホストフィードを使用し、空の配列は予定をクリアします。書き込み前に繰り返しを展開してください。 |
キャンバス例
静的プロパティを params.json として保存し、カードを作成します。結果にはその crd_ ID が含まれます。
{
"theme": "neomustard"
}screenrig card create --type events --major 1 --file params.jsonこのアイテムをプレイリストページのprimitivesに追加し、サンプルの ID をその ID に置き換えます。プレイリストを公開してスクリーンに割り当ててください。
{
"id": "events",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}ライブデータを書き込む
カードを作成した後にドキュメントを書き込み、画面を再公開せずに更新するには置き換えます。カードは書き込みのたびに動的プロパティと照合し、受け付けないドキュメントは拒否します。プレイリストと同じプロジェクトを使用してください。
ドキュメントを card-data.json として保存します。CLIはラッパーなしでドキュメント自体を読み取ります。
{
"events": 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":{"events":null}}'