Skip to main content

​
PUT (/handles//session)

핸들을 역참조하여 세션을 만들거나 업데이트합니다.
중요:
이 메서드는 2015 멀티플레이어에서 사용되며 해당 멀티플레이어 버전 이상에만 적용됩니다. 템플릿 계약 104/105 이상과 함께 사용하도록 설계되었으며, 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.

​
설명

이 HTTP/REST 메서드는 제공된 세션 핸들 ID를 사용하여 새 세션 또는 업데이트된 세션을 멀티플레이어 서비스에 씁니다. 결과는 서버에서 반환된 새 세션 또는 업데이트된 세션을 나타내는 개체입니다. 이 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.WriteSessionByHandleAsync로 래핑될 수 있습니다. 이 메서드의 호출자는 플레이어의 MultiplayerActivityDetails 개체에서 핸들 ID를 얻습니다. 또는 사용자가 게임 초대를 수락한 후 프로토콜 활성화에서 ID를 가져옵니다.

​
URI 매개 변수

| 매개 변수| 형식| 설명| | --- | --- | --- | --- | | handleId| GUID| 세션 핸들의 고유 ID입니다.|

​
HTTP 상태 코드

서비스는 MPSD에 적용되는 HTTP 상태 코드를 반환합니다.

​
요청 본문

이 요청의 본문에는 개체가 전송되지 않습니다.

​
응답 본문

응답 본문에는 개체가 전송되지 않습니다.

​
함께 보기

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