feat: 添加实时广播功能，支持风险预警、玩法切换和赔率更新，增强大厅公共频道的广播能力

2026-05-13 14:36:28 +08:00
parent d8e9fa5f4c
commit 6defe6bb0d
7 changed files with 436 additions and 1 deletions
--- a/app/Events/BalanceUpdateBroadcast.php
+++ b/app/Events/BalanceUpdateBroadcast.php
@@ -0,0 +1,69 @@
+<?php
+
+namespace App\Events;
+
+use Illuminate\Broadcasting\Channel;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
+
+/**
+ * 界面文档 §2.1：`balance.update` —— 钱包余额变动推送。
+ *
+ * 触发时机：转入/转出/下注/派彩等导致余额变动时。
+ * 前端处理：更新余额显示 + Toast 提示。
+ */
+final class BalanceUpdateBroadcast implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * @param  int  $playerId  玩家 ID（用于频道隔离）
+     * @param  string  $currencyCode  币种代码
+     * @param  int  $balanceMinor  最新余额（最小货币单位）
+     * @param  int  $changeMinor  变动金额（最小货币单位，正数为增加，负数为减少）
+     * @param  string  $reason  变动原因：transfer_in, transfer_out, bet, prize, refund
+     * @param  int  $emittedAtMs  发送时间戳（毫秒）
+     */
+    public function __construct(
+        public readonly int $playerId,
+        public readonly string $currencyCode,
+        public readonly int $balanceMinor,
+        public readonly int $changeMinor,
+        public readonly string $reason,
+        public readonly int $emittedAtMs,
+    ) {}
+
+    /**
+     * 使用私有频道，只有指定玩家能收到自己的余额变动。
+     *
+     * @return array<int, Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [new Channel('player.'.$this->playerId)];
+    }
+
+    public function broadcastAs(): string
+    {
+        return 'balance.update';
+    }
+
+    /**
+     * @return array{player_id: int, currency_code: string, balance_minor: int, balance_formatted: string, change_minor: int, change_formatted: string, reason: string, emitted_at_ms: int}
+     */
+    public function broadcastWith(): array
+    {
+        return [
+            'player_id' => $this->playerId,
+            'currency_code' => $this->currencyCode,
+            'balance_minor' => $this->balanceMinor,
+            'balance_formatted' => number_format($this->balanceMinor / 100, 2),
+            'change_minor' => $this->changeMinor,
+            'change_formatted' => ($this->changeMinor > 0 ? '+' : '').number_format($this->changeMinor / 100, 2),
+            'reason' => $this->reason,
+            'emitted_at_ms' => $this->emittedAtMs,
+        ];
+    }
+}