Gift Rank（ギフトカウンター）

Gift Rank はリアルタイムのギフト投票進捗ウィジェットです。ギフトのクラウドファンディング目標追跡、ギフトチャレンジ、複数ギフトの進捗比較など、「視聴者にギフトの送信進捗を直感的に見せる」インタラクションに適しています。

レイアウト

Gift Rank の画面は以下の2つのエリアで構成されています：

左側がプレビューエリアで、設定の変更は即座にプレビューに反映されます。

右側が設定エリアで、タイマー設定、表示設定、ギフト管理の3つのセクションがあります。

設定項目	用途	変更のタイミング	注意事項
`オフ`	カウントダウンなし	時間制限が不要な場合（デフォルト）	-
`10min`	固定10分カウントダウン	中短距離のインタラクション	-
`30min`	固定30分カウントダウン	長時間のインタラクション	-
`カスタム`	秒数をカスタム入力	非標準の時間が必要な場合	最小 `10` 秒

カウントダウンと操作の関係

カウントダウンはカウンターが「実行中」の状態でのみ減算されます。一時停止またはリセットすると、カウントダウンも一時停止または初期値に戻ります。

カウントダウンがゼロになると、カウンターは自動的に終了し、累積を停止します。

あるギフトのカウントがその目標値に達した際、カウンターが自動的に実行する動作を設定します。

オプション	意味
`カウント停止`	目標達成後、そのギフトのカウントの累積を停止
`カウント継続`	目標達成後も累積を継続、カウントは目標を超えることが可能
`カウンターをリセット`	目標達成後、カウンターをリセット
`目標増加`	目標達成後、自動的に目標値を引き上げてチャレンジを延長
`目標を倍増`	目標達成後、自動的に目標値を2倍に
`非表示`	目標達成後、ウィジェットでそのギフトを非表示

実行中は変更できません

カウンターが実行中の状態ではこの設定を変更できません。調整するには先に リセット してください。

設定項目	用途	変更のタイミング	注意事項
`進捗表示`	プログレスバーのテキスト形式を選択	-	3つのモード：`数値+割合`（例：50/100（50%））、`数値のみ`（例：50/100）、`割合のみ`（例：50%）
`ギフト名を表示`	ウィジェットに各ギフトのカスタム名を表示	ギフトが多く、視聴者が区別する必要がある場合	オフにするとコンパクトレイアウトに切り替わり、スペースが節約されます
`ギフト価値を表示`	ウィジェットにギフトのダイヤモンド価値を表示	-	-
`貢献ランキングを表示`	ウィジェット下部に合計進捗と貢献上位3名のアバターを表示	視聴者の競争を促したい場合	-

設定項目	用途	変更のタイミング	注意事項
`ギフトアイコン`	クリックしてその行のギフトを変更	-	カウントデータがあるギフトの変更には確認が必要です
`ギフト名`	ギフトのカスタム表示名を設定（`ギフト名を表示`がオンの時のみ表示）	-	フォーカスが外れた時に自動保存
`現在 / 目標`	このギフトの現在の累積値と目標値を表示	-	クリックで手動調整可能（下記参照）
`表示 / 非表示`	このギフトをウィジェットに表示するかどうか	一時的にギフトをウィジェットに表示したくない場合	非表示にしてもカウントは継続します
`削除`	このギフト行を削除	-	削除前に確認ダイアログが表示されます
`ドラッグで並べ替え`	左側の `::` ハンドルをドラッグしてウィジェット内の表示順序を調整	-	同時に1つのドラッグ操作のみ可能
`ギフトを追加`	新しいギフト行を追加	-	最大 `8` つのギフト。同じギフトの重複選択はできません

ギフトは最大8つ

各カウンターには最大8つのギフトを設定できます。より多くのギフトを追跡したい場合は、複数のプリセットに分けて使用してください。

操作	意味	説明
`開始`	カウンターを起動し、ギフトデータの受信を開始	カウントダウンが有効な場合、同時に開始
`一時停止`	カウンターを一時停止し、ギフト受信とカウントダウンを停止	既存のカウントデータは失われません
`リセット`	すべてのギフトの現在値をゼロに	リセット前に確認ダイアログが表示されます

配信ツールでの操作

Copy URL で ギフトカウンター のリンクをコピーし、配信ツールに読み込ませてください。

設定の変更（ギフトの追加/削除、順序変更、目標値の変更など）はすべてリアルタイムでウィジェットに同期され、リンクを再コピーする必要はありません。