Skip to main content
게임이 XBOX 콘솔을 대상으로 하는 경우, XBOX Live와 상호 작용할 때 일관된 기능과 동작을 보장하기 위해 일련의 요구 사항을 준수해야 합니다. 이 요구 사항 집합은 XBOX 요구 사항(줄여서 XRs)에 나열되어 있습니다. XR은 PC 및 기타 플랫폼에서 게임에서 XBOX Live를 사용하는 데 필요한 정책과 상호 작용하고 중복됩니다. 여기서는 이러한 요구 사항을 준수하는 데 도움이 되는 PlayFab Party 모범 사례를 설명합니다. 빠른 참조를 위해 PlayFab Party 시나리오와 이들이 다루는 XR을 매칭한 다음 표를 참조하세요.

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 개요를 참조하세요.
이 섹션에서는 MPSD와 함께 PlayFab Party를 사용할 때의 모범 사례를 제공하지만, PlayFab Party 자체는 XR-067의 MPSD 요구 사항을 암묵적으로 충족하지 않습니다. 이러한 요구 사항을 충족하는 방법에 대한 정보는 XR-067 기술 문서를 참조하세요.

크로스 플레이 Party 네트워크에서 XBOX 클라이언트 사용

크로스 플레이 시나리오의 경우, XBOX Live 생태계와 상호 작용할 때 다음 모범 사례를 염두에 두세요.
이 섹션에서는 XBOX Live와의 크로스 플레이 시나리오에서 PlayFab Party를 사용하기 위한 모범 사례를 제공하지만, PlayFab Party의 사용은 XR-007의 크로스 플레이 요구 사항을 암묵적으로 충족하지 않습니다. 이러한 요구 사항을 충족하는 방법에 대한 정보는 XR-007 기술 문서를 참조하세요.

크로스 네트워크 게임 세션에서 플레이어 식별

고유한 플레이어는 멀티플레이어 생태계 전반에서 식별 및 구별할 수 있어야 합니다. 이 목적을 위해 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 사용자가 네트워크에 참여하려는 경우 먼저 세션 문서에 자신을 추가합니다. 네트워크에 허용하려는 플레이어가 업데이트를 확인하면, 세션 문서를 반영하도록 초대 집합을 업데이트합니다. 이렇게 하면 세션 문서에 있는 사용자(XBOX Live 사용자로 보장됨)만 네트워크에 참여할 수 있습니다.
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는 이러한 플랫폼 기능과 직접 통합되지는 않지만, PartyNetworkDescriptorPartyInvitation 개체를 통해 그 사용을 지원합니다. PartyNetworkDescriptor 개체는 원격 사용자가 Party 네트워크를 찾고 연결하는 데 필요한 연결 정보를 제공하며 PartyManager::SerializeNetworkDescriptor를 통해 직렬화할 수 있습니다. PartyInvitation 개체는 원격 사용자에게 Party 네트워크에 인증하고 참여하는 데 사용되는 ID를 제공합니다. 원격 사용자가 진행 중 참여 및 플랫폼 초대를 통해 멀티플레이어 게임에 참여할 수 있도록 하려면, 직렬화된 네트워크 설명자와 Party 초대 식별자를 기존 흐름에 통합하세요. 예제 흐름은 MPSD와 함께 PlayFab Party 사용 문서에서도 확인할 수 있습니다. 플랫폼 멀티플레이어 참여 흐름 요구 사항에 대한 자세한 내용은 XR-064XR-124 기술 문서를 참조하세요.

친구 목록

PlayFab Party는 어떤 플랫폼의 친구 목록과도 기본적으로 상호 작용하지 않지만, 멀티플레이어 게임은 다양한 시나리오에서 여전히 친구 목록을 고려해야 할 수 있습니다. XBOX Live 및 크로스 네트워크 친구 목록과 상호 작용할 때의 요구 사항 및 지침에 대한 정보는 다음 문서를 참조하세요.

XBOX Live 서비스 재시도 정책 및 서비스 액세스 제한 준수.

PlayFab Party는 XBOX Live Helper 라이브러리 외에는 XBOX Live 서비스와 직접 상호 작용하지 않습니다. XBOX Live Helper 라이브러리는 내부적으로 XR-074XR-132에서 설명된 관련 XBOX Live 서비스에 대한 재시도 정책과 액세스 제한을 준수합니다. 또한 XBOX Live Helper 라이브러리에서 보고하는 다음 오류 코드를 통해 이러한 서비스 정책 준수의 결과로 API 실패를 인식할 수 있습니다: PartyXblChatPermissionMaskReason::XboxLiveServiceErrorPartyXblStateChangeResult::PartyServiceError. XBOX Live Helper 라이브러리 외부에서 이러한 서비스 정책을 준수하는 방법에 대한 자세한 내용은 XR-074XR-132 기술 문서를 참조하세요.
마지막 수정일 2026년 9월 1일