提供されたスコア付きターゲットシートは部門順位、Xカウント、パーセンテージ、特徴的なカードの記録されたヒット位置と共に表示されます。順位は画面の高さを共有し、少数のカードは大きく、多くの部門は特徴的なカードに続くグループでページングし、すべての部門は上位行を保持します。25頭を超えるシートはすべてのブルを1つのグリッドに描き、Primetimeでは最大25頭のタイルをページングし、すべての記録ヒット、スコア、行合計を保持します。Primetime中は見出しと順位がアニメーションし、通常スコアはシアンで表示され、新しいカードはブラケットで示され、完了したパーフェクトシートは控えめな紙吹雪で祝われます。動きを減らすと落ち着いた静止画になります。
ライブカード
カテゴリ:スポーツ。タグ:スコアボード、リーダーボードと順位、個人スポーツ。
レイアウト
この全画面カードはランドスケープまたはポートレートで画面全体を埋め、コーナー、チップ、ストリップとして配置されません。
レイアウト:フル。フォーム:ランドスケープ、ポートレート。
データとプライバシー
このカードは設定されたプロパティとライブカードデータを使用します。
プロパティ
テーマ、背景、アクセント、位置については共通プロパティを参照してください。
カードの作成時に、静的プロパティをカードのparamsに設定します。データドキュメントは動的プロパティのみを保持します。ネストされた行は親プロパティの内容を説明します。
静的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
title | string | "Match standings" | maxLength:60 | 試合名の上のラベル。データに試合名がない場合は見出し自体です。 |
subtitle | string | "" | maxLength:120 | 見出しの下の一行、試合日と射手数の前。 |
target | object | additionalProperties:false | すべてのカードが射撃されるターゲットシートです。 | |
target.bulls | integer | 25 | 最小値:1;最大値:100 | 記録ブルを1枚のシートにまとめます。 |
target.rows | integer | 5 | 最小値:1;最大値:20 | 雄牛が座る行。左から右、上から下に読みます。 |
target.rings | array | [10,9,8,7,6,5] | minItems:1;maxItems:12 | 内側のリングから外側に向かってスコアリングリングの値。最初はブルの最高スコアです。 |
target.xRing | boolean | true | 内側のリング内に X リングがあります。X の数が同点を決めます。 | |
target.radii | array | [] | maxItems:12 | 内側のリングから外側に向かうリング半径。リング値ごとに1つ、任意の単位(カードは外側のリングを1にスケーリング)。空欄はリングを均等に配置。 |
target.xRadius | number | 0 | 最小値:0 | Xリングの半径は半径単位で、半径が空の場合は外リングの割合で示されます。0は内リングの半分です。 |
target.black | integer | 4 | 最小値:0;最大値:12 | 狙いの黒が覆う内側から外側へのリング数。 |
target.shotSize | number | 0.22 | 最小値:0;最大値:1 | ショットホールの直径を外側のスコアリングリングの半径で割った比率。 |
showPercent | boolean | true | 各カードのスコアをシートの最大値に対するパーセンテージで表示します。 | |
ranking | string | "best" | "best", "every" | ベストは各ディビジョンで射手を一度だけ、最高のカードでランク付け。エブリはすべてのカードをランク付け。 |
rotateSeconds | integer | 12 | 最小値:0;最大値:600 | 壁時計の回転で各ランクカードが表示される秒数。0は最新のカードを保持します。 |
freshMinutes | integer | 3 | 最小値:0;最大値:60 | 最近送信されたカードは新しいとみなされ、ローテーションより前に表示され、「Just in」とマークされます。0は無効にします。 |
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})?$" | メインとセカンダリのテキスト色を上書きします。アクセントと意味的な状態色はそのまま維持されます。 |
動的プロパティ
| 名前 | タイプ | デフォルト | 値と制限 | 説明 |
|---|---|---|---|---|
match | object | additionalProperties:false | 試合。 | |
match.name | string | "" | maxLength:60 | |
match.date | string | "" | maxLength:10 | YYYY-MM-DD。 |
divisions | array | [] | maxItems:8 | 表示順の区分。エントリが名前を付けている区分でこのリストにないものは後に追加されます。 |
divisions[].id | string | minLength:1;maxLength:40;必須 | ||
divisions[].name | string | maxLength:40;必須 | ||
entries | array | [] | maxItems:200 | シートショットごとに1枚のスコアカード。スコアは権威的です:カードは合計と順位を示し、各ヒットの位置を描きますが、ヒットから再スコアはしません。 |
entries[].id | string | minLength:1;maxLength:60;必須 | 安定かつ一意です:エージェントはカードを修正するときに同じIDを書き換えます。 | |
entries[].shooter | string | minLength:1;maxLength:40;必須 | 射手の表示名。同じ名前(大文字小文字無視)のカードは一人の射手。 | |
entries[].division | string | maxLength:40 | divisions[].id。 | |
entries[].label | string | maxLength:80 | このカードの内容例:25m・シート2。 | |
entries[].submittedAt | string | maxLength:40 | カードがスコア付けされたISO 8601時刻。新鮮さを示し、同点の場合は早い方が勝ちます。 | |
entries[].bulls | array | maxItems:100;必須 | シート順で一レコードにつき一つのブル。target.bullsを超えるブルは無視され、欠落は未採点とみなされます。 | |
entries[].bulls[].score | 数値、null | 最小値:0;最大値:100;必須 | ブルのスコア。null はまだスコアなしを示します。 | |
entries[].bulls[].x | boolean | ショットはXリング内(スコアは内側のリングの値)。 | ||
entries[].bulls[].hits | array | maxItems:10 | ショットセンターはブルの外側得点リング半径の単位で示します:0,0は中心、+xは右、+yは上。 | |
entries[].bulls[].hits[].dx | number | 最小値:-2;最大値:2;必須 | ||
entries[].bulls[].hits[].dy | number | 最小値:-2;最大値:2;必須 | ||
entries[].photo | string | maxLength:512 | カード写真のホスト解決済みメディアURL。 | |
featured | string | "" | maxLength:60 | 注目を維持するためのエントリーID。空の場合は新しいカード、そうでなければローテーションします。 |
キャンバス例
静的プロパティを params.json として保存し、カードを作成します。結果にはその crd_ ID が含まれます。
{
"theme": "neomustard"
}
screenrig card create --type shooting-match --major 1 --file params.json
このアイテムをプレイリストページのprimitivesに追加し、サンプルの ID をその ID に置き換えます。プレイリストを公開してスクリーンに割り当ててください。
{
"id": "shooting-match",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
ライブデータを書き込む
カードを作成した後にドキュメントを書き込み、画面を再公開せずに更新するには置き換えます。カードは書き込みのたびに動的プロパティと照合し、受け付けないドキュメントは拒否します。プレイリストと同じプロジェクトを使用してください。
ドキュメントを card-data.json として保存します。CLIはラッパーなしでドキュメント自体を読み取ります。
{
"match": {},
"divisions": [],
"entries": [],
"featured": ""
}
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":{"match":{},"divisions":[],"entries":[],"featured":""}}'