認証
Learn how authentication works in Matchmaker to securely identify and authorize players.
読み終わるまでの所要時間 1 分最終更新 1日前
重要
Unity Matchmaker は現在、Multiplay ホスティング、または Relay や Distributed Authority などの Unity が提供するクライアントホスト型ソリューションをサポートしています。チームはサードパーティ製のホスティング プロバイダー(Rocket ScienceのMultiplayなど)へのサポート拡張に取り組んでおり、2026年3月31日までの対応を目指しています。MatchMaker は引き続きリレーおよび分散権限と連携します。
- プレイヤー認証
- サービスアカウント認証
プレイヤー認証
プレイヤー認証は、プレイヤー主導のマッチメイキングを可能にするために Unity Authentication を使用します。これにより、ゲームクライアントは Matchmaker サービスにコンタクトしてチケットを作成できるようになります。 Matchmaker SDK を使用して呼び出しを行う前に、必ず Authentication サービスを 初期化 してサインインするようにしてください。 サインイン する方法は複数ありますが、最もシンプルな方法は 匿名ログイン を使用することです。サービスアカウント認証
サービスアカウント認証は、ゲームクライアントの代わりにバックエンドサービスがマッチメイキングチケットを作成する場合に使用されます。これは、マッチメイキングチケットにサーバー側のデータ (スキル値など) を追加する必要がある場合に役立ちます。 サービスアカウントを作成するには、こちらの 説明 に従ってください。 Matchmaker でサービスアカウントを使用するには、こちらの手順 に従ってください。 以下は、典型的なサービス間認証フローの例です。- プレイヤー認証で前述したように、クライアントが匿名認証を実行します。
-
クライアントは、をパラメーターとして使用し、カスタムバックエンドサーバーを呼び出します。
PlayerId -
カスタムバックエンドは、ヘッダーを
impersonate-user-id値に設定して、チケット作成ルートを呼び出します。PlayerIdcurl --location --request POST 'https://matchmaker.services.api.unity.com/v2/tickets' --header 'Content-Type: application/json' --header 'Authorization: {{SERVICE-ACCOUNT-TOKEN}}'--header 'impersonated-user-id: {{PLAYER-ID}}' --data-raw '{ "players": [ { "id": "{{PLAYER-ID}}", "customData": { "Skill": {{ENRICHED-DATA}} } } ] }' - カスタムバックエンドがクライアントにチケット ID を送信します。
- クライアントは、クライアント SDK を使用してチケットのステータスをポーリングします。