GET (/handles/{handle-id})
핸들 ID로 지정되는 핸들을 검색합니다.
중요:
이 메서드는 2015 멀티 플레이어에서 사용되며 해당 멀티 플레이어 버전 및 그 이상에서만 적용됩니다. 이는 템플릿 계약 104/105 이상에서 사용하기 위한 것이며 모든 요청마다 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.
설명
이 HTTP/REST 메서드는 지정된 핸들을 위해, 세션에 대한 사용자의 현재 활동을 가져옵니다. 반환값은 모든 특성이 포함된 세션 개체입니다. 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetCurrentSessionByHandleAsync로 래핑될 수 있습니다.
이 메서드의 호출자는 플레이어의 MultiplayerActivityDetails 개체로부터 핸들 ID를 얻습니다. 또는 사용자가 게임 초대를 수락한 후에 프로토콜 활성화를 통해 ID를 얻습니다.
URI 매개 변수
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| handleId | GUID | 세션 핸들의 고유 ID입니다. |
HTTP 상태 코드
이 서비스는 MPSD에 적용할 때 HTTP 상태 코드를 반환합니다.
요청 본문
이 요청의 본문에는 개체가 전송되지 않습니다.
응답 본문
MultiplayerSession(JSON)의 응답 구조를 참조하세요.