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

# CreateServerBackfillTicket

> CreateServerBackfillTicket

# PlayFabMultiplayer.PlayFabMultiplayerServer.CreateServerBackfillTicket 方法

建立伺服器回填票證。

```csharp theme={null}
public static MatchmakingTicket CreateServerBackfillTicket(PFEntityKey server, string queueName, 
    List<MatchUser> matchMembers, MultiplayerServerDetails serverDetails, 
    uint timeoutInSeconds = 300)
```

| 參數 | 描述 |
| - | - |
| server | 伺服器實體。 |
| queueName | 票證所屬的佇列。 |
| matchMembers | 目前在比賽中的成員。 |
| serverDetails | 票證所對應之 PlayFab Multiplayer Server 的詳細資料。伺服器詳細資料為選用。如果在比賽完成時不需要將伺服器詳細資料提供給用戶端，此值可以是 null。同樣地，伺服器詳細資料中不需要提供給用戶端的任何欄位都可以是空白或 null。 |
| timeoutInSeconds | 嘗試為票證進行配對的時間長度 (以秒為單位)。預設為 300 秒。 |

## 傳回值

產生的票證物件。

## 備註

程式庫會自動以非同步方式將伺服器回填票證提交至配對服務。每次票證狀態變更時，都會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。隨時都可以透過 [`Status`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查詢票證狀態。票證會立即從 `MatchmakingTicketStatus.Creating` 狀態開始。

當票證完成時，會提供 [`OnMatchmakingTicketStatusChanged`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此時，已為回填票證找到比賽，或票證因失敗而停止。成功時，可以透過 [`GetMatchDetails`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查詢找到的比賽。regionPreferences 中的 `regionPreferences` 只會包含伺服器所在的區域。

此函式需要先前已呼叫 [`SetEntityToken`](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/SetEntityToken) 來設定遊戲伺服器實體權杖。

雖然此方法存在於統一的跨平台標頭中，但僅針對 Windows 和 XBOX 實作。在其他平台上，此方法會傳回錯誤。

## 另請參閱

* class [MatchmakingTicket](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* class [PFEntityKey](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* struct [MatchUser](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* class [MultiplayerServerDetails](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MultiplayerServerDetails/overview)
* class [PlayFabMultiplayerServer](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/overview)
* namespace [PlayFab.Multiplayer](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [Create Server Backfill Ticket](/api-reference/matchmaking/create-server-backfill-ticket.md)
- [PlayFab 2020 版本資訊](/zh-TW/services/playfab/release-notes/2020.md)
- [使用伺服器回填票證 - REST API](/zh-TW/services/playfab/multiplayer/matchmaking/backfill-tickets.md)
- [建立伺服器回填票證](/zh-TW/services/playfab/api-references/rest/multiplayer/matchmaking/create-server-backfill-ticket.md)
- [搭配使用大廳和配對](/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)