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

아티클
05/09/2023

다음 가이드는 MPSD를 사용하여 초대 및 활동 기능 문제를 해결하여 타이틀을 지원하기 위한 시작점입니다.

이 MPSD 기능을 사용하고 문제가 발생하는 타이틀 개발자는 먼저 사용된 MPSD 세션이 유효하고 MPSD 호출 또는 HTTP 오류에 대한 다른 API 오류가 없는지 확인해야 합니다.

오류가 없다면 초대/활동 참여 UI 비활성화 문제는 잘못된 타이틀 또는 서비스 구성으로 인해 발생하는 것이 가장 일반적입니다.

가장 좋은 문제 해결 방법은 다음 단계를 따르는 것입니다.

MPSD 세션이 닫히거나 잠겨 있지 않거나 꽉 찼는지 확인합니다.
닫혀 있거나("closed": true) 전체 세션에 대해 초대 및 참여가 비활성화됩니다. 잠긴 MPSD 세션("locked": true)은 이전 세션 구성원의 재참여만 허용합니다.
테스트에 포함된 모든 타이틀 인스턴스의 샌드박스 및 titleID를 확인합니다.
모든 타이틀 인스턴스는 동일한 샌드박스에 있어야 하고 동일한 titleID(및 SCID)를 사용해야 하며, 이 샌드박스에서 MPSD 세션 템플릿을 구성해야 합니다.
MicrosoftGame.config 파일의 모든 ID가 올바르게 설정되었는지 확인합니다.
MicrosoftGame.config에는 올바른 titleID, SCID 및 타이틀에 대한 파트너 센터 구성('게임 설정'에 표시됨)과 일치하는 ID 정보가 포함되어야 합니다.
시나리오에 올바른 MPSD 세션 구성이 있는지 확인하세요.
- invokeProtocol 상수는 MPSD 세션에서 정의됩니다. 타이틀은 올바른 초대 동작을 위해 "inviteProtocol": "game" 상수를 설정해야 합니다.
- MPSD 세션에는 참가 제한이 없습니다. 비 팔로워의 참가를 방지하거나 참가를 완전히 제한하려면 joinRestriction 속성이 팔로우/로컬로 설정되지 않았는지 확인하세요.
- 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 세션의 교차 플레이 구성이 올바르지 않을 수 있습니다. 기본적으로 Xbox One 장치는 Xbox Series X|S 장치 패밀리가 설정되지 않은 경우 교차 플레이를 지원합니다.
- 타이틀이 Xbox One 이외의 추가 플랫폼에 출시되면 파트너 센터 'Xbox 설정'/'장치 제품군' 목록에서 모든 관련 플랫폼이 활성화되어 있는지 확인하세요.
- 교차 플레이 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로 설정해야 합니다. 원하는 동작에 맞게 이 상수 설정
파트너 센터에서 타이틀의 장치 사용 가능 여부를 확인합니다.
파트너 센터의 '게임 설정'/'장치 패밀리 사용 가능 여부' 설정은 타이틀의 기능과 사용 가능 여부를 제한할 수 있습니다. 모든 관련 플랫폼이 활성화되어 있는지 확인합니다. 기본적으로 Xbox One 장치는 Xbox Series X|S 장치 패밀리가 설정되지 않은 경우 교차 플레이를 지원합니다.
타이틀이 비공개 대상 그룹으로 제한되지 않았는지 확인합니다.
타이틀 가시성을 비공개 대상 그룹(파트너 센터의 '가격 책정 및 사용 가능 여부'/'가시성')으로 제한하면 타이틀 액세스 및 서비스 기능이 제한될 수 있습니다. 이 기능을 사용하는 경우 콘솔/사용자가 모두 해당 비공개 대상 그룹에 속해 있는지 확인합니다.
PC 타이틀용 MicrosoftGame.config 파일에 MultiplayerProtocol 설정이 있는지 확인합니다.
Xbox Game Bar UI를 올바르게 통합하려면 Windows 타이틀에 대해 MultiplayerProtocol 설정을 true로 설정해야 합니다. 자세한 내용은 MicrosoftGame.config 개요를 참조하세요.
MPA 및 MPSD 서비스 호출을 실수로 혼합해서 사용하고 있지 않은지 확인합니다.
MPSD 및 MPA 서비스는 동시에 사용할 수 없습니다. 동시에 사용할 경우 예기치 않은 활동/참여/초대 동작이 발생합니다. 타이틀은 하나의 서비스만 선택해야 합니다.

다음을 통해 공유

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

추가 리소스