Syntax
Parameters
entityToken PartyString
로컬 사용자와 연결할 새 PlayFab Entity Token입니다.
Return value
PartyError 호출이 성공한 경우c_partyErrorSuccess, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.
Remarks
이 메서드는 PlayFab Entity Token을entityToken으로 받습니다. 이 값에 대해 동기 유효성 검사가 수행되지 않습니다. 라이브러리가 네트워크 생성, 네트워크 인증 또는 음성-텍스트 변환 전사 수행과 같이 사용자 인증 또는 권한 부여가 필요한 작업을 수행할 때, Party 서비스는 토큰이 유효하고 만료되지 않았으며 PartyManager::CreateLocalUser() 또는 PartyManager::CreateLocalUserWithEntityType() 호출에 제공된 것과 동일한 Entity ID와 연결되어 있으며 작업 수행 권한이 있는지 유효성을 검사합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다. PlayFab Entity Token은 PlayFab 로그인 작업의 출력에서 얻을 수 있으며 이 메서드에 대한 입력으로 제공될 수 있습니다. 토큰은 원래 PartyManager::CreateLocalUser() 또는 PartyManager::CreateLocalUserWithEntityType()에 지정된 동일한 PlayFab Entity ID 및 유형과 연결되어 있어야 합니다.
제공된
entityToken은 PartyManager::Initialize()에 전달된 것과 동일한 Title ID를 사용하여 획득한 것이어야 합니다. Party 라이브러리는 PartyManager::CreateNewNetwork() 또는 PartyNetwork::AuthenticateLocalUser()와 같이 로컬 사용자에 대한 인증 또는 권한 부여가 필요한 후속 작업에서 사용하기 위해 제공된 PlayFab Entity Token의 복사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않은 경우, 유효한 토큰이 필요한 작업은 실패합니다. 이 메서드를 다시 호출하여 새 유효 토큰을 Party 라이브러리에 제공할 수 있습니다.
이 메서드와 PartyManager::CreateLocalUser() 또는 PartyManager::CreateLocalUserWithEntityType()에 제공된 엔터티 토큰의 만료를 모니터링하는 것은 호출자의 책임입니다. 토큰이 만료 시간에 가까워지거나 만료된 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 이 메서드를 호출하여 Party 라이브러리에 제공해야 합니다. 이전에 제공된 토큰이 유효 기간의 절반을 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태로 들어가거나 애플리케이션 실행을 오랫동안 일시 중지시켜 토큰이 만료되기 전에 새로 고쳐지지 않을 수 있는 플랫폼에서는 실행이 재개되면 토큰의 만료 여부를 확인해야 합니다.
Requirements
Header: Party.hSee also
PartyLocalUserPartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser