Xbox 서비스 API 개요
Xbox 서비스에서 정보를 가져오는 방법에는 두 가지가 있습니다.
- 클라이언트 측 API인 Xbox Live 서비스 API 또는 XSAPI 사용. Xbox Live API라고도 합니다.
- Xbox 서비스 REST 엔드포인트를 직접 호출합니다. XBOX LIVE REST 엔드포인트라고도 합니다.
XSAPI를 사용하는 이점
Xbox 서비스 API(XSAPI)를 사용하는 이점은 다음과 같습니다.
- 인증, 인코딩 및 HTTP 송신 및 수신 세부 정보를 사용자가 관리합니다.
- 래퍼 API에 대한 인수 및 반환된 데이터는 네이티브 데이터 형식에서 처리됩니다. 따라서 JSON 인코딩 및 디코딩을 수행할 필요가 없습니다.
- 웹 서비스를 직접 호출하려면 래퍼 API가 캡슐화하는 여러 비동기 단계가 포함됩니다. 이렇게 하면 타이틀 코드를 더 쉽게 읽고 쓸 수 있습니다.
- 게임 이벤트 작성과 같은 일부 기능은 XSAPI에서만 사용 가능합니다.
Xbox 서비스 REST 엔드포인트를 사용하는 이점
Xbox 서비스 REST 엔드포인트를 사용하는 이점은 다음과 같습니다.
- 웹 서비스에서 Xbox 서비스 엔드포인트를 호출하는 기능
- XSAPI에 포함되지 않은 끝점을 호출할 수 있습니다. XSAPI에는 게임에서 사용할 것이라 생각하는 API만 포함되므로 누락된 게 있는 경우 포럼을 통해 알려야 합니다.
- REST 끝점을 통해 사용 가능한 일부 기능이 해당 XSAPI 래퍼에는 없을 수 있습니다.
게임 및 앱에서 이러한 방법 중 한 가지만 사용할 수 있는 것은 아닙니다. XSAPI 래퍼를 사용하면서 필요한 경우 REST 끝점을 직접 호출할 수도 있습니다. 자세한 내용은 Xbox 서비스 REST API 참조를 확인하세요.
클라이언트 쪽 API 집합
Xbox 서비스 API(XSAPI)는 광범위한 고객 시나리오를 지원하는 클라이언트 쪽 API를 노출합니다.
중요: GDK 개발의 경우 XSAPI C 기반 API만 사용해야 합니다. XSAPI WinRT 및 C+11 API는 사용자 정보를 위해 여기에 포함되어 있습니다.
- XSAPI C 기반 API (GDK) - 2018년 6월 기준 신규
- XSAPI WinRT API(XDK 및 Xbox 크리에이터스 프로그램만 해당)
- XSAPI C++11 기반 API(XDK 및 Xbox 크리에이터스 프로그램만 해당)
XSAPI C 기반 API
- PC 및 Xbox 콘솔 GDK 타이틀을 지원합니다.
- XSAPI 호출 시 타이틀이 메모리 할당을 관리할 수 있습니다.
- XSAPI 호출 시 타이틀이 스레드 처리를 완전히 제어할 수 있습니다.
- 게임 개발자를 위해 설계된 새 HTTP 라이브러리 libHttpClient를 사용합니다.
자세한 내용은 Xbox Live C API 소개를 참조하세요.
API 참조는 XSAPI C 참조를 확인하세요.