大厅和匹配实时通知

概述

匹配和大厅功能内置了对实时通知的支持。 通知玩家匹配或大厅的更改从未如此简单,因为处理通知的工作已为你完成。 新的 API 将允许连接的客户端订阅大厅和匹配更改的通知。 添加此项后,不再需要轮询匹配或大厅的更改。

SDK 旨在简化工作。 SDK 管理游戏客户端或服务器与 PlayFab 大厅和匹配服务之间的调用。 它实时处理从这些服务传递到连接的客户端的通知。 实时通知具有跨平台支持,并且适用于 PlayFab 提供 SDK 的任意位置。 匹配和大厅可以单独使用或一同使用,实时通知适用于任一情况。 目前不支持无 SDK 的实时通知。 实时通知不可用作独立或常规使用的解决方案。

实时通知的工作原理

每个客户端都维护单个 WebSocket 以接收实时通知。 当云中的匹配或大厅资源有更新时,SDK 会将通知实时转发给订阅了这些资源的所有连接客户端。

当客户端连接以接收实时通知时,它们将打开新的 WebSocket 连接以接收通知并侦听更改事件。 当客户端创建大厅、加入大厅、开始侦听邀请或创建匹配票证时,连接的客户端将订阅大厅或匹配资源以侦听更改。 当客户端订阅的资源主题有更新时,将收到通知。 例如,如果客户端已订阅大厅资源,可能会在更改事件(例如玩家 A 或 B 已加入或离开大厅)时收到通知。 匹配和大厅文档更详细地介绍了将支持通知的操作。

启用实时通知的 WebSocket 连接也用于检测客户端连接。 大厅服务使用此客户端连接状态以为大厅所有权管理提供支持。

共享连接支持

匹配和大厅通知支持共享单个 WebSocket 连接,这在创建具有单机双人模式的游戏时可能很有用。 目前,最多 8 个本地用户可以共享 WebSocket 连接,并且可以向该共享连接添加或删除本地玩家。 共享同一连接的多个用户可以订阅主题,从而获取有关这些主题的匹配或大厅事件的通知。

使用 SDK

SDK 可为你处理实时通知,从而简化了跨网络和跨平台游戏的工作。 接收邀请、加入和更新大厅、查找匹配项等时,会向客户端发送通知。 在 PlayFab 提供 SDK 支持的任何平台上,SDK 支持跨平台游戏和实时通知。 自动向客户端发送通知,开发人员无需执行任何操作即可启用通知。