Lib\Gateway类提供的接口 - isUidOnline

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

说明:

  1. int Gateway::isUidOnline(mixed $uid);

(需要Gateway版本>=2.0.4)

判断$uid是否在线,此方法需要配合Gateway::bindUid($client_uid, $uid)使用。

如果某uid没有通过Gateway::bindUid($client_uid, $uid)进行任何绑定,那么对该uid调用Gateway::isUidOnline($uid)将返回0。

如果某uid绑定的client_id都已经下线,那么对该uid调用Gateway::isUidOnline($uid)将返回0。

如果某uid绑定的client_id有至少有一个在线,那么对该uid调用Gateway::isUidOnline($uid)将返回1。

参数

  • $uid

uid,可以是数字或者字符串

返回值

uid在线返回1,不在线返回0

范例

  1. use GatewayWorkerLibGateway;
  2. class Events
  3. {
  4. ...
  5. public static function onMessage($client_id, $message)
  6. {
  7. // $message = '{"type":"say_to_one","to_uid":100,"content":"hello"}'
  8. $req_data = json_decode($message, true);
  9. $uid = $req_data['to_uid'];
  10. // 如果是向某个客户端发送消息
  11. if($req_data['type'] == 'say_to_one'))
  12. {
  13. // 如果不在线就先存起来
  14. if(!Gateway::isUidOnline($uid))
  15. {
  16. // 假设有个your_store_fun函数用来保存未读消息(这个函数要自己实现)
  17. your_store_fun($message);
  18. }
  19. else
  20. {
  21. // 在线就转发消息给对应的uid
  22. Gateway::sendToUid($uid, $req_data['content']);
  23. }
  24. }
  25. }
  26. ...
  27. }