PartyLocalUser::UpdateEntityToken

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

구문

PartyError UpdateEntityToken(  
    PartyString entityToken  
)  

매개 변수

entityToken PartyString

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

반환 값

PartyError

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

비고

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

PlayFab 엔터티 토큰은 PlayFab 로그인 작업의 출력에서 가져온 다음 이 메서드의 입력으로 제공할 수 있습니다. 토큰은 원래 PartyManager::CreateLocalUser() 또는 PartyManager::CreateLocalUserWithEntityType()에 지정된 것과 동일한 PlayFab 엔터티 ID와 연결되어야 합니다.

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

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

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

요구 사항

헤더: Party.h

참고 항목

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