다음을 통해 공유

PartyManager::SerializeNetworkDescriptor

  • 아티클

네트워크 설명자 구조를 타이틀 및 플랫폼별 통신 채널을 통해 안전하게 통신할 수 있는 불투명 문자열로 직렬화합니다.

구문

PartyError SerializeNetworkDescriptor(  
    const PartyNetworkDescriptor* networkDescriptor,  
    char* serializedNetworkDescriptorString  
)

매개 변수

networkDescriptorPartyNetworkDescriptor*

직렬화할 네트워크 설명자입니다.

serializedNetworkDescriptorString char*
크기가 c_maxSerializedNetworkDescriptorStringLength+1인 출력 문자열 버퍼

직렬화된 네트워크 설명자 문자열이 기록되는 출력 버퍼입니다. 직렬화된 네트워크 설명자 문자열에는 ASCII가 아닌 문자, 제어 문자, JSON 또는 XML 이스케이프가 필요한 기타 문자가 포함되지 않습니다.

반환 값

PartyError

설명자가 직렬화 가능하고 성공적으로 직렬화된 경우 c_partyErrorSuccess이고 그렇지 않은 경우 오류 코드입니다.

비고

네트워크 설명자에는 장치를 설명자가 연결된 네트워크에 연결하는 데 필요한 모든 정보가 있습니다. serializedNetworkDescriptorString은 networkDescriptor에 의해 지정된 설명자의 직렬화된 형식이며 타이틀 및 플랫폼별 통신 채널을 통해 안전하게 통신할 수 있습니다. 문자열은 null 종결자를 포함하지 않고 길이가 최대 c_maxSerializedNetworkDescriptorStringLength자일 수 있으며 ASCII가 아닌 문자, 제어 문자, JSON 또는 XML 이스케이프가 필요한 기타 문자를 포함하지 않습니다.

네트워크 설명자를 직렬화할 수 없는 경우 이 메서드가 실패합니다. 예를 들어 CreateNewNetwork() 호출에서 동기적으로 제공한 설명자는 원격 클라이언트가 새 네트워크에 연결하는 데 필요한 정보가 부족하므로 직렬화할 수 없습니다. PartyCreateNewNetworkCompletedStateChange가 제공되고 성공을 나타내면 네트워크 설명자가 변경되고 직렬화할 수 있게 됩니다. 업데이트된 네트워크 설명자는 PartyCreateNewNetworkCompletedStateChange의 필드로 제공됩니다. 네트워크에 연결되면 PartyNetwork::GetNetworkDescriptor()를 사용하여 설명자를 검색할 수 있습니다.

PartyNetworkDescriptors를 PartyInvitations와 함께 사용하면 원격 사용자를 네트워크에 참가하도록 간편하게 초대할 수 있습니다. 먼저 PartyNetwork::GetNetworkDescriptor()를 통해 네트워크 설명자를 가져오고 SerializeNetworkDescriptor()를 통해 직렬화합니다. 다음으로 PartyNetwork::CreateInvitation()을 통해 초대를 생성하거나 PartyNetwork::GetInvitations()를 통해 기존 초대를 쿼리하고 가져옵니다. 마지막으로 플랫폼별 초대 메커니즘의 페이로드에 직렬화된 네트워크 설명자와 초대 식별자를 모두 포함합니다. 원격 사용자가 초대를 받으면 DeserializeNetworkDescriptor()를 통해 플랫폼 초대 페이로드에서 네트워크 설명자를 역직렬화하고 역직렬화된 설명자를 ConnectToNetwork()로 전달합니다. 연결 후에 원격 사용자는 플랫폼 초대 페이로드의 초대 식별자로 PartyNetwork::AuthenticateLocalUser()를 통해 네트워크에 인증하여 참가합니다.

이 메서드는 Initialize() 메서드 이전에 호출해야 합니다.

요구 사항

헤더: Party.h

참고 항목

PartyManager
PartyManager::DeserializeNetworkDescriptor
PartyNetwork::GetNetworkDescriptor
PartyManager::ConnectToNetwork
PartyInvitation
PartyNetwork::CreateInvitation
PartyNetwork::GetInvitations
PartyInvitation::GetInvitationConfiguration
PartyNetwork::AuthenticateLocalUser