CurrentApp 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 앱에 대한 라이선스 및 목록 정보를 얻고 앱에서 제품 구매를 수행하는 데 사용할 수 있는 메서드와 속성을 정의합니다.
참고
CurrentApp 클래스 및 Windows.ApplicationModel.Store 네임스페이스의 다른 형식은 더 이상 새 기능으로 업데이트되지 않습니다. 프로젝트가 Visual Studio에서 Windows 10 Anniversary Edition(10.0, 빌드 14393) 이상 릴리스를 대상으로 하는 경우(즉, Windows 10 버전 1607 이상을 대상으로 함) 대신 Windows.Services.Store 네임스페이스를 사용하는 것이 좋습니다. 자세한 내용은 앱에서 바로 구매 및 평가판을 참조하세요. CurrentApp 클래스는 데스크톱 브리지 사용하는 Windows 데스크톱 애플리케이션이나 파트너 센터의 개발 샌드박스를 사용하는 앱 또는 게임에서 지원되지 않습니다(예: Xbox Live와 통합되는 모든 게임의 경우). 해당 제품은 Windows.Services.Store 네임스페이스를 사용하여 앱에서 바로 구매 및 평가판을 구현해야 합니다.
public ref class CurrentApp 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 CurrentApp 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 CurrentAppPublic Class CurrentApp- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
이 개체는 Microsoft Store에서 해당 데이터를 가져오므로 개발자 계정이 있어야 하며 앱을 Microsoft Store에 게시해야 합니다. Microsoft Store에 제출하기 전에 이 클래스의 시뮬레이션된 버전(XML 파일에서 상태가 초기화됨)으로 코드를 테스트할 수 있습니다. CurrentAppSimulator를 참조하세요.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1511 | 10586 | GetCustomerCollectionsIdAsync |
| 1511 | 10586 | GetCustomerPurchaseIdAsync |
속성
| AppId |
앱이 Windows 스토어에 나열되도록 인증되었을 때 Windows 스토어에서 생성된 GUID 를 가져옵니다. 참고 앱이 Windows 스토어에 있으면 향후 앱 업데이트 또는 앱 설명 변경으로 인해 CurrentApp.AppId가 변경되지 않습니다. |
| LicenseInformation |
현재 앱에 대한 라이선스 메타데이터를 가져옵니다. |
| LinkUri |
Windows 스토어의 웹 카탈로그에 있는 앱 목록 페이지의 URI(Uniform Resource Identifier)를 가져옵니다. |
메서드
| GetAppPurchaseCampaignIdAsync() |
현재 앱의 프로모션 캠페인 ID를 검색합니다. |
| GetAppReceiptAsync() |
앱 및 앱 내 제품 구매에 대한 모든 영수증을 요청합니다. 영수증 정보를 사용하는 방법에 대한 예제는 영수증을 사용하여 제품 구매 확인을 참조하세요. |
| GetCustomerCollectionsIdAsync(String, String) |
제품 자격을 쿼리하거나 현재 사용자가 소유한 제품 자격을 사용하는 데 사용할 수 있는 Microsoft Store ID 키를 검색합니다. |
| GetCustomerPurchaseIdAsync(String, String) |
현재 사용자를 대신하여 무료 제품에 대한 자격을 부여하는 데 사용할 수 있는 Microsoft Store ID 키를 검색합니다. |
| GetProductReceiptAsync(String) |
지정된 제품 ID에 대한 영수증을 요청합니다. 영수증 정보를 사용하는 방법에 대한 예제는 영수증을 사용하여 제품 구매 확인을 참조하세요. |
| GetUnfulfilledConsumablesAsync() |
Microsoft Store에 처리된 것으로 보고되지 않은 구매한 소모성 앱 내 제품 목록을 반환합니다. |
| LoadListingInformationAsync() |
앱의 목록 정보를 비동기적으로 로드합니다. 반환된 ListingInformation 개체에는 사용자가 현재 거주하는 지역/국가별 목록 정보(예: 이름, 가격, 연령 등급)가 포함됩니다. 또한 사용 가능한 앱 내 제품에 대한 목록 정보도 제공됩니다. |
| LoadListingInformationByKeywordsAsync(IIterable<String>) |
제공된 모든 키워드와 일치하는 ProductListings 컬렉션의 기능 및 제품을 반환하여 앱 목록 정보를 비동기적으로 로드합니다. |
| LoadListingInformationByProductIdsAsync(IIterable<String>) |
앱 목록 정보를 비동기적으로 로드하여 지정된 제품 ID와 일치하는 ProductListings 컬렉션의 기능 및 제품을 반환합니다. |
| ReportConsumableFulfillmentAsync(String, Guid) |
소모성 추가 기능(앱에서 바로 구매 제품 또는 IAP라고도 함)의 구매가 이행되었으며 사용자에게 콘텐츠에 액세스할 권리가 있음을 Microsoft Store에 알립니다. |
| ReportProductFulfillment(String) |
애플리케이션이 앱에서 바로 구매 제품을 충족했음을 Microsoft Store에 알 수 있습니다. 앱이 이 방법을 사용하여 이행을 확인할 때까지 이 제품을 다시 구매할 수 없습니다. |
| RequestAppPurchaseAsync(Boolean) |
전체 앱 라이선스 구매를 요청합니다. |
| RequestProductPurchaseAsync(String) |
추가 기능(앱 내 제품 또는 IAP라고도 함)의 구매를 요청합니다. 또한 이 메서드를 호출하면 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI가 표시됩니다. |
| RequestProductPurchaseAsync(String, Boolean) |
참고 [RequestProductPurchaseAsync(String, Boolean)는 Windows 8.1 후 릴리스에 대해 변경되거나 사용할 수 없습니다. 대신 RequestProductPurchaseAsync(String)를 사용합니다. 추가 기능(앱 내 제품 또는 IAP라고도 함)의 구매를 요청합니다. 또한 이 메서드를 호출하면 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI가 표시됩니다. |
| RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties) |
추가 기능(앱 내 제품 또는 IAP라고도 함)의 구매를 요청합니다. 또한 이 메서드를 호출하면 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI가 표시됩니다. 이 오버로드에는 스토어의 단일 제품 항목으로 표시되는 앱에서 바로 구매의 큰 카탈로그 내에서 특정 제품에 대한 세부 정보를 표시하는 데 사용할 수 있는 매개 변수가 포함됩니다. |