Skip to main content

POST (/handles)

사용자의 현재 활동에 대한 멀티플레이어 세션을 설정하고, 필요한 경우 세션 멤버를 초대합니다.
중요:
이 메서드는 2015 멀티플레이어에서 사용되며 해당 멀티플레이어 버전 이상에만 적용됩니다. 템플릿 계약 104/105 이상과 함께 사용하도록 설계되었으며, 모든 요청에 X-Xbl-Contract-Version: 104/105 이상의 헤더 요소가 필요합니다.

설명

이 HTTP/REST 메서드는 현재 활동에 대한 세션을 설정하는 데 사용할 수 있습니다. 이 경우 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SetActivityAsync로 래핑될 수 있습니다. 요청 본문은 JSON 파일의 sessionRef 개체를 사용하여 세션 참조를 정의해야 하며 type 필드는 “activity”로 설정합니다. 응답 본문은 검색되지 않습니다. 세션 참조에 지정된 항목의 정의는 Microsoft.Xbox.Services.Multiplayer.MultiplayerSessionReference를 참조하십시오. 이 POST 메서드는 또한 핸들로 지정된 사용자를 세션에 초대하는 데 사용할 수도 있습니다. 이 경우 메서드는 Microsoft.Xbox.Services.Multiplayer.MultiplayerService.SendInvitesAsync로 래핑될 수 있습니다. POST 메서드의 이러한 사용은 요청 본문이 세션 참조를 정의해야 하지만 type 필드를 “invite”로 설정해야 합니다. 응답 본문은 초대 핸들입니다.

URI 매개 변수

없음

HTTP 상태 코드

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

요청 본문

활동 설정을 위한 요청 본문

초대 전송을 위한 요청 본문

응답 본문

활동 설정을 위한 응답 본문

없음.

초대 전송을 위한 응답 본문

초대 핸들.

함께 보기

상위
/handles
Last modified on October 19, 2026