활동

이 항목에서는 다른 플레이어에게 참가 가능한 멀티플레이어 경험을 광고하는 방법에 대해 설명합니다. 그런 다음 환경에 참여할 수 있습니다.

활동 사용

플레이어가 멀티플레이어 환경을 시작하거나 참가하면 타이틀은 활동을 만들어 이를 멀티플레이어 활동(MPA)에 알려야 합니다. 세션 기반 모델과 달리 활동은 플레이어 단위입니다. 각 플레이어는 함께 플레이하더라도 자신만의 활동을 만들어야 합니다.

플레이어가 멀티플레이어 환경에 들어가면 즉시 타이틀은 이 활동을 만들어야 합니다. 경험 중에 플레이어 수가 증가하거나 감소하면 타이틀이 활동을 수정해야 합니다. 플레이어가 멀티플레이어 경험을 끝내거나 나가면 타이틀은 활동을 삭제해야 합니다. 타이틀 충돌이 있거나 활동 제거에 실패하는 경우 MPA는 플레이어가 타이틀 재생을 중지했음을 탐지하면 활동을 제거하려고 시도합니다. 업데이트가 없는 활동은 24시간 후에 자동으로 제거됩니다.

활동 내용

활동에는 다음 표에 표시된 정보가 포함됩니다.

필드	용도	참고
xuid	활동을 작성한 사용자의 XboxUserId입니다.	활동을 쿼리할 때만 사용됩니다. 플레이어는 자신을 위한 활동만 설정할 수 있습니다.
connectionString	MPA에 불투명하게 보이는 타이틀로 정의된 문자열입니다. 타이틀이 다른 플레이어에 연결할 때 이용할 수 있는 정보가 들어 있습니다.	512자 미만이어야 합니다.
joinRestriction	이 활동에서 연결 문자열을 볼 수 있는 사람을 나타냅니다. 자세한 내용은이 항목 뒷부분의 개인 정보 섹션을 참조하세요.	Public, Followed, InviteOnly이어야 합니다.
maxPlayers	이 활동에서 허용되는 최대 플레이어 수입니다.	선택 사항. 지정된 경우 1보다 크고 100보다 작거나 같아야 합니다.
currentPlayers	이 활동의 ​​현재 플레이어 수입니다.	선택 사항. 지정된 경우 0보다 크고 100보다 작거나 같아야 합니다.
groupId	타이틀로 정의된 ID입니다. 동일한 groupId을(를) 가진 플레이어는 MPA에서 함께 플레이하는 것으로 인식됩니다.	128자 미만이어야 하며, 그룹 ID에만 사용해야 합니다.
platform	특정 플랫폼으로 설정하면 초대를 통한 교차 플레이를 제한하고 해당 플랫폼에만 참여합니다. 설정되지 않으면 정의된 모든 플랫폼과의 교차 플레이가 가능합니다.	자세한 내용은이 항목 뒷부분의 교차 플레이 활동 지원 섹션을 참조하세요.

개인 정보 보호

타이틀은 소셜 그래프에 있는 플레이어의 일부만 플레이어에 참여하도록 허용할 수 있습니다. joinRestriction 필드는 다른 플레이어가 이 활동을 볼 때 연결 문자열을 받을지 여부를 결정합니다. 값과 의미는 다음 표에 나와 있습니다.

값	의미
Public	모든 플레이어가 이 활동에 참여할 수 있습니다.
Followed	활동 작성자가 다른 플레이어를 팔로우하면 해당 플레이어가 참여할 수 있습니다.
InviteOnly	초대에 응답하지 않는 한 어떤 플레이어도 이 활동에 참여할 수 없습니다.

교차 플레이 활동 지원

Microsoft GDK(게임 개발 키트)에서 활동을 만들 때 타이틀에서 allowCrossplay 플래그를 지정할 수 있습니다. false의 경우, Microsoft GDK(게임 개발 키트)는 초대 플랫폼 필드를 현재 플랫폼으로 자동으로 채웁니다. true의 경우, Microsoft GDK(게임 개발 키트)는 플랫폼 필드 null을(를) 나가며, 이는 초대가 크로스 플랫폼임을 나타냅니다. 교차 플레이를 통해 허용되는 플랫폼 목록은 타이틀 구성에 의해 정의됩니다. 이 시나리오에서는 콘솔 세대가 교차 플레이로 간주됩니다.

활동 가져오기

다른 플레이어의 활동을 검색할 때 연결 문자열이 숨겨져 있는 경우가 있습니다. 이는 플레이어가 이 활동에 참여할 수 없음을 나타냅니다. 예를 들어, 활동의 joinRestriction 때문에 연결 문자열이 숨어 있을 수도 있습니다. 활동이 만원입니다.