完善座驾插件验收规则

2026-04-30 11:18:59 +08:00
parent 622bc94377
commit 06864a9cec
1 changed files with 20 additions and 0 deletions
@@ -43,6 +43,26 @@ description: "开发 /Users/pllx/Web/Herd/chatroom 的聊天室座驾。适用
 - 数据模型：`app/Models/Ride.php`、`app/Models/UserRidePurchase.php`。
 - 请求验证：`BuyRideRequest`、`StoreRideRequest`、`UpdateRideRequest`。

+## 已验收的进房展示规则
+
+- 用户有有效座驾时，座驾优先级最高：
+  - 只发送一条 `座驾播报` 文字消息。
+  - 不再发送普通 `进出播报`。
+  - 不再播放会员进场横幅或会员全屏特效。
+- 座驾全屏特效播放范围是当前房间内所有在线用户：
+  - 进房用户本人通过 `initialRideEffect` 本地播放。
+  - 其他在线用户通过 `EffectBroadcast` 的 `room.{roomId}` PresenceChannel 播放。
+  - 不设置 `target_username`，表示当前房间全员可见。
+- 座驾文字播报口径：
+  - 显示 `部门 <部门> · 职务 <图标 职务> · 会员 <图标 会员>`。
+  - 不在身份行前面显示 `用户 <用户名>`，因为后面的欢迎语模板已经包含 `{name}`。
+  - 示例：`🚀 部门 办公厅 · 职务 🎖️ 技术总监 · 会员 👑 至尊会员 · 【流星】乘【东风-5C战略导弹】点火升空...`
+- 座驾动画 HUD 标题口径：
+  - 第一行用户身份信息显示 `用户 <用户名> · 部门 <部门> · 职务 <图标 职务> · 会员 <图标 会员>`。
+  - 第二行标题只显示 `乘坐【<座驾名称>】闪亮登场`，不要重复用户名。
+  - `effect_user_info` 供动画 HUD 第一行使用，`effect_title` 供动画 HUD 第二行使用，`identity_text` 只供文字播报使用。
+- 前端改动后如果浏览器仍显示旧动画标题，必须运行 `npm run build` 或确认 Vite dev server 已刷新，避免加载旧的 `public/build` 资源。
+
 ## 新增座驾步骤

 1. 新增全屏特效文件：`resources/js/effects/<effect_key>.js`。