CurrentApp.RequestProductPurchaseAsync 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
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입니다.
반환
앱에서 바로 구매 요청의 결과를 포함하는 PurchaseResults 입니다.
- 특성
설명
제품 ID는 앱이 추가 기능을 식별하는 데 사용하는 문자열입니다. 파트너 센터에서추가 기능을 제출할 때 제품 ID를 입력합니다. 여기서 설명, 가격 계층 및 수명과 연결됩니다. 자세한 내용은 코드에서 추가 기능에 제품 ID를 사용하는 방법을 참조하세요.
코드 샘플에서 이 메서드를 사용하는 방법의 예를 볼 수 있습니다.
추가 정보
적용 대상
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.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)]
/// [Windows.Foundation.Metadata.Overload("RequestProductPurchaseAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
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")]
static IAsyncOperation<winrt::hstring> RequestProductPurchaseAsync(winrt::hstring const& productId, bool const& includeReceipt);
[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, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Overload("RequestProductPurchaseAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<string> RequestProductPurchaseAsync(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")]
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에 대한 영수증을 반환해야 하는지 여부를 결정합니다.
반환
제공된 productId에 대한 앱 내 트랜잭션 세부 정보를 제공하는 문자열입니다. includeReceipt이 true로 설정된 경우 반환된 문자열에는 전체 영수증 xml이 포함됩니다.
- 특성
설명
RequestProductPurchaseAsync(String)에 대한 설명도 이 오버로드에 적용됩니다.
이 오버로드를 성공적으로 호출한 후 제품 라이선스가 활성 상태인지 확인하려면 LicenseInformation.IsActive 속성을 사용합니다.
추가 정보
적용 대상
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
구매 시 사용자에게 표시되는 앱 기능 또는 콘텐츠 제품의 이름입니다.
반환
앱에서 바로 구매 요청의 결과를 포함하는 PurchaseResults 입니다.
- 특성
설명
RequestProductPurchaseAsync(String)에 대한 설명도 이 오버로드에 적용됩니다.