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

app/Http/Controllers/ShopController.php

@@ -2,11 +2,13 @@
 
 /**
  * 文件功能：商店控制器
- * 提供商品列表查询、商品购买、改名卡使用 三个接口
+ * 提供商品列表查询、商品购买（含赠送特效广播）、改名卡使用 三个接口
  */
 
 namespace App\Http\Controllers;
 
+use App\Events\EffectBroadcast;
+use App\Events\MessageSent;
 use App\Models\ShopItem;
 use App\Services\ShopService;
 use Illuminate\Http\JsonResponse;
@@ -53,7 +55,11 @@ class ShopController extends Controller
     /**
      * 购买商品
      *
-     * @param  Request  $request  含 item_id
+     * 单次特效卡额外支持：
+     *   - recipient  接收者用户名（传 "all" 或留空则全员可见）
+     *   - message    公屏赠言（可选）
+     *
+     * @param  Request  $request  含 item_id, recipient?, message?
      */
     public function buy(Request $request): JsonResponse
     {
@@ -72,9 +78,59 @@ class ShopController extends Controller
 
         $response = ['status' => 'success', 'message' => $result['message']];
 
-        // 单次特效卡：告诉前端立即播放哪个特效
+        // ── 单次特效卡：广播给指定用户或全员 ────────────────────────
         if (isset($result['play_effect'])) {
+            $user = Auth::user();
+            $roomId = (int) $request->room_id;
+            $recipient = trim($request->input('recipient', ''));     // 空字符串 = 全员
+            $message = trim($request->input('message', ''));
+
+            // recipient 为空或 "all" 表示全员
+            $targetUsername = ($recipient === '' || $recipient === 'all') ? null : $recipient;
+
+            // 广播特效事件（全员频道）
+            broadcast(new EffectBroadcast(
+                roomId: $roomId,
+                type: $result['play_effect'],
+                operator: $user->username,
+                targetUsername: $targetUsername,
+                giftMessage: $message ?: null,
+            ))->toOthers();
+
+            // 同时前端也需要播放（自己也要看到）
             $response['play_effect'] = $result['play_effect'];
+            $response['target_username'] = $targetUsername;
+            $response['gift_message'] = $message ?: null;
+
+            // 公屏系统消息
+            if ($roomId > 0) {
+                $icons = [
+                    'fireworks' => '🎆',
+                    'rain' => '🌧',
+                    'lightning' => '⚡',
+                    'snow' => '❄️',
+                ];
+                $icon = $icons[$result['play_effect']] ?? '✨';
+                $toStr = $targetUsername ? "【{$targetUsername}】" : '全体聊友';
+                $msgText = $message
+                    ? "「{$message}」"
+                    : '';
+                $sysContent = "{$icon} 【{$user->username}】送出了一张 [{$item->name}]，赠给 {$toStr}！{$msgText}";
+
+                // 广播系统消息到公屏
+                broadcast(new MessageSent(
+                    roomId: $roomId,
+                    message: [
+                        'id' => 0,
+                        'room_id' => $roomId,
+                        'username' => '系统',
+                        'content' => $sysContent,
+                        'type' => 'sys',
+                        'color' => '#cc6600',
+                        'created_at' => now()->toDateTimeString(),
+                    ]
+                ));
+            }
         }
 
         // 返回最新金币余额