Syntax
Parameters
entityId PartyString
로컬 사용자와 연결할 PlayFab Entity ID입니다.
titlePlayerEntityToken PartyString
로컬 사용자와 연결할 PlayFab Entity Token입니다.
localUser PartyLocalUser**라이브러리에서 할당된 출력 출력 로컬 사용자 객체입니다.
Return value
PartyError 로컬 사용자 만들기가 성공한 경우c_partyErrorSuccess, 그렇지 않으면 오류 코드입니다. 오류 코드의 사람이 읽을 수 있는 형식은 GetErrorMessage()를 통해 검색할 수 있습니다.
Remarks
이 메서드는 PlayFab Entity ID를entityId로, PlayFab Entity Token을 titlePlayerEntityToken으로 받습니다. entityId의 길이가 c_maxEntityIdStringLength보다 작거나 같은지 확인하는 것 외에 이러한 값에 대한 동기 유효성 검사는 수행되지 않습니다. 라이브러리가 네트워크 생성, 네트워크 인증 또는 음성-텍스트 변환 전사 수행과 같이 사용자 인증 또는 권한 부여가 필요한 작업을 수행할 때, Party 서비스는 토큰이 유효하고 만료되지 않았으며 제공된 Entity ID와 연결되어 있고 작업 수행 권한이 있는지 유효성을 검사합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다. PlayFab Entity ID와 Entity Token은 PlayFab 로그인 작업의 출력에서 얻어 이 메서드에 대한 입력으로 제공할 수 있습니다. PlayFab Entity ID는
title_player_account 유형이어야 하며, 이는 대부분의 개발자에게 가장 전통적인 방식으로 “플레이어”를 나타냅니다. 지원되는 다른 유형의 엔터티를 나타내는 사용자를 만들려면 CreateLocalUserWithEntityType()를 대신 사용하세요. 제공된
entityId 및 titlePlayerEntityToken은 Initialize()에 전달된 것과 동일한 Title ID를 사용하여 획득한 것이어야 합니다. Party 라이브러리는 CreateNewNetwork() 또는 PartyNetwork::AuthenticateLocalUser()와 같이 로컬 사용자에 대한 인증 또는 권한 부여가 필요한 후속 작업에서 사용하기 위해 제공된 PlayFab Entity Token의 복사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않은 경우 유효한 토큰이 필요한 작업은 실패합니다. PartyLocalUser::UpdateEntityToken() 호출을 통해 새 유효 토큰을 Party 라이브러리에 제공할 수 있습니다.
이 메서드와 PartyLocalUser::UpdateEntityToken()에 제공된 엔터티 토큰의 만료를 모니터링하는 것은 호출자의 책임입니다. 토큰이 만료 시간에 가까워지거나 만료된 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 PartyLocalUser::UpdateEntityToken()을 호출하여 Party 라이브러리에 제공해야 합니다. 이전에 제공된 토큰이 유효 기간의 절반을 지났을 때 새 토큰을 획득하는 것이 좋습니다. 저전력 상태로 들어가거나 애플리케이션 실행을 오랫동안 일시 중지시켜 토큰이 만료되기 전에 새로 고쳐지지 않을 수 있는 플랫폼에서는 실행이 재개되면 토큰의 만료 여부를 확인해야 합니다.
언제든지 최대
c_maxLocalUsersPerDeviceCount 개의 PartyLocalUser 객체만 동시에 존재할 수 있습니다. 이 메서드는 다른 로컬 사용자를 만드는 것이 그 제한을 초과할 경우 동기적으로 실패합니다. 성공적으로 반환되면 이 메서드는 GetLocalUsers()에서 이전에 반환된 배열의 메모리를 무효화합니다. 새 사용자를 배열에 동기적으로 추가하기 때문입니다. StartProcessingStateChanges()도 배열의 메모리를 무효화합니다. 반환된
localUser 객체는 PartyDestroyLocalUserCompletedStateChange가 생성되고 해당 객체를 참조하는 모든 상태 변경이 FinishProcessingStateChanges()에 반환될 때까지 유효합니다.
Requirements
Header: Party.hSee also
PartyManagerPartyDestroyLocalUserCompletedStateChange
PartyManager::Initialize
PartyManager::GetLocalUsers
PartyManager::CreateLocalUserWithEntityType
PartyManager::DestroyLocalUser
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser
PartyNetwork::RemoveLocalUser
PartyNetwork::CreateInvitation
PartyNetwork::RevokeInvitation
PartyNetwork::CreateEndpoint
PartyLocalUser::UpdateEntityToken
PartyLocalDevice::CreateChatControl