Gift Rank（礼物计数器）

Gift Rank 是一个实时礼物投票进度挂件，适合做直播间礼物众筹目标追踪、礼物挑战赛、多礼物进度比拼，以及其他需要"让观众直观看到送礼进度"的互动环节。

整体布局

按界面功能，可以把 Gift Rank 理解成以下 2 个区域：

左侧是预览区，配置的任何修改都会立即反映在预览中。

右侧是配置区，包含计时设置、显示设置和礼物管理三个板块。

配置项	用来做什么	什么时候改	注意事项
`不开启`	不使用倒计时	不需要时间限制时保持默认	-
`10min`	固定 10 分钟倒计时	中短节奏的互动环节	-
`30min`	固定 30 分钟倒计时	较长时间的互动环节	-
`自定义`	输入自定义秒数	需要非标准时长时使用	最少 `10` 秒

倒计时与操作的关系

倒计时仅在计数器处于"运行中"状态时才会递减。暂停或重置后倒计时会暂停或回到初始值。

倒计时归零后，计数器自动结束，不再继续累加。

设置当某个礼物的计数达到其目标值时，计数器自动执行的动作。

运行中无法修改

计数器处于运行中状态时无法修改该配置，如需调整请先 重置。

配置项	用来做什么	什么时候改	注意事项
`进度显示`	选择进度条的文本格式	-	三种模式：`数值+百分比`（如 50/100（50%））、`仅数值`（如 50/100）、`仅百分比`（如 50%）
`显示礼物名`	在挂件中显示每个礼物的自定义名称	礼物种类较多、需要让观众区分时开启	关闭后挂件会自动切换为紧凑布局，占用空间更小
`显示礼物价值`	在挂件中显示礼物的钻石价值	-	-
`显示贡献榜`	在挂件底部显示总进度和贡献最大的前 3 位观众头像	想要激励观众竞争贡献时开启	-

配置项	用来做什么	什么时候改	注意事项
`礼物图标`	点击更换该行的礼物	-	已有计数数据的礼物替换前会弹出确认
`礼物名称`	为该礼物设置一个自定义显示名（仅在开启 `显示礼物名` 时可见）	-	输入框失焦后自动保存
`当前 / 目标`	显示该礼物的当前累计值和目标值	-	点击可手动调整（详见下方说明）
`显示 / 隐藏`	控制该礼物是否在挂件中显示	临时不希望某个礼物出现在挂件中时切换	隐藏只是不展示，计数仍会继续累加
`删除`	移除该礼物行	-	操作前会弹出确认
`拖拽排序`	拖动左侧的 `::` 手柄调整礼物在挂件中的显示顺序	-	同一时间内只允许一次拖拽操作
`添加礼物`	新增一个礼物行	-	最多 `8` 个礼物；不允许重复选择同一个礼物

点击礼物行的 当前 / 目标 区域，可以打开数值调整弹窗：

什么时候需要手动调整

常见场景：主播在直播中承诺"额外加 100 票"，此时可以通过手动调整直接修改当前值或目标值，而不需要等待观众实际送出对应礼物。

配置完成后，通过底部的操作按钮控制计数器的运行：

开播工具中的操作

需要将 礼物计数器 的链接通过 Copy URL 复制出来，并加载到开播工具中。

配置中的所有修改（包括添加/删除礼物、调整顺序、修改目标值等）都会实时同步到挂件，无需重新复制链接。