70 lines
2.4 KiB
PHP
70 lines
2.4 KiB
PHP
<?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,
|
||
];
|
||
}
|
||
}
|