CurrentApp.RequestProductPurchaseAsync 메서드

정의

네임스페이스:

Windows.ApplicationModel.Store

오버로드

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가 표시됩니다. 이 오버로드에는 스토어의 단일 제품 항목으로 표시되는 앱에서 바로 구매의 큰 카탈로그 내에서 특정 제품에 대한 세부 정보를 표시하는 데 사용할 수 있는 매개 변수가 포함됩니다.

RequestProductPurchaseAsync(String)

추가 기능(앱 내 제품 또는 IAP라고도 함)의 구매를 요청합니다. 또한 이 메서드를 호출하면 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI가 표시됩니다.

public:
 static IAsyncOperation<PurchaseResults ^> ^ RequestProductPurchaseAsync(Platform::String ^ productId);

/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithResultsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(winrt::hstring const& productId);

[Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithResultsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(string productId);

function requestProductPurchaseAsync(productId)

Public Shared Function RequestProductPurchaseAsync (productId As String) As IAsyncOperation(Of PurchaseResults)

매개 변수

productId

String

Platform::String

winrt::hstring

구매할 추가 기능의 제품 ID입니다.

반환

IAsyncOperation<PurchaseResults>

앱에서 바로 구매 요청의 결과를 포함하는 PurchaseResults 입니다.

특성

OverloadAttribute RemoteAsyncAttribute

설명

제품 ID는 앱이 추가 기능을 식별하는 데 사용하는 문자열입니다. 파트너 센터에서추가 기능을 제출할 때 제품 ID를 입력합니다. 여기서 설명, 가격 계층 및 수명과 연결됩니다. 자세한 내용은 코드에서 추가 기능에 제품 ID를 사용하는 방법을 참조하세요.

코드 샘플에서 이 메서드를 사용하는 방법의 예를 볼 수 있습니다.

추가 정보

• RequestProductPurchaseAsync(String, Boolean)

RequestProductPurchaseAsync(String, Boolean)

참고

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

추가 기능(앱 내 제품 또는 IAP라고도 함)의 구매를 요청합니다. 또한 이 메서드를 호출하면 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI가 표시됩니다.

public:
 static IAsyncOperation<Platform::String ^> ^ RequestProductPurchaseAsync(Platform::String ^ productId, bool includeReceipt);

/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("RequestProductPurchaseAsync(productId, includeReceipt) may be altered or unavailable for releases after Windows 8.1. Instead, use RequestProductPurchaseAsync(productId).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
 static IAsyncOperation<winrt::hstring> RequestProductPurchaseAsync(winrt::hstring const& productId, bool const& includeReceipt);

[Windows.Foundation.Metadata.Overload("RequestProductPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Deprecated("RequestProductPurchaseAsync(productId, includeReceipt) may be altered or unavailable for releases after Windows 8.1. Instead, use RequestProductPurchaseAsync(productId).", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public static IAsyncOperation<string> RequestProductPurchaseAsync(string productId, bool includeReceipt);

function requestProductPurchaseAsync(productId, includeReceipt)

Public Shared Function RequestProductPurchaseAsync (productId As String, includeReceipt As Boolean) As IAsyncOperation(Of String)

매개 변수

productId

String

Platform::String

winrt::hstring

구매할 추가 기능의 제품 ID입니다.

includeReceipt

Boolean

bool

메서드가 지정된 productId에 대한 영수증을 반환해야 하는지 여부를 결정합니다.

반환

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

제공된 productId에 대한 앱 내 트랜잭션 세부 정보를 제공하는 문자열입니다. includeReceipt이 true로 설정된 경우 반환된 문자열에는 전체 영수증 xml이 포함됩니다.

특성

DeprecatedAttribute OverloadAttribute RemoteAsyncAttribute

설명

RequestProductPurchaseAsync(String)에 대한 설명도 이 오버로드에 적용됩니다.

이 오버로드를 성공적으로 호출한 후 제품 라이선스가 활성 상태인지 확인하려면 LicenseInformation.IsActive 속성을 사용합니다.

추가 정보

• RequestProductPurchaseAsync(String)

RequestProductPurchaseAsync(String, String, ProductPurchaseDisplayProperties)

추가 기능(앱 내 제품 또는 IAP라고도 함)의 구매를 요청합니다. 또한 이 메서드를 호출하면 Microsoft Store를 통해 트랜잭션을 완료하는 데 사용되는 UI가 표시됩니다. 이 오버로드에는 스토어의 단일 제품 항목으로 표시되는 앱에서 바로 구매의 큰 카탈로그 내에서 특정 제품에 대한 세부 정보를 표시하는 데 사용할 수 있는 매개 변수가 포함됩니다.

public:
 static IAsyncOperation<PurchaseResults ^> ^ RequestProductPurchaseAsync(Platform::String ^ productId, Platform::String ^ offerId, ProductPurchaseDisplayProperties ^ displayProperties);

/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithDisplayPropertiesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(winrt::hstring const& productId, winrt::hstring const& offerId, ProductPurchaseDisplayProperties const& displayProperties);

[Windows.Foundation.Metadata.Overload("RequestProductPurchaseWithDisplayPropertiesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<PurchaseResults> RequestProductPurchaseAsync(string productId, string offerId, ProductPurchaseDisplayProperties displayProperties);

function requestProductPurchaseAsync(productId, offerId, displayProperties)

Public Shared Function RequestProductPurchaseAsync (productId As String, offerId As String, displayProperties As ProductPurchaseDisplayProperties) As IAsyncOperation(Of PurchaseResults)

매개 변수

productId

String

Platform::String

winrt::hstring

구매할 추가 기능의 제품 ID입니다.

offerId

String

Platform::String

winrt::hstring

productId로 Microsoft Store에 표시되는 대규모 구매 카탈로그 내의 특정 앱 내 기능 또는 콘텐츠 입니다. 이 값은 앱이 수행하는 콘텐츠와 상관 관계가 있습니다. Microsoft Store는 이 값만 사용하여 PurchaseResults를 항목화합니다.

displayProperties

ProductPurchaseDisplayProperties

구매 시 사용자에게 표시되는 앱 기능 또는 콘텐츠 제품의 이름입니다.

반환

IAsyncOperation<PurchaseResults>

앱에서 바로 구매 요청의 결과를 포함하는 PurchaseResults 입니다.

특성

OverloadAttribute RemoteAsyncAttribute

설명

RequestProductPurchaseAsync(String)에 대한 설명도 이 오버로드에 적용됩니다.

추가 정보

• RequestProductPurchaseAsync(String)
• RequestProductPurchaseAsync(String, Boolean)