Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 래퍼의 기본 관리 클래스입니다.
구문
class Provider
메서드
메서드 | 설명 |
---|---|
초기화 | 저장된 게임 래퍼를 초기화하고 지정된 사용자에 해당하는 모든 컨테이너를 동기화합니다. |
QueryContainers | 제공된 이름 접두사와 일치하는 컨테이너 이름의 벡터를 반환합니다. |
QueryContainerBlobs | 지정된 컨테이너의 Blob(파일)을 식별하는 BlobInfo 개체의 벡터를 반환합니다. |
로드 | 지정된 컨테이너 내에 있는 지정된 BLOB(파일)에서 데이터를 로드합니다. |
저장 | 지정된 컨테이너 내의 지정된 BLOB(파일)에 데이터를 저장합니다. |
GetQuota | 게임 저장 래퍼를 사용하여 저장하기 위해 사용할 수 있는 데이터 양을 반환합니다. |
삭제(std::string&) | 컨테이너를 해당 BLOB(파일) 전체와 함께 삭제합니다. |
Delete(std::string&, std::string&) | 지정된 컨테이너에서 지정된 Blob(파일)을 삭제합니다. |
삭제(std::string&, BlobNames&) | 지정된 컨테이너에서 하나 이상의 Blob(파일)을 삭제합니다. |
비고
XGameSave 간단한 래퍼는 사용자를 대신하여 데이터를 읽고 쓸 수 있고, 게임 세션 전반에서 유지되며, 여러 장치에서 클라우드와 원활하게 동기화할 수 있는 API의 집합입니다. 래퍼 API를 나누는 세 가지 범주:
공급자
gs_provider_t
은(는) 사용자 컨텍스트를 게임 저장에 바인딩하는 핸들입니다. API 상호 작용에 필요합니다. 각 공급자는 여러 컨테이너를 포함할 수 있으며, 각 공급자의 기본 할당량은 256MB입니다. 공급자 작업에 포함되는 사항:
- 할당량 정보
- 컨테이너 관리
- 공급자 메타데이터(서비스 구성 ID, UserContext)
컨테이너
컨테이너를 사용하여 원자 단위로 쓰고, 업데이트하고, 읽을 수 있는 그룹에 데이터를 논리적으로 연관시킬 수 있습니다. 컨테이너 작업에 포함되는 사항:
- 컨테이너 정보에 대한 쿼리 및 컨테이너 상태
- 컨테이너 내용에 대한 쿼리
- 컨테이너 데이터에 원자 업데이트
BLOB(Binary Large Object)
BLOB에는 컨테이너에 포함된 데이터가 들어 있습니다. BLOB에 포함할 수 있는 데이터의 양은 최대 16MB입니다.
- BLOB 업데이트 및 삭제 작업은 원자 단위로 설계되어 한 작업에서 일련의 변경 사항을 커밋할 수 있습니다. 일부분이라도 실패하면 전체 업데이트가 실패합니다.
요건
헤더: xgamesavewrappers.hpp
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔
참고 항목
Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 래퍼 멤버
게임에서 간소화 래퍼 저장
관찰자 디자인 무늬