세션 디렉터리 URI
이 섹션에서는 URI(Universal Resource Identifier) 주소와 멀티 플레이어 세션 디렉터리(MPSD)를 위한 Xbox Live 서비스에서 나온 관련 하이퍼텍스트 전송 프로토콜(HTTP) 메서드에 대한 세부 정보를 제공합니다.
참고:
Xbox 360, Windows Phone 장치 또는 Xbox.com에서 실행 중인 게임 타이틀만이 세션 디렉터리 URI를 이용할 수 있습니다.
도메인
서비스 버전
이러한 HTTP/REST URI 호출자는 X-Xbl-Contract-Version, 엔터테인먼트 검색 서비스(EDS) 의 서비스 버전을 지정하는 HTTP 헤더인 X-Xbl-Contract-Version에 대해 104/105 이상의 값을 전달해야 합니다.
시스템 개체와 속성
세션 및 템플릿 구성을 위해 MPSD는 디렉터리가 적용 및 해석하는 고정 스키마를 준수하는 일련의 세션 JSON 개체를 사용합니다. 다양한 세션 디렉터리 URI에서 지원되는 메서드를 호출하는 동안 지원되는 스키마에 따라 이러한 개체의 유효성을 검사하고 병합됩니다. 멀티 플레이어 구성과 관련된 주 JSON 개체는 다음과 같습니다.
- MultiplayerActivityDetails(JSON)
- MultiplayerSession(JSON)
- MultiplayerSessionReference(JSON)
- MultiplayerSessionRequest(JSON)
특히 게임과 관련된 JSON 개체는 다음과 같습니다.
핸들
2015 멀티 플레이어 게임에서만 세션 핸들을 통해 세션에 액세스할 수 있습니다. 핸들을 지원하는 기능을 제공하기 위해 몇몇 URI가 추가되었습니다.
이 섹션의 내용
사용자의 현재 활동이 Xbox One 대시보드 사용자 환경에 표시되도록 세션을 설정하고 필요 시 세션 멤버를 초대하는 POST 연산을 지원합니다.
식별자로 지정되는 세션 핸들을 위한 DELETE 및 GET 연산을 지원합니다.
핸들 역참조를 이용하여 세션에 PUT 및 GET 연산을 지원합니다.
세션 핸들에 쿼리를 생성하기 위해 POST 연산을 지원합니다.
서비스 구성 식별자 수준에서 배치 쿼리에 대한 POST 작업을 지원합니다.
/serviceconfigs/{scid}/sessions
세션 문서 집합을 검색하는 GET 작업을 지원합니다.
/serviceconfigs/{scid}/sessiontemplates
MPSD 세션 템플릿 집합을 검색하는 GET 작업을 지원합니다.
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}
세션 템플릿 이름 집합을 검색하는 GET 작업을 지원합니다.
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch
세션 템플릿 수준에서 배치 쿼리를 만들기 위한 POST 작업을 지원합니다.
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions
지정된 템플릿 이름이 있는 세션 템플릿 집합을 검색하는 GET 작업을 지원합니다.
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}
세션을 만들고 검색하는 PUT 및 GET 작업을 지원합니다.
/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me
세션 멤버를 제거하는 DELETE 작업을 지원합니다.
지정된 세션 서버를 제거하는 DELETE 작업을 지원합니다.