플레이어 이름 관리
Manage player display names and handle naming updates throughout the player lifecycle.
읽는 시간 1분최근 업데이트: 8달 전
최소 SDK 버전: 2.5.0-pre.3. 올바른 버전을 사용해야 합니다.
플레이어는 플레이어 ID에 플레이어 이름을 연결해 ID를 커스터마이즈하고 읽기 쉬운 형태로 나타낼 수 있습니다. 플레이어 ID는 하나의 플레이어 이름에만 매핑되며, 반대의 경우도 마찬가지입니다.
플레이어 이름 설정
플레이어가 로그인한 상태에서만 플레이어 이름을 생성하거나 업데이트할 수 있습니다. 를 사용합니다. 이름에는 공백이 있어서는 안 되며 최대 길이는 50자입니다. 요청한 이름 뒤에 #와 4자리 숫자로 구성된 임의로 생성된 접미사(예: #1234)가 자동으로 추가됩니다.
AuthenticationService.Instance.UpdatePlayerNameAsync(playerName)플레이어가 로그인되어 있지 않거나 요청이 성공적으로 완료되지 않은 경우, 에서 RequestFailedException이 발생합니다. 인증 오류로 인해 업데이트가 실패하는 경우, 에서 AuthenticationException이 발생합니다.
UpdatePlayerNameAsyncUpdatePlayerNameAsync플레이어 이름 가져오기
플레이어가 로그인한 상태에서만 플레이어 이름을 가져올 수 있습니다. 를 사용합니다. 플레이어의 이름을 찾을 수 없는 경우 임의의 이름이 반환되어 플레이어에게 할당됩니다.
AuthenticationService.Instance.GetPlayerNameAsync()플레이어가 로그인되어 있지 않거나 요청이 성공적으로 완료되지 않은 경우, 에서 RequestFailedException이 발생합니다. 인증 오류로 인해 업데이트가 실패하는 경우, GetPlayerNameAsync에서 AuthenticationException이 발생합니다.
GetPlayerNameAsync캐싱
UpdatePlayerNameAsyncGetPlayerNameAsyncAuthenticationService.Instance.PlayerNameGetPlayerNameAsync