다음을 통해 공유


CurrentAppSimulator 클래스

정의

테스트 중에 시뮬레이션된 라이선스 정보를 가져오는 데 사용할 수 있는 개체를 인스턴스화하는 데 사용되는 메서드 및 속성을 정의합니다.

참고

CurrentAppSimulator 클래스 및 Windows.ApplicationModel.Store 네임스페이스의 다른 형식은 더 이상 새 기능으로 업데이트되지 않습니다. 프로젝트가 Visual Studio에서 Windows 10 Anniversary Edition(10.0, 빌드 14393) 이상 릴리스를 대상으로 하는 경우(즉, Windows 10 버전 1607 이상을 대상으로 함) 대신 Windows.Services.Store 네임스페이스를 사용하는 것이 좋습니다. 자세한 내용은 앱에서 바로 구매 및 평가판을 참조하세요. CurrentAppSimulator 클래스는 데스크톱 브리지 사용하는 Windows 데스크톱 애플리케이션이나 파트너 센터에서 개발 샌드박스를 사용하는 앱 또는 게임에서 지원되지 않습니다(예: Xbox Live와 통합되는 모든 게임의 경우). 해당 제품은 Windows.Services.Store 네임스페이스를 사용하여 앱에서 바로 구매 및 평가판을 구현해야 합니다.

public ref class CurrentAppSimulator abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CurrentAppSimulator final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class CurrentAppSimulator
Public Class CurrentAppSimulator
상속
Object Platform::Object IInspectable CurrentAppSimulator
특성

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

앱이 Microsoft Store에 나열될 때까지 CurrentApp 개체는 앱에서 작동하지 않습니다. CurrentAppSimulator를 사용하여 앱을 개발하는 동안 앱의 라이선스 및 앱 내 제품을 테스트합니다. 앱을 테스트한 후 Microsoft Store에 제출하기 전에 CurrentAppSimulator 인스턴스를 CurrentApp으로 바꾸어야 합니다. 앱이 CurrentAppSimulator를 사용하는 경우 인증에 실패합니다.

CurrentAppSimulator를 사용하면 앱의 초기 라이선스 상태가 WindowsStoreProxy.xml 파일에 설명됩니다. 라이선스를 구입하거나 앱에서 바로 구매를 처리하는 등 라이선스 상태를 변경하는 CurrentAppSimulator 메서드는 메모리에 있는 개체의 라이선스 상태만 업데이트합니다. WindowsStoreProxy.xml의 내용은 변경되지 않습니다. 앱을 다시 시작하면 라이선스 상태가 WindowsStoreProxy.xml에 설명된 상태로 돌아갑니다.

WindowsStoreProxy.xml 파일에 대한 자세한 내용은 CurrentAppSimulator에서 WindowsStoreProxy.xml 파일 사용을 참조하세요.

속성

AppId

시뮬레이션된 앱 ID를 가져옵니다. CurrentAppSimulator는 앱 개발 중에만 테스트용이므로 반환된 CurrentAppSimulator.AppId에는 0개만 포함됩니다.

앱이 Windows 스토어에 나열되면 CurrentApp.AppId 는 앱 온보딩 중에 생성되고 Windows 스토어 카탈로그 내에서 앱을 나열하는 데 사용되는 GUID 를 가져옵니다.

참고

앱 업데이트 또는 앱 설명 변경으로 인해 CurrentApp.AppId가 변경되지 않습니다.

LicenseInformation

시뮬레이션에서 제공하는 현재 앱에 대한 시뮬레이션된 라이선스 메타데이터를 가져옵니다.

LinkUri

현재 앱의 Microsoft Store 목록 페이지를 나타내는 시뮬레이션된 URI(Uniform Resource Identifier)를 가져옵니다.

메서드

GetAppPurchaseCampaignIdAsync()

현재 앱의 프로모션 캠페인 ID를 검색합니다.

GetAppReceiptAsync()

사용자가 이 앱에 대한 모든 영수증 및 앱 내 제품 구매를 요청하는 시뮬레이션에 사용할 수 있는 비동기 작업을 만듭니다. 영수증 정보를 사용하는 방법의 예는 영수증을 사용하여 제품 구매 확인을 참조하세요.

GetProductReceiptAsync(String)

사용자가 지정된 제품 ID에 대한 영수증 요청을 시뮬레이트하는 데 사용할 수 있는 비동기 작업을 만듭니다. 영수증 정보를 사용하는 방법의 예는 영수증을 사용하여 제품 구매 확인을 참조하세요.

GetUnfulfilledConsumablesAsync()

로컬에서 처리되지 않은 구매한 소모성 앱 내 제품 목록을 반환합니다.

LoadListingInformationAsync()

시뮬레이션된 앱 목록 정보를 비동기적으로 로드합니다.

반환된 ListingInformation 개체에는 사용자가 현재 거주하는 지역/국가별 목록 정보(예: 이름, 가격, 연령 등급)가 포함됩니다. 또한 앱 내 제품을 통해 사용할 수 있는 제품에 대한 목록 정보도 제공됩니다.

참고

시뮬레이션을 위해 이 메서드는 WindowsStoreProxy.xml 파일의 요소를 반환된 개체의 멤버에 대한 데이터 원본으로 사용합니다. 자세한 내용은 CurrentAppSimulator의 코드 예제를 참조하세요.

LoadListingInformationByKeywordsAsync(IIterable<String>)

제공된 모든 키워드와 일치하는 ProductListings 컬렉션에서 앱 내 제품을 반환하여 시뮬레이션된 앱 목록 정보를 비동기적으로 로드합니다.

LoadListingInformationByProductIdsAsync(IIterable<String>)

시뮬레이션된 앱 목록 정보를 비동기적으로 로드하여 지정된 제품 ID와 일치하는 ProductListings 컬렉션에서 사용 가능한 앱 내 제품을 반환합니다.

ReloadSimulatorAsync(StorageFile)

WindowsStoreProxy.xml 파일이 포함된 StorageFile을 사용하여 시뮬레이터를 다시 로드합니다.

이 메서드를 호출하여 사용자 고유의 파일을 로드하지 않으면 시뮬레이터는 기본값 집합이 포함된 WindowsStoreProxy.xml 파일을 만들거나 로드합니다(덮어쓰지는 않음).

ReportConsumableFulfillmentAsync(String, Guid)

소모성 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)의 구매가 충족되고 사용자가 콘텐츠에 액세스할 권리가 있음을 Microsoft Store에 알리는 시뮬레이션입니다.

RequestAppPurchaseAsync(Boolean)

현재 앱에 대한 전체 라이선스를 구입하라는 사용자 요청을 시뮬레이션하는 비동기 작업을 만듭니다.

RequestProductPurchaseAsync(String)

Microsoft Store에서 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)의 구매를 시뮬레이션하는 데 사용되는 UI를 표시하는 비동기 작업을 만듭니다.

RequestProductPurchaseAsync(String, Boolean)

참고

[RequestProductPurchaseAsync(String, Boolean)는 Windows 8.1 후 릴리스에서 변경되거나 사용할 수 없습니다. 대신 RequestProductPurchaseAsync(String)를 사용합니다.

Microsoft Store에서 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)의 구매를 시뮬레이션하는 데 사용되는 UI를 표시하는 비동기 작업을 만듭니다.

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

Microsoft Store에서 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)의 구매를 시뮬레이션하는 데 사용되는 UI를 표시하는 비동기 작업을 만듭니다. 이 오버로드에는 스토어의 단일 제품 항목으로 표시되는 앱 내 구매의 큰 카탈로그 내에서 특정 제품에 대한 세부 정보를 표시하는 데 사용할 수 있는 매개 변수가 포함됩니다.

적용 대상

추가 정보