> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 大厅生命周期与过期

> 了解 PlayFab 大厅 TTL、默认过期以及客户端所拥有、服务器所拥有及已连接的大厅如何影响生命周期和自动删除行为。

本文介绍大厅如何过期和被删除。大厅的生命周期取决于大厅类型、连接状态和成员活动。理解这些行为有助于你设计游戏,以避免意外的大厅丢失并保持搜索结果整洁。

## 概览

PlayFab 大厅是玩家的临时分组。每个大厅都有一个生存时间 (TTL),它决定在闲置多久后会被自动删除。每当大厅中有活动(例如成员加入、离开或更新大厅数据)时,TTL 都会被重置。

决定大厅存活时间的两个最重要因素是:

* **大厅类型**:大厅是客户端所拥有还是服务器所拥有。
* **连接状态**:成员(和服务器)是否通过实时通知保持连接。

## 默认大厅生命周期

创建大厅时,会为其分配 **1 小时**的默认 TTL。每次大厅被更新(通过成员加入、数据更新或其他操作),TTL 都会刷新回其完整持续时间。

对于使用实时通知(连接)的大厅,当成员连接时,TTL 会延长到 **4 小时**。这一较长的 TTL 是考虑到已连接的大厅通过连接系统被主动监控,因此不需要那么快过期。

<Note>
  每次大厅操作都会重置大厅 TTL。正在被主动使用的大厅不会仅因 TTL 而过期。
</Note>

## 连接如何影响大厅生命周期

使用[实时通知](/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages)的大厅会跟踪成员连接。成员的连接状态直接影响大厅的生命周期和搜索可见性。

### 已连接的大厅

当至少一个成员连接到客户端所拥有的大厅时,该大厅保持可搜索,且最大空闲 TTL 为 **4 小时**。只要大厅继续收到更新或连接活动,TTL 就会持续重置。

### 已断开的大厅

当客户端所拥有大厅的所有成员断开连接时,会发生两件事:

1. \*\*该大厅在搜索中被隐藏。\*\*这可以防止其他玩家发现一个可能已被放弃的大厅。
2. \*\*大厅的 TTL 缩短到 1 分钟。\*\*大厅在删除前进入短暂的宽限期。

如果成员在此宽限期内重新连接,大厅将恢复完全可见性,并且其 TTL 会重新延长到 4 小时。

## 按大厅类型划分的生命周期行为

客户端所拥有和服务器所拥有的大厅具有不同的过期行为。

### 客户端所拥有的大厅

| 场景             | 行为                                               |
| -------------- | ------------------------------------------------ |
| 活跃且有已连接成员      | TTL 为 4 小时,每次操作都会重置。大厅可搜索。                       |
| 活跃但没有连接        | TTL 为 1 小时,每次操作都会重置。大厅可搜索。                       |
| 所有者断开连接        | 按照 **ownerMigrationPolicy** 触发所有者迁移。对 TTL 无直接影响。 |
| 所有成员断开连接       | 大厅在搜索中被隐藏。TTL 缩短到 1 分钟。                          |
| 所有成员断开后有成员重新连接 | 大厅重新可搜索。TTL 恢复到 4 小时。                            |
| 最后一位成员离开       | 大厅立即删除。                                          |

有关所有者断开连接时会发生什么的更多信息,请参阅[所有权变更](/services/playfab/multiplayer/lobby/ownership-changes)。

### 服务器所拥有的大厅

| 场景         | 行为                              |
| ---------- | ------------------------------- |
| 活跃且有已连接服务器 | TTL 为 4 小时,每次操作都会重置。大厅可搜索。      |
| 活跃但没有连接    | TTL 为 1 小时,每次操作都会重置。大厅可搜索。      |
| 服务器所有者断开连接 | 大厅在搜索中被隐藏。TTL 不受影响。             |
| 服务器所有者重新连接 | 大厅重新可搜索。                        |
| 所有成员断开连接   | 无操作。服务器不是成员,因此成员断开连接不会影响大厅生命周期。 |
| 服务器离开      | 该服务器可以被另一台声明所有权的服务器替代。          |

<Info>
  当所有玩家成员离开时,服务器所拥有的大厅不会被删除。只有服务器所有者才能删除服务器所拥有的大厅,否则它将在 TTL 用完后过期。
</Info>

## 将大厅生命周期延长到超过默认 TTL

4 小时的空闲 TTL 旨在作为大厅在无人管理情况下的普通预期最长时间。但是,某些场景(例如服务器所拥有的大厅等待玩家到达)可能需要更长生命周期的大厅。

若要让大厅存活时间超过默认 TTL,请在 TTL 过期之前定期更新大厅。任何更新操作都会重置 TTL。例如,游戏服务器可以定期更新大厅属性以防止大厅过期。

<Note>
  任何大厅操作都会重置 TTL,包括更新大厅属性、成员属性或搜索属性。
</Note>

## 搜索可见性与过期

大厅过期和搜索可见性密切相关但是不同的概念。

* **在搜索中被隐藏**意味着大厅不会出现在 [FindLobbies](/services/playfab/multiplayer/lobby/find-lobbies) 结果中,但它仍然存在,并且可以使用连接字符串加入。
* **已删除**意味着大厅不再存在并且无法访问。

在所有成员断开连接后的宽限期内,大厅可能在搜索中被隐藏但仍存活。这种设计可以防止暂时性的网络中断—如果成员迅速重新连接,大厅会在不丢失任何数据的情况下恢复。

## 总结

| 因素                   | 值                |
| -------------------- | ---------------- |
| 默认 TTL(无连接)          | 1 小时             |
| 默认 TTL(有连接)          | 4 小时             |
| 所有成员断开后的 TTL(客户端所拥有) | 1 分钟后删除          |
| 客户端所拥有的大厅,最后一位成员离开   | 立即删除             |
| 服务器所拥有的大厅,服务器断开      | 在搜索中隐藏,TTL 不受影响  |
| TTL 重置触发条件           | 任何大厅操作(加入、更新、离开) |

## 另请参阅

* [创建大厅](/services/playfab/multiplayer/lobby/create-a-lobby)
* [所有权变更](/services/playfab/multiplayer/lobby/ownership-changes)
* [游戏服务器与大厅](/services/playfab/multiplayer/lobby/lobby-server-overview)
* [大厅与匹配的实时通知](/services/playfab/multiplayer/lobby/lobby-and-matchmaking-real-time-messages)
* [大厅属性](/services/playfab/multiplayer/lobby/lobby-properties)
* [查找大厅](/services/playfab/multiplayer/lobby/find-lobbies)


## Related topics

- [多人游戏服务器的生命周期](/zh-CN/services/playfab/multiplayer/servers/multiplayer-game-server-lifecycle.md)
- [SDK 生命周期](/zh-CN/services/playfab/sdks/c/lifecycle.md)
- [Visual Studio 2019 GDK 支持说明](/zh-CN/tools/tools-console/visualstudio/vs-2019-support-notes.md)
- [创建大厅](/zh-CN/services/playfab/multiplayer/lobby/create-a-lobby.md)
- [Visual Studio 2026 GDK 支持说明](/zh-CN/tools/tools-console/visualstudio/vs-2026-support-notes.md)