Gateway::sendToUid

说明:

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 \GatewayWorker\Lib\Gateway;
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']);
    }

    ...
}