PartyLocalUser::UpdateEntityToken

이후 인증된 작업에서 사용할 수 있도록 이 로컬 사용자와 연결된 PlayFab 엔터티 토큰을 업데이트합니다.

구문

PartyError UpdateEntityToken(  
    PartyString titlePlayerEntityToken  
)  

매개 변수

titlePlayerEntityTokenPartyString

로컬 사용자와 연결할 PlayFab 엔터티 토큰입니다.

반환 값

PartyError

호출이 성공한 경우 c_partyErrorSuccess이고 그렇지 않은 경우 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

비고

이 메서드는 PlayFab 엔터티 토큰을 titlePlayerEntityToken으로 사용합니다. 이 값에 대해서는 동기 유효성 검사가 수행되지 않습니다. 라이브러리에서 네트워크 만들기, 네트워크에 인증, 음성 번역 등과 같이 사용자 인증이나 권한 부여가 필요한 작업을 수행하는 경우 파티 서비스에서는 토큰이 유효하고, 만료되지 않았고, PartyManager::CreateLocalUser() 호출에 제공된 것과 같은 엔터티 ID와 연결되어 있고, 작업을 수행할 권한이 있는지 확인합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다.

PlayFab 엔터티 토큰은 PlayFab 로그인 작업의 출력에서 가져온 다음 이 메서드의 입력으로 제공할 수 있습니다. 토큰은 대부분의 개발자에게 “플레이어”를 나타내는 가장 일반적인 방식인 title_player_account 형식의 PlayFab 엔터티와 연결되어 있어야 합니다.

제공되는 titlePlayerEntityToken은 PartyManager::Initialize()에 전달된 것과 동일한 타이틀 ID를 사용하여 얻어야 합니다.

파티 라이브러리에서는 PartyManager::CreateNewNetwork() 또는 PartyNetwork::AuthenticateLocalUser() 같이 로컬 사용자의 인증이나는 권한 부여가 필요한 후속 작업에 사용하기 위해 제공된 PlayFab 엔터티 토큰의 복사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않으면 유효한 토큰이 필요한 작업이 실패합니다. 이 메서드를 다시 호출하여 파티 라이브러리에 유효한 새 토큰을 제공할 수 있습니다.

호출자는 이 메서드 및 PartyManager::CreateLocalUser()에 제공된 엔터티 토큰의 만료를 모니터링합니다. 토큰의 만료 시간이 가까워지거나 지난 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 이 메서드를 호출하여 파티 라이브러리에 토큰을 제공해야 합니다. 이전에 제공된 토큰의 유효 기간이 중간쯤 지났을 때 새 토큰을 얻는 것이 좋습니다. 저전력 상태로 들어가거나 기타 이유로 애플리케이션 실행이 오랫동안 일시 중지하여 토큰이 만료 전에 새로 고쳐지지 않게 될 수 있는 플랫폼에서는 실행이 재개되면 토큰이 만료되었는지 확인해야 합니다.

요구 사항

헤더: Party.h

참고 항목

PartyLocalUser
PartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser