Lib\Gateway类提供的接口 - sendToUid
优质
小牛编辑
137浏览
2023-12-01
说明:
void Gateway::sendToUid(mixed $uid, string $message);
向uid绑定的所有在线client_id发送数据。
注意:默认uid与client_id是一对多的关系,如果当前uid下绑定了多个client_id,则多个client_id对应的客户端都会收到消息,这类似于PC QQ和手机QQ同时在线接收消息。
参数
$uid
uid可以是字符串、数字、或者包含uid的数组。如果为数组,则是给数组内所有uid发送数据
$message
要发送的数据(字符串类型),此数据会被Gateway所使用协议的encode方法打包后再发送给客户端
返回值
因为数据发送是异步进行的,所以没有返回值。一般来说只要uid在线就可以发送成功。
发送前先可以用Gateway::getClientIdByUid判断下uid是否有在线的client_id。
范例
use GatewayWorkerLibGateway;
class Events
{
...
public static function onMessage($client_id, $message)
{
// $message = '{"type":"send_to_uid","uid":"xxxxx", "message":"...."}'
$req_data = json_decode($message, true);
Gateway::sendToUid($req_data['uid'], $req_data['message']);
}
...
}