MPSD 초대 및 액티비티 문제 해결 가이드

다음 가이드는 MPSD를 사용하는 초대 및 액티비티 기능의 문제 해결에 타이틀을 지원하기 위한 출발점입니다. 이 MPSD 기능을 사용하다가 문제가 발생하는 타이틀 개발자는 먼저 사용된 MPSD 세션이 유효하고 MPSD 호출에서 다른 API 오류나 HTTP 오류가 없는지 확인해야 합니다. 오류가 없는 경우, 비활성화된 초대/액티비티 참가 UI는 대부분 잘못된 타이틀 또는 서비스 구성으로 인해 발생합니다. 이 경우 가장 좋은 문제 해결 방법은 다음 단계를 따르는 것입니다.

MPSD 세션이 닫혀 있거나 잠겨 있거나 가득 차 있지 않은지 확인합니다. 닫힌 세션("closed": true) 또는 가득 찬 세션에 대해서는 초대와 참가가 비활성화됩니다. 잠긴 MPSD 세션("locked": true)은 이전 세션 구성원의 재참가만 허용합니다.
테스트에 참여하는 모든 타이틀 인스턴스의 샌드박스 및 타이틀 ID를 확인합니다. 모든 타이틀 인스턴스는 동일한 샌드박스에 있고, 동일한 타이틀 ID(및 SCID)를 사용해야 하며, MPSD 세션 템플릿이 이 샌드박스에 구성되어 있어야 합니다.
MicrosoftGame.config 파일의 모든 ID가 올바르게 설정되어 있는지 확인합니다. MicrosoftGame.config에는 올바른 타이틀 ID, SCID 및 Identity 정보가 포함되어야 하며, 이는 타이틀에 대한 Partner Center 구성(‘Game Setup’에서 확인 가능)과 일치해야 합니다.
시나리오에 맞는 올바른 MPSD 세션 구성이 설정되어 있는지 확인합니다.
- inviteProtocol 상수가 MPSD 세션에 정의되어 있습니다. 올바른 초대 동작을 위해 타이틀은 "inviteProtocol": "game" 상수를 설정해야 합니다.
- MPSD 세션에 참가 제한이 포함되어 있지 않습니다. 팔로워가 아닌 사람의 참가를 방지하거나 참가를 전면 제한하지 않도록 joinRestriction 속성이 followed/local로 설정되어 있지 않은지 확인합니다.
- MPSD 세션의 userAuthorizationStyle 속성이 올바르게 설정되어 있습니다. userAuthorizationStyle 속성은 비콘솔 디바이스 MPSD 세션에 대해 활성화되어야 하며 joinRestriction(‘local’ 또는 ‘followed’)도 필요합니다. 이는 임의의 플레이어에 의한 참가를 방지하기 위한 시스템 제한이며 제거할 수 없습니다.
권장되는 MPSD 템플릿 구성은 다음과 같습니다.

     /Constants/System/Capabilities:
         "inviteProtocol" : "game"
         "userAuthorizationStyle": true   (required for non-console devices)
     /Properties/System:
         "joinRestriction" : "none"   (console only) - "followed" (non-console devices) will allow Joins as well as invites. - "local" invite only, no joins allowed.

초대/참가 문제가 크로스 디바이스 시나리오에만 국한된 것이 아닌지 확인합니다. 초대/참가 문제가 서로 다른 콘솔 유형(XBOX Series X|S, XBOX One) 간 또는 콘솔/PC 간에만 발생하는 경우, 타이틀 또는 MPSD 세션의 crossPlay 구성이 잘못되었을 수 있습니다. 기본적으로 XBOX One 디바이스는 XBOX Series X|S 디바이스 계열이 설정되지 않은 경우 크로스플레이를 지원합니다.
- 타이틀이 XBOX One 이상의 플랫폼에서 출시된 이후에는 Partner Center의 ‘XBOX Settings’/‘Device families’ 목록에서 관련된 모든 플랫폼이 활성화되어 있는지 확인합니다.
- 크로스플레이 MPSD 세션 기능이 활성화되어 있는지("crossPlay": true) 확인합니다.
권장되는 MPSD 템플릿 구성은 다음과 같습니다.

     /Constants/System/Capabilities:
         "crossPlay" : "true"   if you want to support crossPlay between supported deviceTypes (Xbox One as the only device in Partner Center default supports Xbox Series X|S)

세션의 소유권 동작이 초대 제한을 유발하지 않는지 확인합니다. hasOwners 및 세션 소유자가 설정된 세션은 비소유자가 초대를 보낼 수 있도록 allowNonOwnerInviteHandles도 true로 설정해야 합니다. 원하는 동작에 맞게 이 상수를 설정하세요.
Partner Center에서 타이틀의 디바이스 사용 가능 여부를 확인합니다. Partner Center의 ‘Game Setup’/‘Device family availability’ 설정은 타이틀의 기능과 사용 가능 여부를 제한할 수 있습니다. 관련된 모든 플랫폼이 활성화되어 있는지 확인하세요. 기본적으로 XBOX One 디바이스는 XBOX Series X|S 디바이스 계열이 설정되지 않은 경우 크로스플레이를 지원합니다.
타이틀이 Private Audience 그룹으로 제한되어 있지 않은지 확인합니다. 타이틀의 표시 여부를 Private Audiences로 제한(Partner Center의 ‘Pricing and availability’/‘Visibility’)하는 것은 타이틀 액세스 및 서비스 기능을 제한할 수 있습니다. 이 기능이 활성화되어 있다면 두 콘솔/사용자가 모두 Private Audience 그룹에 포함되어 있는지 확인하세요.
PC 타이틀의 경우 MicrosoftGame.config 파일에 MultiplayerProtocol 설정이 있는지 확인합니다. XBOX Game Bar UI와의 올바른 통합을 활성화하려면 Windows 타이틀에 대해 MultiplayerProtocol 설정을 true로 설정해야 합니다. 자세한 내용은 MicrosoftGame.config 개요를 참조하세요.
MPA와 MPSD 서비스 호출을 실수로 혼합하고 있지 않은지 확인합니다. MPSD 및 MPA 서비스는 동시에 사용할 수 없습니다. 그렇게 하면 예상치 못한 액티비티/참가/초대 동작이 발생할 수 있습니다. 타이틀은 반드시 하나의 서비스만 선택해야 합니다.

XBOX Services

PlayFab