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

# 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`](/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) を介して照会できます。

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

`configuration` パラメーターの `membersToMatchWith` フィールドに指定されたすべてのリモート ユーザーが [`JoinMatchmakingTicketFromId`](/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`](/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) を介して照会できます。

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

`configuration` パラメーターの `membersToMatchWith` フィールドに指定されたすべてのリモート ユーザーが [`JoinMatchmakingTicketFromId`](/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`](/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) を介して照会できます。

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

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

## 関連項目

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


## Related topics

- [CreateServerBackfillTicket](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer.PlayFabMultiplayerServer/CreateServerBackfillTicket.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.JoinMatchmakingTicketFromId](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinMatchmakingTicketFromId.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [Specifying attributes with your tickets](/ja-jp/services/playfab/multiplayer/matchmaking/ticket-attributes.md)
