ドキュメント

サポート

Authentication

Open Unity Dashboard

Authentication

プレイヤー名の管理

Manage player display names and handle naming updates throughout the player lifecycle.
読み終わるまでの所要時間 1 分最終更新 1ヶ月前
最小 SDK バージョン: 2.5.0-pre.3。適切なバージョンを確認してください。 プレイヤーはプレイヤー ID にプレイヤー名を関連付けることで、自分の ID をカスタマイズ可能にし、より読みやすい表現にすることができます。プレイヤー ID は 1 つのプレイヤー名にのみマップされ、逆も同様です。

プレイヤー名の設定

プレイヤー名を作成または更新するには、プレイヤーがサインインしている必要があります。
AuthenticationService.Instance.UpdatePlayerNameAsync(playerName)
を使用します。名前にスペースを含めることはできず、長さは最大 50 文字までです。リクエストされた名前には、ハッシュと 4 桁の数字 (例: #1234) でランダムに生成されたサフィックスが自動的に追加されます。 プレイヤーがサインインしていないか、リクエストが正常に完了しなかった場合、
UpdatePlayerNameAsync
は RequestFailedException をスローします。更新が認証関連のエラーによって失敗した場合、
UpdatePlayerNameAsync
は AuthenticationException をスローします。

プレイヤー名の取得

プレイヤー名を取得するには、プレイヤーがサインインしている必要があります。
AuthenticationService.Instance.GetPlayerNameAsync()
を使用します。プレイヤーのプレイヤー名が見つからない場合は、ランダムな名前が返され、プレイヤーに割り当てられます。 プレイヤーがサインインしていないか、リクエストが正常に完了しなかった場合、
GetPlayerNameAsync
は RequestFailedException をスローします。取得が認証関連のエラーによって失敗した場合、GetPlayerNameAsync は AuthenticationException をスローします。

キャッシュ

プレイヤー名は、
UpdatePlayerNameAsync
または 
GetPlayerNameAsync
が呼び出されるたびに、プロファイルごとにローカルにキャッシュされます。プレイヤー名のキャッシュ値にアクセスするには、
AuthenticationService.Instance.PlayerName
を使用します。キャッシュ値は、新しいプレイヤーでサインインした後、サインアウトした後、またはプレイヤー名が存在しない状態で 
GetPlayerNameAsync
を呼び出した場合に消去されます。キャッシュ値が設定されていない場合は、null が返されます。