PlayFab Party XBOX Live Helper 라이브러리
핵심 PlayFab Party 라이브러리와 함께, XBOX Live 정책과 그에 따른 XR을 준수하는 데 도움이 되도록 설계된 XBOX Live Helper 라이브러리를 제공합니다. 이 헬퍼 라이브러리의 사용은 필수는 아니지만 적극 권장되며 모범 사례로 간주됩니다. 여기에 제시된 예제에서는 XBOX Live Helper 라이브러리를 사용한다고 가정합니다.XBOX Live 사용자의 채팅 설정 및 권한과 PlayFab Party 정렬
PlayFab Party는 채팅 통신에 옵트인 모델을 사용하며, 기본적으로 두 채팅 컨트롤 간의 모든 통신을 두 참가자가 모두 활성화한 통신 집합으로 제한합니다. 자세한 내용은 채팅 권한 및 음소거에 대한 문서를 참조하세요. PlayFab Party의 XBOX Live Helper 라이브러리는 현재 Party 세션에서 통신 중인 XBOX Live 사용자의 기본 설정 및 권한에 맞추기 위해 어떤 채팅 권한 집합을 활성화해야 하는지 나타냅니다. 자세한 내용은 XBOX Live 사용자의 개인 정보 설정 및 권한 존중에 대한 문서를 참조하세요. PlayFab Party와 XBOX Live Helper 라이브러리를 적절히 활용하면, 게임은 XR-015에서 지정한 요구 사항을 완전히 충족하고 XR-045에서 지정한 관련 통신 요구 사항을 충족할 수 있습니다. PlayFab Party의 범위를 벗어난 추가 요구 사항은 XR-045 기술 문서를 참조하세요.멀티플레이어 세션 문서 유지 관리
PlayFab Party는 XBOX 사용자 명단을 제공하지 않습니다. 게임이 명단을 유지 관리하고 Party 네트워크 활동을 게임 세션의 사용자와 연결하기 위해 Multiplayer Session Directory 서비스(MPSD)를 사용하는 것에 의존합니다. PlayFab Party는 원격 엔드포인트와 채팅 컨트롤이 Party 네트워크에 들어오거나 나갈 때 이를 알립니다. 이러한 개체와 연관된 PlayFab 엔터티 ID는 MPSD 문서의 XBOX 사용자와 매칭되어 어떤 PlayFab Party 개체가 게임 세션의 XBOX 사용자를 나타내는지 인식해야 합니다. 크로스 플레이 시나리오에서는 XBOX 사용자와 연관되지 않은 PlayFab 엔터티가 다른 멀티플레이어 생태계의 사용자를 나타낼 수 있습니다. XBOX 사용자를 인식하려면 PlayFab 엔터티 ID와 XBOX Live 사용자 간의 매핑을 구축해야 합니다. 이를 달성하려면 세션의 XBOX Live 사용자 목록을 MPSD 문서에 저장하고 XBOX Live Helper 라이브러리를 사용하여 해당 XBOX Live 사용자를 PlayFab 엔터티 ID로 변환하는 것이 좋습니다. 예제는 XBOX Live 사용자 ID와 PlayFab 엔터티 ID 간의 매핑을 참조하세요. Party 네트워크의 명단을 제공하는 것 외에도, MPSD 문서는 매치메이킹, 플랫폼 초대, 최근 플레이어 목록, 진행 중 참여 같은 XBOX 멀티플레이어 생태계의 많은 멀티플레이어 경험을 구동합니다. Party 네트워크를 이러한 MPSD 흐름에 통합하는 방법에 대한 자세한 내용은 MPSD와 함께 PlayFab Party 사용을 참조하세요. 자세한 내용은 MPSD 개요를 참조하세요.크로스 플레이 Party 네트워크에서 XBOX 클라이언트 사용
크로스 플레이 시나리오의 경우, XBOX Live 생태계와 상호 작용할 때 다음 모범 사례를 염두에 두세요.크로스 네트워크 게임 세션에서 플레이어 식별
고유한 플레이어는 멀티플레이어 생태계 전반에서 식별 및 구별할 수 있어야 합니다. 이 목적을 위해 PlayFab Party는 세션의 사용자와 연관될 수 있는 다양한 개체(PartyLocalUser, PartyEndpoint, PartyChatControl)에서 PlayFab 엔터티 ID를 제공합니다.
크로스 네트워크 표시 이름은 PlayFab Party API에서 제공되지 않습니다. UI에 XBOX 사용자를 표시할 때는 게이머태그를 사용해야 하며, 게이머태그는 MPSD 문서의 XBOX 사용자 ID에서 해결되어야 합니다. XBOX가 아닌 사용자는 XR-007의 지침에 따라 UI에 표시되어야 합니다. 플랫폼에서 제공하는 표시 이름이 없는 경우, PlayFab은 GetPlayerProfile을 통해 표시 이름을 지원합니다. 네트워크에 참여할 때 플레이어는 다른 플레이어가 볼 수 있도록 공유 세션 문서에 표시 이름을 게시해야 합니다.
PlayFab Party 라이브러리는 일부 개체를 PlayFab 사용자(PlayFab 엔터티 ID를 통해)와 연관시키지만, 라이브러리는 PlayFab 사용자가 어떤 멀티플레이어 생태계와 연관될 수 있는지 식별하는 기능을 제공하지 않습니다. XBOX Live PlayFab 사용자를 다른 멀티플레이어 생태계의 사용자와 구별하려면 Party 네트워크의 PlayFab 엔터티 ID를 MPSD와 상호 참조하는 것이 좋습니다. MPSD를 통해 XBOX Live 플레이어를 XBOX Live가 아닌 플레이어와 구별하는 방법에 대한 자세한 내용은 멀티플레이어 세션 문서 유지 관리 섹션을 참조하세요.
XBOX Live와의 크로스 플레이 네트워크에서 사용자를 식별하는 요구 사항에 대한 자세한 내용은 XR-007을 참조하세요.
XBOX Live 사용자에 대한 크로스 네트워크 통신 권한 준수
PlayFab Party는 XBOX Live의 크로스 네트워크 통신 제한을 암묵적으로 준수하지 않습니다. 따라서 PlayFab Party XBOX Live Helper 라이브러리는 XBOX Live 사용자의 크로스 네트워크 통신 권한을 쿼리하는 기능을 제공합니다. XR-007에서 지정한 크로스 네트워크 통신 요구 사항을 준수하려면 이 정보를 사용해야 합니다. 자세한 내용은 크로스 네트워크 통신 준수를 참조하세요.크로스 플레이가 허용되지 않을 때 네트워크 액세스를 제한하기 위해 PlayFab Party 초대 사용.
XBOX Live 사용자는 크로스 네트워크 게임 세션에서 XBOX Live가 아닌 사용자와 상호 작용하려면 크로스 네트워크 권한이 필요합니다. PlayFab Party는 이러한 크로스 네트워크 제한(XR-007에 설명됨)을 암묵적으로 준수하지 않으므로, 이 권한은 PlayFab Party 라이브러리 외부에서 쿼리해야 합니다. 이러한 권한이 부여되지 않은 경우, 게임 세션의 MPSD 문서에 알려진 XBOX Live 사용자만 허용하도록 Party 네트워크를 제한해야 합니다. 알려진 XBOX 사용자만 네트워크에 참여할 수 있도록 하는 Party 초대를 사용하기 위해 샘플 진행 중 참여 흐름을 확장하여 이를 달성할 수 있습니다. 먼저, Party 네트워크가 제한된 초대로 생성되도록 합니다.XBOX Live 사용자 ID와 PlayFab 엔터티 ID 간에 변환해야 하므로, 이 둘 사이의 매핑을 구축하는 것이 좋습니다. 이를 수행하는 방법에 대한 예제는 XBOX Live 사용자 ID와 PlayFab 엔터티 ID 간의 매핑을 참조하세요.
XBOX Live 프로필 설정과의 동기화 유지
PlayFab Party는 기본적으로 XR-048의 프로필 설정 요구 사항을 준수합니다. 라이브러리는 XBOX Live 프로필 설정의 영구 캐시를 유지하지 않습니다. PlayFab Party의 사용을 위해 프로필 설정이 필요할 때, 설정은 XBOX Live에서 쿼리되며 해당 설정과 연관된 PlayFab Party API 개체의 수명 동안 유효하게 유지되지만 개체의 여러 인스턴스에 걸쳐 지속되지는 않습니다. PlayFab Party 외부에서 XBOX Live 프로필 설정 데이터를 사용하는 방법에 대한 정보는 XR-048 기술 문서를 참조하세요.플랫폼 멀티플레이어 참여 흐름 지원
XBOX에서 플레이어는 진행 중 참여 및 플랫폼 초대 기능을 통해 멀티플레이어 게임에 참여할 수 있습니다. PlayFab Party는 이러한 플랫폼 기능과 직접 통합되지는 않지만,PartyNetworkDescriptor 및 PartyInvitation 개체를 통해 그 사용을 지원합니다. PartyNetworkDescriptor 개체는 원격 사용자가 Party 네트워크를 찾고 연결하는 데 필요한 연결 정보를 제공하며 PartyManager::SerializeNetworkDescriptor를 통해 직렬화할 수 있습니다. PartyInvitation 개체는 원격 사용자에게 Party 네트워크에 인증하고 참여하는 데 사용되는 ID를 제공합니다. 원격 사용자가 진행 중 참여 및 플랫폼 초대를 통해 멀티플레이어 게임에 참여할 수 있도록 하려면, 직렬화된 네트워크 설명자와 Party 초대 식별자를 기존 흐름에 통합하세요. 예제 흐름은 MPSD와 함께 PlayFab Party 사용 문서에서도 확인할 수 있습니다.
플랫폼 멀티플레이어 참여 흐름 요구 사항에 대한 자세한 내용은 XR-064 및 XR-124 기술 문서를 참조하세요.
친구 목록
PlayFab Party는 어떤 플랫폼의 친구 목록과도 기본적으로 상호 작용하지 않지만, 멀티플레이어 게임은 다양한 시나리오에서 여전히 친구 목록을 고려해야 할 수 있습니다. XBOX Live 및 크로스 네트워크 친구 목록과 상호 작용할 때의 요구 사항 및 지침에 대한 정보는 다음 문서를 참조하세요.- XBOX Live 친구 목록 요구 사항(XR-070)
- 크로스 네트워크 친구 목록 요구 사항(XR-007)
- XBOX Social Manager
- XBOX Live Services API(XSAPI)
