> ## 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.

# 遊戲伺服器和大廳

> 透過啟用伺服器 API、驗證 game_server 實體，以及建立或宣告伺服器擁有的大廳，從專用遊戲伺服器使用 PlayFab 大廳。

本文說明如何從遊戲伺服器使用 PlayFab 大廳。

## 在 PlayFab Multiplayer SDK 中啟用遊戲伺服器 API

若要在 PlayFab Multiplayer 中啟用遊戲伺服器 API，您必須在包含 PFLobby.h 之前定義 PFMULTIPLAYER\_INCLUDE\_SERVER\_APIS。

```cpp theme={null}
#define PFMULTIPLAYER_INCLUDE_SERVER_APIS
#include <PFMultiplayer.h>
#include <PFLobby.h>
```

## 建立伺服器擁有的大廳

若要建立伺服器擁有的大廳，請依照下列步驟操作：

1. 使用 [AuthenticateGameServerWithCustomId](https://learn.microsoft.com/en-us/rest/api/playfab/authentication/authentication/authenticate-game-server-with-custom-id) 以 game\_server PlayFab 實體身分登入，並擷取實體索引鍵和權杖組。
2. 使用 [PFMultiplayerSetEntityToken](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayersetentitytoken) 將 game\_server 的實體索引鍵和權杖提供給 PlayFab Multiplayer SDK。
3. 使用 game\_server 的實體索引鍵呼叫 [PFMultiplayerCreateAndClaimServerLobby](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby)。

如需詳細資訊和範例程式碼，請參閱[建立大廳](/zh-TW/services/playfab/multiplayer/lobby/create-a-lobby)。

## 伺服器不是成員

在用戶端擁有的大廳中，大廳的擁有者也是大廳的成員。

伺服器擁有的大廳在這方面有所不同。擁有大廳的 game\_server 實體不是大廳的成員。

伺服器擁有者能夠修改全域大廳屬性，但沒有自己的成員屬性區段。

如需此區別的詳細資訊，請參閱[大廳擁有者與成員](/zh-TW/services/playfab/multiplayer/lobby/owner-requirements-and-privileges)。

## 擁有權和擁有權移轉原則

與用戶端擁有的大廳不同，伺服器擁有的大廳只有一種有效的擁有權移轉原則："Server" 擁有權移轉原則。

這對擁有權移轉和大廳復原有重要影響。

主要是，當伺服器擁有之大廳的擁有者中斷連線時 (例如因為伺服器當機)，大廳的擁有權不會自動轉移給大廳中的任何成員。相反地，大廳會在大廳搜尋結果中隱藏 (以避免新成員無意間加入此大廳)，而由遊戲負責協調某些復原邏輯。

在下一個可用的時機，當機的 game\_server 實體應透過 [PFMultiplayerFindLobbies](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerfindlobbies) 使用 [lobby/amOwner 搜尋索引鍵](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/constants/pflobbysearchkeys)搜尋它需要復原的大廳。

找到需要復原的大廳後，遊戲伺服器可以嘗試繼續遊戲工作階段，或刪除大廳。

如需擁有權變更的詳細資訊，請參閱[擁有權變更](/zh-TW/services/playfab/multiplayer/lobby/ownership-changes)。

## 另請參閱

* [建立大廳](/zh-TW/services/playfab/multiplayer/lobby/create-a-lobby)
* [大廳擁有者與成員](/zh-TW/services/playfab/multiplayer/lobby/owner-requirements-and-privileges#lobby-owners-vs-members)
* [AuthenticateGameServerWithCustomId](https://learn.microsoft.com/en-us/rest/api/playfab/authentication/authentication/authenticate-game-server-with-custom-id)


## Related topics

- [建立大廳](/zh-TW/services/playfab/multiplayer/lobby/create-a-lobby.md)
- [大廳邀請](/zh-TW/services/playfab/multiplayer/lobby/lobby-invites.md)
- [大廳存留期和到期](/zh-TW/services/playfab/multiplayer/lobby/lobby-ttl.md)
- [加入大廳](/zh-TW/services/playfab/multiplayer/lobby/join-lobbies.md)
- [伺服器](/zh-TW/services/playfab/multiplayer/servers/index.md)