POST (/handles)
사용자의 현재 활동에 멀티 플레이어 세션을 설정하고 필요 시 세션 멤버를 초대합니다.
중요:
이 메서드는 2015 멀티 플레이어에서 사용되며 해당 멀티 플레이어 버전 및 그 이상에서만 적용됩니다. 이는 템플릿 계약 104/105 이상에서 사용하기 위한 것이며 모든 요청마다 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.
설명
이 HTTP/REST 메서드는 현재 활동에 세션을 설정할 때 사용할 수 있습니다. 이 경우, 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync로 래핑될 수 있습니다. 요청 본문에서는 JSON 파일의 sessionRef 개체를 사용하고 유형 필드에 "activity"를 사용하여 세션 참조를 정의해야 합니다. 응답 본문은 검색하지 않습니다. 세션 참조에 지정된 항목들의 정의에 대해서는 Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference를 참조하세요.
이 POST 메서드는 핸들이 지정하는 사용자를 세션에 초대할 때도 사용할 수 있습니다. 이 경우, 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync로 래핑될 수 있습니다. POST 메서드를 이렇게 사용하려면 요청 본문에서 세션 참조를 정의하되, 필드 유형을 "invite"로 해야 합니다. 응답 본문은 초대 핸들입니다.
URI 매개 변수
없음
HTTP 상태 코드
이 서비스는 MPSD에 적용할 때 HTTP 상태 코드를 반환합니다.
요청 본문
활동을 설정하기 위한 요청 본문
{
"version": 1,
"type": "activity",
"sessionRef": {
"scid": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862",
"templateName": "deathmatch",
// The session name is optional in a POST; if not specified, MPSD fills in a GUID.//
"name": "session-49"
},
}
초대를 보내기 위한 요청 본문
{
// Common handle fields
"id: "47ca0049-a5ba-4bc1-aa22-fcf834ce4c13",
"version": 1,
"type": "invite",
"sessionRef": {
"scid": "bd6c41c3-01c3-468a-a3b5-3e0fe8133862",
"templateName": "deathmatch",
"name": "session-49"
},
"inviteAttributes": {
"titleId" : {titleId}, // The title being invited to, in decimal uint32. This value is used to find the title name and/or image.
"context" : {context}, // The title defined context token. Must be 256 characters or less when URI-encoded.
"contextString" : {contextstring}, // The string name of a custom invite string to display in the invite notification.
"senderString" : {sender} // The string name of the sender when the sender is a service.
},
"invitedXuid": "3210",
}