lkddi
0f0691d037
ShouldBroadcast 走队列（异步），不保证及时广播； ShouldBroadcastNow 不走队列，与 MessageSent 一致，立即推送到 Reverb。 这是大卡弹窗收不到的真实原因。
76 lines
2.2 KiB
PHP
76 lines
2.2 KiB
PHP
<?php
|
||
|
||
/**
|
||
* 文件功能：好友添加广播事件
|
||
*
|
||
* 当用户 A 添加用户 B 为好友时，向 B 的私有频道广播此事件，
|
||
* B 的客户端收到后展示弹窗通知。
|
||
* 携带 has_added_back 字段：若 B 已将 A 加为好友则为 true（双向好友），
|
||
* 否则为 false，前端提示 B 可以点击回加。
|
||
*
|
||
* @author ChatRoom Laravel
|
||
*
|
||
* @version 1.0.0
|
||
*/
|
||
|
||
namespace App\Events;
|
||
|
||
use Illuminate\Broadcasting\Channel;
|
||
use Illuminate\Broadcasting\InteractsWithSockets;
|
||
use Illuminate\Broadcasting\PrivateChannel;
|
||
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
|
||
use Illuminate\Foundation\Events\Dispatchable;
|
||
use Illuminate\Queue\SerializesModels;
|
||
|
||
class FriendAdded implements ShouldBroadcastNow
|
||
{
|
||
use Dispatchable, InteractsWithSockets, SerializesModels;
|
||
|
||
/**
|
||
* 构造好友添加事件。
|
||
*
|
||
* @param string $fromUsername 发起添加的用户名（A）
|
||
* @param string $toUsername 被添加的用户名（B，接收通知方）
|
||
* @param bool $hasAddedBack B 是否已将 A 加为好友（互相添加=true）
|
||
*/
|
||
public function __construct(
|
||
public readonly string $fromUsername,
|
||
public readonly string $toUsername,
|
||
public readonly bool $hasAddedBack = false,
|
||
) {}
|
||
|
||
/**
|
||
* 广播到被添加用户的私有频道，仅本人可见。
|
||
*/
|
||
public function broadcastOn(): Channel
|
||
{
|
||
return new PrivateChannel('user.'.$this->toUsername);
|
||
}
|
||
|
||
/**
|
||
* 指定广播事件名称（短名），供前端 listen('.FriendAdded') 匹配。
|
||
*
|
||
* 默认广播名为全类名 App\Events\FriendAdded，
|
||
* 指定短名后前端只需 .listen('.FriendAdded')。
|
||
*/
|
||
public function broadcastAs(): string
|
||
{
|
||
return 'FriendAdded';
|
||
}
|
||
|
||
/**
|
||
* 广播负载：包含发起人信息和互相好友状态，供前端弹窗使用。
|
||
*
|
||
* @return array<string, mixed>
|
||
*/
|
||
public function broadcastWith(): array
|
||
{
|
||
return [
|
||
'from_username' => $this->fromUsername,
|
||
'to_username' => $this->toUsername,
|
||
'type' => 'friend_added',
|
||
'has_added_back' => $this->hasAddedBack,
|
||
];
|
||
}
|
||
}
|