PartyNetwork::CreateInvitation

네트워크에 대한 초대를 만들기 위한 비동기 시도를 큐에 넣습니다.

구문

PartyError CreateInvitation(  
    const PartyLocalUser* localUser,  
    const PartyInvitationConfiguration* invitationConfiguration,  
    void* asyncIdentifier,  
    PartyInvitation** invitation  
)  

매개 변수

localUserPartyLocalUser*

네트워크에서 초대를 소유하는 로컬 사용자입니다. 어떤 이유로든 이 로컬 사용자가 네트워크를 벗어나면 초대가 자동으로 취소됩니다.

invitationConfigurationPartyInvitationConfiguration*
선택 사항

새로 만든 초대에 대해 선택적으로 지정된 구성입니다.

이 값이 null이면 기본 구성 값이 사용됩니다. 기본적으로 PlayFab 파티에서는 타이틀에 고유한 초대 식별자를 생성합니다. 취소 가능성은 PartyInvitationRevocability::Creator이고, PlayFab 엔터티 ID 목록은 비어 있으므로 모든 사용자가 초대를 사용하여 참가할 수 있습니다.

구성이 제공된 경우 타이틀은 필요에 따라 구성에서 식별자를 지정할 수 있습니다. 식별자가 nullptr 또는 빈 문자열인 경우 PlayFab 파티 라이브러리에서 타이틀에 대한 식별자를 생성합니다. 이 생성된 식별자는 PlayFab 파티 라이브러리가 모든 디바이스에서 이 네트워크의 초대에 대해 이미 생성한 모든 식별자와 다름을 보장합니다. 타이틀은 구성에서 null이 아니고 비어 있지 않은 값을 제공하여 고유 식별자를 지정할 수 있습니다. 타이틀이 식별자를 지정하는 경우 이 식별자가 모든 디바이스에서 PartyManager::CreateNewNetwork() 또는 CreateInvitation()을 통해 이 네트워크에 생성되는 다른 초대의 식별자와 충돌하지 않도록 하는 것은 타이틀의 책임입니다. 타이틀이 기존 초대와 충돌하는 식별자를 사용하여 초대를 만들려고 하면 작업이 비동기적으로 실패하고 타이틀은 PartyInvitationDestroyedStateChange와 PartyCreateInvitationCompletedStateChange 실패 결과를 받습니다.

구성이 제공된 경우 취소 가능성은 PartyInvitationRevocability::Creator입니다.

구성이 제공되고 PlayFab 엔터티 ID 목록이 비어 있으면 모든 사용자가 새 초대를 사용하여 참가할 수 있습니다.

asyncIdentifier void*

완료 상태 변경을 이 호출과 연결하는 데 사용할 수 있는 선택적 앱 정의 포인터 크기의 컨텍스트 값입니다.

invitationPartyInvitation**
선택적 라이브러리 할당 출력

AuthenticateLocalUser()를 통해 네트워크에서 사용자 인증을 큐에 넣는 데 즉시 사용할 수 있는 선택적 출력 초대입니다.

반환 값

PartyError

초대를 만드는 비동기 작업이 시작되는 경우는 c_partyErrorSuccess이며 그렇지 않은 경우 오류 코드입니다. 이 메서드가 실패하면 관련 상태 변경 내용이 생성되지 않습니다. 사용자가 읽을 수 있는 형식의 오류 코드는 PartyManager::GetErrorMessage()를 통해 검색할 수 있습니다.

비고

네트워크에 가입하려면 사용자가 AuthenticateLocalUser()에 초대를 제공해야 합니다.

이 메서드는 네트워크에 대한 초대를 만들기 위한 비동기 시도를 큐에 넣습니다. 비동기 작업이 완료되면 성공 또는 실패를 나타내는 PartyCreateInvitationCompletedStateChange가 제공됩니다. 성공하면 투명한 클라우드 릴레이 서버가 초대의 식별자를 사용하여 인증을 수락할 준비가 되었음을 나타내기 위해 PartyInvitationCreatedStateChange가 미리 생성됩니다. 실패하면 초대 개체가 더 이상 유효하지 않으며 GetInvitations()통해 더 이상 쿼리할 수 없음을 나타내기 위해 PartyInvitationDestroyedStateChange가 미리 생성됩니다.

초대의 수명은 네트워크에서 소유 로컬 사용자의 멤버십과 관련되므로 localUser이(가) 인증하거나 인증하는 중이어야 합니다. 어떤 이유로든 localUser이(가) 네트워크를 벗어나면 초대가 자동으로 취소되고 해당 식별자를 사용하여 새 초대를 만들 때까지 해당 초대의 식별자를 사용하여 네트워크에 가입하려는 연속적 시도가 실패합니다.

이 메서드를 사용하여 만든 초대는 초대를 만든 로컬 장치에서 GetInvitations()를 통해서만 쿼리할 수 있습니다.

반환이 성공적이면 이 메서드는 GetInvitations()에서 이전에 반환된 모든 배열에 대한 메모리를 무효화합니다. 이 메서드는 새 초대를 배열에 동기적으로 추가합니다. PartyManager::StartProcessingStateChanges()는 배열의 메모리도 무효화합니다. 반환된 invitation 개체는 PartyInvitationDestroyedStateChange가 생성되고 개체를 참조하는 모든 상태 변경이 PartyManager::FinishProcessingStateChanges()에 반환될 때까지 유효합니다.

요구 사항

헤더: Party.h

참고 항목

PartyNetwork
PartyInvitationRevocability
PartyNetwork::AuthenticateLocalUser
PartyInvitationCreatedStateChange
PartyCreateInvitationCompletedStateChange
PartyInvitationDestroyedStateChange
PartyManager::CreateNewNetwork