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

# PlayFabMultiplayer.CreateMatchmakingTicket

> PlayFabMultiplayer.CreateMatchmakingTicket

## メソッド (1/3)

1 人以上のローカル ユーザーのためのマッチメイキング チケットを作成します。

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(IList<MatchUser> localUsers, 
    string queueName, uint timeoutInSeconds = 120)
```

| パラメーター | 説明 |
| - | - |
| localUsers | チケットに含めるローカル ユーザーとそのローカル ユーザー属性の配列。 |
| queueName | チケットが属するキュー。 |
| timeoutInSeconds | チケットのマッチメイキングを試行する時間 (秒単位)。既定値は 120 秒。 |

## 戻り値 (1/3)

作成されるチケット オブジェクト。

## 注釈 (1/3)

ライブラリは自動的かつ非同期的に、チケット上のすべてのローカル ユーザーをマッチメイキング サービスに送信します。チケットのステータスが変わるたびに、[`OnMatchmakingTicketStatusChanged`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) が提供されます。チケットのステータスは、[`Status`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) を介していつでも照会できます。チケットは、`MatchmakingTicketStatus.Creating` 状態から直ちに開始します。

チケットが完了すると、[`OnMatchmakingTicketStatusChanged`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) が提供されます。この時点で、マッチが見つかっているか、失敗によりチケットが停止しています。成功した場合、見つかったマッチは [`GetMatchDetails`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) を介して照会できます。

ローカル ユーザーがメンバーになっているすべての既存チケットは、この操作の一環としてキャンセルされます。

`configuration` パラメーターの `membersToMatchWith` フィールドに指定されたすべてのリモート ユーザーが [`JoinMatchmakingTicketFromId`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) を介してチケットに参加するまで、マッチは見つかりません。

***

## メソッド (2/3)

1 人以上のローカル ユーザーのためのマッチメイキング チケットを作成します。

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(MatchUser localUser, string queueName, 
    uint timeoutInSeconds = 120)
```

| パラメーター | 説明 |
| - | - |
| localUser | チケットに含めるローカル ユーザーとそのローカル ユーザー属性。 |
| queueName | チケットが属するキュー。 |
| timeoutInSeconds | チケットのマッチメイキングを試行する時間 (秒単位)。既定値は 120 秒。 |

## 戻り値 (2/3)

作成されるチケット オブジェクト。

## 注釈 (2/3)

ライブラリは自動的かつ非同期的に、チケット上のすべてのローカル ユーザーをマッチメイキング サービスに送信します。チケットのステータスが変わるたびに、[`OnMatchmakingTicketStatusChanged`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) が提供されます。チケットのステータスは、[`Status`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) を介していつでも照会できます。チケットは、`MatchmakingTicketStatus.Creating` 状態から直ちに開始します。

チケットが完了すると、[`OnMatchmakingTicketStatusChanged`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) が提供されます。この時点で、マッチが見つかっているか、失敗によりチケットが停止しています。成功した場合、見つかったマッチは [`GetMatchDetails`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) を介して照会できます。

ローカル ユーザーがメンバーになっているすべての既存チケットは、この操作の一環としてキャンセルされます。

`configuration` パラメーターの `membersToMatchWith` フィールドに指定されたすべてのリモート ユーザーが [`JoinMatchmakingTicketFromId`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) を介してチケットに参加するまで、マッチは見つかりません。

***

## メソッド (3/3)

1 人以上のローカル ユーザーのためのマッチメイキング チケットを作成します。

```csharp theme={null}
public static MatchmakingTicket CreateMatchmakingTicket(IList<MatchUser> localUsers, 
    string queueName, List<PFEntityKey> membersToMatchWith, uint timeoutInSeconds = 120)
```

| パラメーター | 説明 |
| - | - |
| localUsers | チケットに含めるローカル ユーザーとそのローカル ユーザー属性の配列。 |
| queueName | チケットが属するキュー。 |
| membersToMatchWith | チケットに参加することが想定される、他の特定のユーザー。 |
| timeoutInSeconds | チケットのマッチメイキングを試行する時間 (秒単位)。既定値は 120 秒。 |

## 戻り値 (3/3)

作成されるチケット オブジェクト。

## 注釈 (3/3)

ライブラリは自動的かつ非同期的に、チケット上のすべてのローカル ユーザーをマッチメイキング サービスに送信します。チケットのステータスが変わるたびに、[`OnMatchmakingTicketStatusChanged`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) が提供されます。チケットのステータスは、[`Status`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/Status) を介していつでも照会できます。チケットは、`MatchmakingTicketStatus.Creating` 状態から直ちに開始します。

チケットが完了すると、[`OnMatchmakingTicketStatusChanged`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged) が提供されます。この時点で、マッチが見つかっているか、失敗によりチケットが停止しています。成功した場合、見つかったマッチは [`GetMatchDetails`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/GetMatchDetails) を介して照会できます。

ローカル ユーザーがメンバーになっているすべての既存チケットは、この操作の一環としてキャンセルされます。

`configuration` パラメーターの `membersToMatchWith` フィールドに指定されたすべてのリモート ユーザーが [`JoinMatchmakingTicketFromId`](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId) を介してチケットに参加するまで、マッチは見つかりません。

## 関連項目

* class [MatchmakingTicket](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicket/overview.md)
* struct [MatchUser](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchUser/overview.md)
* class [PFEntityKey](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PFEntityKey/overview.md)
* class [PlayFabMultiplayer](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/overview.md)
* namespace [PlayFab.Multiplayer](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference.md)


## Related topics

- [CreateServerBackfillTicket](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [PlayFabMultiplayer.CreateAndJoinLobby](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateAndJoinLobby.md)
