プレイヤー名の管理

Manage player display names and handle naming updates throughout the player lifecycle.

読み終わるまでの所要時間 4 分

最終更新 9ヶ月前

最小 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 が返されます。