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

> PlayFabMultiplayer.JoinMatchmakingTicketFromId

## メソッド (1/2)

チケット ID とキュー名を使用して、1 人以上のローカル ユーザーをマッチメイキング チケットに参加させます。

```csharp theme={null}
public static MatchmakingTicket JoinMatchmakingTicketFromId(IList<MatchUser> localUsers, 
    string ticketId, string queueName, IList<PFEntityKey> membersToMatchWith)
```

| パラメーター | 説明 |
| - | - |
| localUsers | チケットに含めるローカル ユーザーとそのローカル ユーザー属性の配列。 |
| ticketId | 参加するチケットの ID。 |
| queueName | チケットが属するキュー。 |
| membersToMatchWith | チケットに参加することが想定される、他の特定のユーザー。 |

## 戻り値 (1/2)

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

## 注釈 (1/2)

ライブラリは自動的かつ非同期的に、すべてのローカル ユーザーをマッチメイキング サービス上のチケットに参加させます。チケットのステータスが変わるたびに、[`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.Joining` 状態から直ちに開始します。

チケットが完了すると、[`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) を介して照会できます。

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

***

## メソッド (2/2)

チケット ID とキュー名を使用して、1 人以上のローカル ユーザーをマッチメイキング チケットに参加させます。

```csharp theme={null}
public static MatchmakingTicket JoinMatchmakingTicketFromId(MatchUser localUser, string ticketId, 
    string queueName, IList<PFEntityKey> membersToMatchWith)
```

| パラメーター | 説明 |
| - | - |
| localUser | チケットに含めるローカル ユーザーとそのローカル ユーザー属性。 |
| ticketId | 参加するチケットの ID。 |
| queueName | チケットが属するキュー。 |
| membersToMatchWith | チケットに参加することが想定される、他の特定のユーザー。 |

## 戻り値 (2/2)

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

## 注釈 (2/2)

ライブラリは自動的かつ非同期的に、すべてのローカル ユーザーをマッチメイキング サービス上のチケットに参加させます。チケットのステータスが変わるたびに、[`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.Joining` 状態から直ちに開始します。

チケットが完了すると、[`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) を介して照会できます。

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

## 関連項目

* 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

- [PlayFabMultiplayer.CreateMatchmakingTicket](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/CreateMatchmakingTicket.md)
- [PFMultiplayerJoinMatchmakingTicketFromId](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmatchmaking/functions/pfmultiplayerjoinmatchmakingticketfromid.md)
- [PlayFabMultiplayer.OnMatchmakingTicketCompleted](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketCompleted.md)
- [PlayFabMultiplayer.OnMatchmakingTicketStatusChanged](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/OnMatchmakingTicketStatusChanged.md)
- [PlayFabMultiplayer.JoinLobby](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/PlayFabMultiplayer/JoinLobby.md)