功能：单次特效卡支持赠送——送礼弹框、广播给指定用户/全员、公屏系统消息、购买后关闭商店展示特效

app/Events/EffectBroadcast.php

@@ -3,12 +3,12 @@
 /**
  * 文件功能：聊天室全屏特效广播事件
  *
- * 管理员触发烟花/下雨/雷电等特效后，
- * 通过 WebSocket 广播给房间内所有在线用户，前端收到后播放对应 Canvas 动画。
+ * 管理员或用户购买单次卡后触发，通过 WebSocket 广播给房间内用户播放 Canvas 动画。
+ * 支持指定接收者（target_username 为 null 则全员播放）。
  *
- * @package  App\Events
  * @author   ChatRoom Laravel
- * @version  1.0.0
+ *
+ * @version  2.0.0
  */
 
 namespace App\Events;
@@ -26,19 +26,23 @@ class EffectBroadcast implements ShouldBroadcastNow
     /**
      * 支持的特效类型列表（用于校验）
      */
-    public const TYPES = ['fireworks', 'rain', 'lightning'];
+    public const TYPES = ['fireworks', 'rain', 'lightning', 'snow'];
 
     /**
      * 构造函数
      *
-     * @param  int     $roomId    房间 ID
-     * @param  string  $type      特效类型：fireworks / rain / lightning
-     * @param  string  $operator  触发特效的管理员用户名
+     * @param  int  $roomId  房间 ID
+     * @param  string  $type  特效类型：fireworks / rain / lightning / snow
+     * @param  string  $operator  触发特效的用户名（购买者）
+     * @param  string|null  $targetUsername  接收者用户名（null = 全员）
+     * @param  string|null  $giftMessage  附带赠言
      */
     public function __construct(
         public readonly int $roomId,
         public readonly string $type,
         public readonly string $operator,
+        public readonly ?string $targetUsername = null,
+        public readonly ?string $giftMessage = null,
     ) {}
 
     /**
@@ -49,20 +53,22 @@ class EffectBroadcast implements ShouldBroadcastNow
     public function broadcastOn(): array
     {
         return [
-            new PresenceChannel('room.' . $this->roomId),
+            new PresenceChannel('room.'.$this->roomId),
         ];
     }
 
     /**
-     * 广播数据：特效类型和操作者
+     * 广播数据：特效类型、操作者、目标用户、赠言
      *
      * @return array<string, mixed>
      */
     public function broadcastWith(): array
     {
         return [
-            'type'     => $this->type,
+            'type' => $this->type,
             'operator' => $this->operator,
+            'target_username' => $this->targetUsername,   // null = 全员
+            'gift_message' => $this->giftMessage,
         ];
     }
 }