Lib\Gateway类提供的接口 - sendToUid

优质
小牛编辑
137浏览
2023-12-01

说明:

  1. 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。

范例

  1. use GatewayWorkerLibGateway;
  2. class Events
  3. {
  4. ...
  5. public static function onMessage($client_id, $message)
  6. {
  7. // $message = '{"type":"send_to_uid","uid":"xxxxx", "message":"...."}'
  8. $req_data = json_decode($message, true);
  9. Gateway::sendToUid($req_data['uid'], $req_data['message']);
  10. }
  11. ...
  12. }