다음을 통해 공유


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 래퍼 멤버
게임에서 간소화 래퍼 저장
관찰자 디자인 무늬