PartyManager::CreateLocalUser
네트워킹 및 채팅 작업을 수행할 때 로컬 사용자를 나타내는 데 사용되는 로컬 사용자 개체를 만듭니다.
구문
PartyError CreateLocalUser(
PartyString entityId,
PartyString titlePlayerEntityToken,
PartyLocalUser** localUser
)
매개 변수
entityIdPartyString
로컬 사용자와 연결할 PlayFab 엔터티 ID입니다.
titlePlayerEntityTokenPartyString
로컬 사용자와 연결할 PlayFab 엔터티 토큰입니다.
localUserPartyLocalUser**
라이브러리에서 할당한 출력
출력 로컬 사용자 개체입니다.
반환 값
PartyError
로컬 사용자 만들기에 성공하면 c_partyErrorSuccess이고, 그렇지 않은 경우 오류 코드입니다. 사용자가 읽을 수 있는 형식의 오류 코드는 GetErrorMessage()를 통해 검색할 수 있습니다.
비고
이 메서드는 PlayFab 엔터티 ID를 entityId로 사용하고 PlayFab 엔터티 토큰을 titlePlayerEntityToken으로 사용합니다. entityId의 길이가 c_maxEntityIdStringLength보다 작거나 같은 경우를 제외하고 이러한 값에 대한 동기 유효성 검사가 수행되지 않습니다. 라이브러리에서 네트워크 만들기, 네트워크에 인증, 음성 번역 등과 같이 사용자 인증이나 권한 부여가 필요한 작업을 수행하는 경우 파티 서비스에서는 토큰이 유효하고, 만료되지 않았고, 제공된 엔터티 ID와 연결되어 있고, 작업을 수행할 권한이 있는지 확인합니다. 이러한 조건이 충족되지 않으면 작업이 실패합니다.
PlayFab 엔터티 ID 및 엔터티 토큰은 PlayFab 로그인 작업의 출력에서 가져온 다음 이 메서드의 입력으로 제공할 수 있습니다. PlayFab 엔터티 ID는 대부분의 개발자에게 “플레이어”를 나타내는 가장 일반적인 방식인 title_player_account 형식이어야 합니다.
제공되는 entityId 및 titlePlayerEntityToken은 Initialize()에 전달된 것과 동일한 타이틀 ID를 사용하여 얻어야 합니다.
파티 라이브러리에서는 CreateNewNetwork() 또는 PartyNetwork::AuthenticateLocalUser() 같이 로컬 사용자의 인증이나는 권한 부여가 필요한 후속 작업에 사용하기 위해 제공된 PlayFab 엔터티 토큰의 복사본을 만듭니다. 이 호출에 제공된 토큰이 만료되었거나 유효하지 않으면 유효한 토큰이 필요한 작업이 실패합니다. 호출을 통해 파티 라이브러리에 유효한 새 토큰을 제공할 수 있습니다.
호출자는 이 메서드 및 PartyLocalUser::UpdateEntityToken()에 제공된 엔터티 토큰의 만료를 모니터링합니다. 토큰의 만료 시간이 가까워지거나 지난 경우 PlayFab 로그인 작업을 수행하여 새 토큰을 얻고 PartyLocalUser::UpdateEntityToken()을 호출하여 파티 라이브러리에 토큰을 제공해야 합니다. 이전에 제공된 토큰의 유효 기간이 중간쯤 지났을 때 새 토큰을 얻는 것이 좋습니다. 저전력 상태로 들어가거나 기타 이유로 애플리케이션 실행이 오랫동안 일시 중지하여 토큰이 만료 전에 새로 고쳐지지 않게 될 수 있는 플랫폼에서는 실행이 재개되면 토큰이 만료되었는지 확인해야 합니다.
c_maxLocalUsersPerDeviceCount PartyLocalUser 개체만 지정된 시간에 동시에 있을 수 있습니다. 다른 로컬 사용자를 만들어 해당 제한이 초과되면 이 메서드가 동기적으로 실패합니다.
반환이 성공적이면 이 메서드는 GetLocalUsers()에서 이전에 반환된 모든 배열에 대한 메모리를 무효화합니다. 이 메서드는 새 사용자를 배열에 동기적으로 추가합니다. StartProcessingStateChanges()는 배열의 메모리도 무효화합니다. 반환된 localUser 개체는 PartyDestroyLocalUserCompletedStateChange가 생성되고 개체를 참조하는 모든 상태 변경 내용이 FinishProcessingStateChanges()에 반환될 때까지 유효합니다.
요구 사항
헤더: Party.h
참고 항목
PartyManager
PartyDestroyLocalUserCompletedStateChange
PartyManager::Initialize
PartyManager::GetLocalUsers
PartyManager::DestroyLocalUser
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser
PartyNetwork::RemoveLocalUser
PartyNetwork::CreateInvitation
PartyNetwork::RevokeInvitation
PartyNetwork::CreateEndpoint
PartyLocalUser::UpdateEntityToken
PartyLocalDevice::CreateChatControl