新主题
This commit is contained in:
@@ -15,6 +15,8 @@
|
||||
| 字段 | 范围/单位 | 行为 |
|
||||
| ------------------------ | ----------- | -------------------------- |
|
||||
| `themeId` | 主题 ID | 选择已安装的完整视觉主题 |
|
||||
| `fontFamily` | 字体 ID | `song`、`fang-song`、`kai` |
|
||||
| `fontBrightness` | 70–180% | 只调整文字亮度 |
|
||||
| `fontScale` | 50–300% | 展开与收缩字号的统一比例 |
|
||||
| `maxVisible` | 1–12 | 同时保留的消息卡数量 |
|
||||
| `collapseAfterSeconds` | 2–120 秒 | 最新卡从展开态切换到紧凑态 |
|
||||
@@ -27,12 +29,14 @@
|
||||
| `featuredValueThreshold` | 千分之一元 | 焦点礼物起点 |
|
||||
| `show*` | boolean | 控制各事件类别订阅 |
|
||||
|
||||
后端的 `OverlaySettings::sanitize` 是最终边界。控制台 range input 只改善交互，不能取代服务端校验。
|
||||
后端的 `OverlaySettings::sanitize` 是最终边界。控制台 range
|
||||
input 只改善交互，不能取代服务端校验。字体 ID 只映射到前端预先注册的安全字体栈，不接受任意 CSS；OBS 设备缺少首选字体时会依次回退到可用衬线字体。
|
||||
|
||||
## 主题
|
||||
|
||||
主题同时封装配色、花纹素材、装饰变体、粒子组合与动画名称。当前内置主题为
|
||||
`jade-scroll`（“青玉花卷”）；控制台仍以选择框呈现，新增主题后无需改变设置交互或卡片队列。
|
||||
`jade-scroll`（“青玉花卷”）与
|
||||
`moonlit-water`（“静夜曲水”）。后者不绘制卡片底色或外框，只保留青黛、米金衬线文字、细金分隔线与少量花星微光；控制台仍以选择框呈现，新增主题后无需改变设置交互或卡片队列。
|
||||
|
||||
增加主题时需要同步完成三处注册：
|
||||
|
||||
|
||||
@@ -6,13 +6,17 @@
|
||||
|
||||
## 展示行为
|
||||
|
||||
普通礼物从视口左侧生成一组带青玉、金色星尘拖尾的流星，礼物图片或 GIF 是流星主体，并从右侧完全飞出。原始价值按
|
||||
`jade-starfall`
|
||||
主题中，普通礼物从视口左侧生成一组带青玉、金色星尘拖尾的流星，礼物图片或 GIF 是流星主体，并从右侧完全飞出。原始价值按
|
||||
`highValueThreshold` 和 `featuredValueThreshold`
|
||||
分为普通、高价、特别高价三档，每档分别设置流星数量、基准尺寸和飞行速度。图片加载失败时使用内置星光图形，不依赖外部主题素材。
|
||||
|
||||
舰长、提督或总督使用同一个 `live.guard.buy`
|
||||
路径，临时显示不透明星河、闪耀粒子、身份和用户昵称。多个普通礼物可并发；大航海展示选择最新事件。
|
||||
|
||||
`moonlit-water`（“静夜曲水”）则采用“月下清供”：价值低于 50 元（原始
|
||||
`totalPrice < 50000`）的礼物以右侧水纹短笺展示图标、用户、名称和价格；50 元及以上礼物在整张浏览器源上展开月轮、水纹、礼物图标和文字。舰长、提督、总督也使用全屏月夜祝贺。该主题的全屏动效仍不绘制不透明底色，OBS 场景始终可见。
|
||||
|
||||
## 尺寸与性能
|
||||
|
||||
OBS 建议从 `1920×1080` 开始，但渲染器没有固定画布。`ResizeObserver`
|
||||
@@ -21,6 +25,7 @@ OBS 建议从 `1920×1080` 开始，但渲染器没有固定画布。`ResizeObse
|
||||
- 三档数量、尺寸和速度；
|
||||
- 拖尾强度和最大并发特效数；
|
||||
- 大航海星数和全屏持续时间；
|
||||
- 中文字体与文字亮度；
|
||||
- 低性能模式（限制粒子和流星数量）。
|
||||
|
||||
## 扩展主题
|
||||
|
||||
@@ -25,9 +25,10 @@ schema 没有提供盲盒原始 ID/名称，因此这类事件可以按实际电
|
||||
|
||||
## OBS 行为
|
||||
|
||||
每行横向展示图标、触发条件与主播自定义说明。行数、行高、文字比例、滚动速度、高亮时长和动效强度均可调整。仅当内容超过实际视口高度时滚动；渲染器复制三组菜单并在等价位置间无缝归一化，实现最后一行之后紧接第一行。
|
||||
每行横向展示图标、触发条件与主播自定义说明。行数、行高、中文字体、文字亮度、文字比例、滚动速度、高亮时长和动效强度均可调整。仅当内容超过实际视口高度时滚动；渲染器复制三组菜单并在等价位置间无缝归一化，实现最后一行之后紧接第一行。
|
||||
|
||||
命中时浏览器选择距离当前滚动位置最近的匹配副本，将它平滑对齐到视口第一行、暂停自动滚动并播放流金渐变与星花粒子。触发用户名称作为整行前景居中显示，覆盖原礼物图标和说明，并允许长名称换行。滚动器保留亚像素余量，低速设置也保持线性。低性能模式和系统减少动态效果偏好会关闭装饰粒子。舰长、提督和总督使用随前端打包的透明图标。
|
||||
|
||||
第一版主题 `jade-banquet` 复用仓库内已有且记录许可的花枝 SVG；新增主题必须在 `giftMenuThemes.ts`
|
||||
注册稳定 ID、资源键和局部 CSS 变量。
|
||||
`jade-banquet`
|
||||
复用仓库内已有且记录许可的花枝 SVG。`moonlit-water`（“静夜曲水”）提供另一种完全透明的排版：行项目没有卡片底色或外框，只以青黛、米金文字和细金线区分，触发时以水纹扫光高亮。新增主题必须在
|
||||
`giftMenuThemes.ts` 注册稳定 ID、资源键和局部 CSS 变量。
|
||||
|
||||
@@ -13,9 +13,11 @@
|
||||
|
||||
## 设置
|
||||
|
||||
`themeId`、`fontScale`、`scrollSpeedPixelsPerSecond` 和 `edgePauseSeconds`
|
||||
控制 OBS 外观与往返滚动。`maxQueueSize`、`maxRequestsPerViewer` 与 `requestCooldownSeconds`
|
||||
是可选防刷限制；值 `0` 表示不限制。
|
||||
`themeId`、`fontFamily`、`fontBrightness`、`fontScale`、`scrollSpeedPixelsPerSecond` 和
|
||||
`edgePauseSeconds` 控制 OBS 外观与往返滚动。`maxQueueSize`、`maxRequestsPerViewer` 与
|
||||
`requestCooldownSeconds` 是可选防刷限制；值 `0` 表示不限制。
|
||||
|
||||
`moonlit-water`（“静夜曲水”）与弹幕姬共享主题 ID：当前歌曲和待唱项会变为完全透明的衬线文字清单，以米金细线区分层级，不会在 OBS 上产生面板背景。
|
||||
|
||||
## OBS 与管理
|
||||
|
||||
|
||||
+3
-2
@@ -46,8 +46,9 @@ close 结束连接。
|
||||
`language` 是组件所属账户的 locale。用户在控制台修改语言后，所有已连接组件会立即收到
|
||||
`component.language.updated`，payload 为 `{ "language": "en-US" }`；新连接以认证帧为准。
|
||||
|
||||
设置快照中的 `themeId` 是稳定的主题标识，目前支持
|
||||
`jade-scroll`。消费者应把未知主题降级为自身默认主题，不能因主题发布顺序不同而中断实时消息。
|
||||
设置快照中的 `themeId` 是稳定的主题标识。弹幕姬与点歌姬支持 `jade-scroll` 和
|
||||
`moonlit-water`；礼物特效支持 `jade-starfall` 和 `moonlit-water`；礼物菜单支持 `jade-banquet` 和
|
||||
`moonlit-water`。消费者应把未知主题降级为自身默认主题，不能因主题发布顺序不同而中断实时消息。
|
||||
|
||||
## 版本化事件信封
|
||||
|
||||
|
||||
Reference in New Issue
Block a user