MPA 초대 및 활동 문제 해결 가이드

다음 가이드는 MPA 서비스를 사용한 초대 및 활동 기능의 문제 해결을 돕기 위한 타이틀의 시작점입니다. 타이틀 개발자는 먼저 MPA API 호출에 대한 오류나 HTTP 오류가 없는지 확인해야 합니다. 오류가 없는 경우, 비활성화된 초대/활동 참여 UI는 가장 일반적으로 잘못된 타이틀 또는 서비스 구성으로 인해 발생합니다. 최선의 문제 해결 접근 방식은 다음 단계를 따르는 것입니다.

현재 활동에 제한하는 JoinRestriction이 없는지 확인합니다. Followed 또는 InviteOnly로 설정된 값은 참여 가능성을 제한합니다.
활동의 platform 속성 또는 allowCrossPlatformJoin 초대 플래그가 크로스플레이를 제한하지 않는지 확인합니다. 특정 platform 값(예: XboxOne)을 설정하면 활동 플랫폼 UI 참여와 초대가 해당 플랫폼으로 제한됩니다. allowCrossPlatformJoin 초대 플래그를 false로 설정하면 플랫폼 필드가 현재 플랫폼으로 자동으로 채워집니다. 초대는 해당 플랫폼의 플레이어만 받습니다.
테스트에 있는 모든 타이틀 인스턴스의 샌드박스 및 titleID를 확인합니다. 모든 타이틀 인스턴스는 동일한 샌드박스에 있어야 하며, 동일한 titleID(및 SCID)를 사용해야 하고, MPSD 세션 템플릿이 이 샌드박스에 구성되어 있어야 합니다.
MicrosoftGame.config 파일의 모든 ID가 올바르게 설정되었는지 확인합니다. MicrosoftGame.config에는 타이틀에 대한 파트너 센터 구성(‘Game Setup’에서 표시됨)과 일치하는 올바른 titleID, SCID 및 Identity 정보가 포함되어야 합니다.
파트너 센터에서 타이틀의 디바이스 가용성을 확인합니다. 파트너 센터의 ‘Game Setup’/‘Device family availability’ 설정은 타이틀의 기능과 가용성을 제한할 수 있습니다. 모든 관련 플랫폼이 활성화되었는지 확인합니다. 기본적으로, XBOX One 디바이스는 XBOX Series X|S 디바이스 패밀리가 설정되지 않은 경우 크로스 플레이를 지원합니다.
타이틀이 Private Audience 그룹으로 제한되지 않는지 확인합니다. 타이틀 가시성을 Private Audience로 제한하면(파트너 센터의 ‘Pricing and availability’/‘Visibility’) 타이틀 액세스와 서비스 기능이 제한될 수 있습니다. 예를 들어, 로그인한 사용자가 Private Audience의 일부가 아니면, 반환된 Recent Player 정보에는 올바른 타이틀 이름이 포함되지 않습니다. 이 기능이 활성화된 경우 두 콘솔/사용자 모두 Private Audience 그룹의 일부인지 확인합니다.
PC 타이틀의 경우 MultiplayerProtocol 설정이 MicrosoftGame.config 파일에 있는지 확인합니다. MultiplayerProtocol 설정은 XBOX Game Bar UI와의 올바른 통합을 활성화하기 위해 Windows 타이틀에서 true로 설정되어야 합니다. 자세한 내용은 MicrosoftGame.config 개요를 참조하세요.
실수로 MPA와 MPSD 서비스 호출을 혼합하지 않는지 확인합니다. MPSD와 MPA 서비스는 동시에 사용할 수 없습니다. 그렇게 하면 예상치 못한 활동/참여/초대 동작이 발생합니다. 타이틀은 하나의 서비스만 선택해야 합니다.
플랫폼 UI는 가득 찬 활동(currentPlayers가 maxPlayers와 동일)을 비활성화하지 않습니다. 이는 주로 경쟁 조건을 피하기 위한 것이지만, currentPlayers도 선택적 필드입니다. 가득 찬 상황에서 참여 가능성을 제한하려면, 활동을 삭제하거나 플레이어가 참여했을 때 가득 찬 오류 사례를 처리해야 합니다. 오류 메시지는 게임을 통해 이미 처리되어야 하므로 권장됩니다.

XBOX Services

PlayFab