27 lines
2.2 KiB
Markdown
27 lines
2.2 KiB
Markdown
# 大航海特效组件
|
|
|
|
`guard_effect`
|
|
是与礼物星雨完全独立的组件类型。账户注册或升级时创建一个初始实例，同一账户可以继续添加多个实例；每个实例分别拥有 settings、只读 OBS
|
|
token、`publicId` 和 WebSocket 广播通道。它只订阅 `live.guard.buy`，不接收普通礼物或连击事件。
|
|
|
|
从旧版本升级且账户尚无大航海组件时，服务会从最早的礼物特效实例复制主题、字体、星数、时长、性能模式及感谢文案作为初始设置。此后两个组件的设置互不关联。
|
|
|
|
## 青玉星落
|
|
|
|
舰长、提督或总督分别选择 `captain.webm`、`admiral.webm` 或 `general.webm`
|
|
全屏播放。视频约 8 秒，首尾各淡入/淡出 0.5 秒；第 4 秒开始在中央横向展开行书卷轴，依次显示可编辑的等级标题、开通或续费用户名，以及可编辑的收尾文字。标题模板可使用
|
|
`{guard}`
|
|
插入规范化的“舰长/提督/总督”，默认三行为“{guard}启航”、用户名、“相伴前行”。用户名缺失时才回退显示 UID。
|
|
|
|
大航海事件进入浏览器内存中的有界 FIFO，当前约八秒的视频或月夜庆祝完整结束后才播放下一项，不会覆盖正在播放的用户。队列按事件到达顺序排列并去重，容量可在控制台设置；达到上限时保留正在播放及已等待的事件，忽略新到达事件。该视觉队列不持久化，OBS 断线重连后只接收新事件。
|
|
|
|
感谢文字固定使用 Rust 静态服务同域提供的鸿雷行书简体 WOFF2，不读取 OBS 机器的系统字体。该字体随源文件提供的说明不包含开放再分发许可，公开或商业部署前需由部署者确认相应的 Web 嵌入和再分发授权。
|
|
|
|
## 静夜曲水
|
|
|
|
静夜主题使用透明月轮、水纹、身份、观众昵称与星光庆祝。控制台可以调整中文字体、文字亮度、星光数量、全屏持续时间和低性能模式。它不会绘制不透明的全场底色。
|
|
|
|
## OBS 与预览
|
|
|
|
组件适配任意浏览器源尺寸，控制台提供舰长、提督和总督三个独立预览入口。OBS 地址与礼物星雨完全不同；场景需要两种特效时，应分别添加两个浏览器源。
|