# プレイヤー名の管理

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

最小 SDK バージョン: 2.5.0-pre.3。適切なバージョンを確認してください。

プレイヤーはプレイヤー ID にプレイヤー名を関連付けることで、自分の ID をカスタマイズ可能にし、より読みやすい表現にすることができます。プレイヤー ID は 1 つのプレイヤー名にのみマップされ、逆も同様です。

## プレイヤー名の設定##setting-player-name

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

プレイヤーがサインインしていないか、リクエストが正常に完了しなかった場合、`UpdatePlayerNameAsync` は RequestFailedException をスローします。更新が認証関連のエラーによって失敗した場合、`UpdatePlayerNameAsync` は AuthenticationException をスローします。

## プレイヤー名の取得##getting-player-name

プレイヤー名を取得するには、プレイヤーがサインインしている必要があります。`AuthenticationService.Instance.GetPlayerNameAsync()` を使用します。プレイヤーのプレイヤー名が見つからない場合は、ランダムな名前が返され、プレイヤーに割り当てられます。

プレイヤーがサインインしていないか、リクエストが正常に完了しなかった場合、`GetPlayerNameAsync` は RequestFailedException をスローします。取得が認証関連のエラーによって失敗した場合、GetPlayerNameAsync は AuthenticationException をスローします。

## キャッシュ##caching

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