ドキュメント

サポート

Matchmaker

Matchmaker

認証

Learn how authentication works in Matchmaker to securely identify and authorize players.
読み終わるまでの所要時間 1 分最終更新 4日前
Matchmaker への認証方法は 2 つあります。
  • プレイヤー認証
  • サービスアカウント認証

プレイヤー認証

プレイヤー認証は、プレイヤー主導のマッチメイキングを可能にするために Unity Authentication を使用します。これにより、ゲームクライアントは Matchmaker サービスにコンタクトしてチケットを作成できるようになります。 Matchmaker SDK を使用して呼び出しを行う前に、必ず Authentication サービスを 初期化 してサインインするようにしてください。 サインイン する方法は複数ありますが、最もシンプルな方法は 匿名ログイン を使用することです。

サービスアカウント認証

サービスアカウント認証は、ゲームクライアントの代わりにバックエンドサービスがマッチメイキングチケットを作成する場合に使用されます。これは、マッチメイキングチケットにサーバー側のデータ (スキル値など) を追加する必要がある場合に役立ちます。 サービスアカウントを作成するには、こちらの 説明 に従ってください。 Matchmaker でサービスアカウントを使用するには、こちらの手順 に従ってください。 以下は、典型的なサービス間認証フローの例です。
  1. プレイヤー認証で前述したように、クライアントが匿名認証を実行します。
  2. クライアントは、
    PlayerId
    をパラメーターとして使用し、カスタムバックエンドサーバーを呼び出します。
  3. カスタムバックエンドは、
    impersonate-user-id
    ヘッダーを 
    PlayerId
    値に設定して、チケット作成ルートを呼び出します。     
    curl --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}} } } ] }'
  4. カスタムバックエンドがクライアントにチケット ID を送信します。
  5. クライアントは、クライアント SDK を使用してチケットのステータスをポーリングします。