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

# PFMatchmakingTicketConfiguration

> 用于创建 PlayFab 多人游戏匹配票证的配置数据，包括超时、队列名称以及延迟测量使用等选项。

定义匹配票证的配置。

## 语法

```cpp theme={null}
struct PFMatchmakingTicketConfiguration {  
    uint32_t timeoutInSeconds;  
    const char* queueName;  
    uint32_t membersToMatchWithCount;  
    const PFEntityKey* membersToMatchWith;  
}  
```

### 成员

**`timeoutInSeconds`**   uint32\_t

尝试为票证进行匹配的时长（秒）。

**`queueName`**   const char\*\
*is null-terminated*

匹配队列的名称。

**`membersToMatchWithCount`**   uint32\_t

预计加入该票证的其他特定用户的数量。

**`membersToMatchWith`**   const [PFEntityKey](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*array of size `membersToMatchWithCount`*

预计加入该票证的其他特定用户的 PlayFab 实体密钥。

此字段用于指定预计加入该票证的其他特定用户的数量。通常，此列表代表一组希望一起匹配的好友或战队。在所有指定用户通过 [PFMultiplayerJoinMatchmakingTicketFromId](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid) 加入票证之前，无法找到匹配。

## 要求

**头文件：** PFMatchmaking.h

## 另请参阅

[PFMatchmaking 成员](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members)


## Related topics

- [PFMultiplayerCreateMatchmakingTicket](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayercreatematchmakingticket.md)
- [PFMultiplayer C/C++ API 概述 - PFMatchmaking.h](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/pfmatchmaking_members.md)
- [Matchmaking SDK 快速入门](/zh-CN/services/playfab/multiplayer/matchmaking/quickstart-client-sdk.md)
- [PFMatchmakingServerBackfillTicketConfiguration](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/structs/pfmatchmakingserverbackfillticketconfiguration.md)
- [XblMatchmakingCreateMatchTicketAsync](/zh-CN/reference/live/xsapi-c/matchmaking_c/functions/xblmatchmakingcreatematchticketasync.md)