Skip to main content

​
GET (/handles/)

핸들 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)의 응답 구조를 참조하십시오.

​
함께 보기

상위
/handles/
Last modified on October 19, 2026