> ## 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`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Creating` 状态。

工单完成后,将提供 [`OnMatchmakingTicketStatusChanged`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。此时,要么已找到回填工单的匹配,要么由于失败而停止工单。成功时,可以通过 [`GetMatchDetails`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) 查询找到的匹配。regionPreferences 中的 `regionPreferences` 将仅包含服务器所在的区域。

此函数要求先调用 [`SetEntityToken`](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/SetEntityToken) 来设置游戏服务器实体令牌。

尽管此方法存在于统一的跨平台标头中,但它仅在 Windows 和 XBOX 上实现。此方法在其他平台上将返回错误。

## 另请参阅

* 类 [MatchmakingTicket](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview)
* 类 [PFEntityKey](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview)
* 结构 [MatchUser](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview)
* 类 [MultiplayerServerDetails](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MultiplayerServerDetails/overview)
* 类 [PlayFabMultiplayerServer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/overview)
* 命名空间 [PlayFab.Multiplayer](/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference)


## Related topics

- [PlayFab 2020 版本发布说明](/zh-CN/services/playfab/release-notes/2020.md)
- [使用服务器回填工单 - REST API](/zh-CN/services/playfab/multiplayer/matchmaking/backfill-tickets.md)
- [同时使用大厅和匹配](/zh-CN/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [PlayFabMultiplayerServer class](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/overview.md)
- [PFMultiplayerCreateServerBackfillTicket](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreateserverbackfillticket.md)