> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged)。可以随时通过 [`Status`](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) 查询工单状态。工单立即处于 `MatchmakingTicketStatus.Creating` 状态。

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

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

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

## 另请参阅

* 类 [MatchmakingTicket](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview.md)
* 类 [PFEntityKey](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)
* 结构 [MatchUser](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview.md)
* 类 [MultiplayerServerDetails](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MultiplayerServerDetails/overview.md)
* 类 [PlayFabMultiplayerServer](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/overview.md)
* 命名空间 [PlayFab.Multiplayer](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference.md)


## Related topics

- [Create Server Backfill Ticket](https://docs.xbox.com/api-reference/matchmaking/create-server-backfill-ticket.md)
- [PlayFab 2020 版本发布说明](https://docs.xbox.com/zh-CN/services/playfab/release-notes/2020.md)
- [使用服务器回填票证 - REST API](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/matchmaking/backfill-tickets.md)
- [创建服务器回填票证](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/multiplayer/matchmaking/create-server-backfill-ticket.md)
- [同时使用大厅和匹配](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)