アプリとアドオンのアプリ内購入の有効化

この記事では、Windows.Services.Store 名前空間のメンバーを使用して、ユーザーの現在のアプリまたはそのいずれかのアドオンの購入を要求する方法を示します。 たとえば、現在ユーザーがアプリの試用版を使用している場合、このプロセスを使用して、ユーザーの完全なライセンスを購入できます。 また、このプロセスを使用して、ユーザーの新しいゲーム レベルなどのアドオンを購入できます。

アプリまたはアドオンの購入を要求するため、Windows.Services.Store 名前空間には次のようなさまざまなメソッドが備わっています。

• アプリまたはアドオンのストア ID がわかっている場合、StoreContext クラスの RequestPurchaseAsync メソッドを使用できます。
• アプリまたはアドオンを表す StoreProduct、StoreSku、StoreAvailability のいずれかのオブジェクトが既にある場合、それらのオブジェクトの RequestPurchaseAsync メソッドを使用できます。 コードで StoreProduct を取得するさまざまな方法の例については、「アプリとアドオンの製品情報の取得」をご覧ください。

各メソッドは、標準の購入 UI をユーザーに示し、トランザクションが完了すると非同期的に完了します。 メソッドは、トランザクションが成功したかどうかを示すオブジェクトを返します。

前提条件

この例には、次の前提条件があります。

• Windows 10 Anniversary Edition (10.0、ビルド 14393) 以降のリリースをターゲットとするユニバーサル Windows プラットフォーム (UWP) アプリの Visual Studio プロジェクト。
• パートナー センターでアプリの申請を作成し、このアプリが Microsoft Store で公開されている。 必要に応じで、テスト中にストアでアプリを検索できないようにアプリを構成することも可能です。 詳しくは、テスト ガイダンスをご覧ください。
• アプリのアドオンのアプリ内購入を有効化する場合、パートナー センターでアドオンを作成する必要もあります。

この例のコードは、次の点を前提としています。

• コードは、workingProgressRing という名前の ProgressRing と textBlock という名前の TextBlock を含む Page のコンテキストで実行されます。 これらのオブジェクトは、それぞれ非同期操作が発生していることを示するためと、出力メッセージを表示するために使用されます。
• コード ファイルには、Windows.Services.Store 名前空間の using ステートメントがあります。
• アプリは、アプリを起動したユーザーのコンテキストでのみ動作するシングル ユーザー アプリです。 詳しくは、「アプリ内購入と試用版」をご覧ください。

コードの例

この例は、StoreContext クラスの RequestPurchaseAsync メソッドを使用して、ストア ID がわかっているアプリまたはアドオンを購入する方法を示しています。 完全なサンプル アプリケーションについては、ストア サンプルをご覧ください。

private StoreContext context = null;

public async void PurchaseAddOn(string storeId)
{
    if (context == null)
    {
        context = StoreContext.GetDefault();
        // If your app is a desktop app that uses the Desktop Bridge, you
        // may need additional code to configure the StoreContext object.
        // For more info, see https://aka.ms/storecontext-for-desktop.
    }

    workingProgressRing.IsActive = true;
    StorePurchaseResult result = await context.RequestPurchaseAsync(storeId);
    workingProgressRing.IsActive = false;

    // Capture the error message for the operation, if any.
    string extendedError = string.Empty;
    if (result.ExtendedError != null)
    {
        extendedError = result.ExtendedError.Message;
    }

    switch (result.Status)
    {
        case StorePurchaseStatus.AlreadyPurchased:
            textBlock.Text = "The user has already purchased the product.";
            break;

        case StorePurchaseStatus.Succeeded:
            textBlock.Text = "The purchase was successful.";
            break;

        case StorePurchaseStatus.NotPurchased:
            textBlock.Text = "The purchase did not complete. " +
                "The user may have cancelled the purchase. ExtendedError: " + extendedError;
            break;

        case StorePurchaseStatus.NetworkError:
            textBlock.Text = "The purchase was unsuccessful due to a network error. " +
                "ExtendedError: " + extendedError;
            break;

        case StorePurchaseStatus.ServerError:
            textBlock.Text = "The purchase was unsuccessful due to a server error. " +
                "ExtendedError: " + extendedError;
            break;

        default:
            textBlock.Text = "The purchase was unsuccessful due to an unknown error. " +
                "ExtendedError: " + extendedError;
            break;
    }
}

関連トピック

• アプリ内購入と試用版
• アプリとアドオンの製品情報の取得
• アプリとアドオンのライセンス情報の取得
• コンシューマブルなアドオン購入の有効化
• アプリの試用版の実装
• ストア サンプル