> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Economy v2、Unity IAP、Android を使い始める

> Unity IAP と Android Billing API を PlayFab Economy v2 のバンドルに接続し、プレイヤーが実際のお金でアイテムを購入してインベントリに引き換えられるようにします。

# Economy v2、Unity、Android を使い始める

<Info>
  Economy v2 が一般提供 (GA) されました。サポートとフィードバックについては、[PlayFab フォーラム](https://community.playfab.com) を参照してください。
</Info>

このチュートリアルでは、PlayFab、Unity + IAP サービス、Android Billing API を使用したアプリ内購入 (IAP) をセットアップする方法を説明します。

## 始める前に

Android Billing API と PlayFab は連携して、クライアントに IAP エクスペリエンスを提供します。

<img src="https://mintcdn.com/microsoft-4404708b/68AB2fedpk3M7e-n/images/playfab/economy-monetization/economy-v2/playfab-economyv2-redemption-timeline.png?fit=max&auto=format&n=68AB2fedpk3M7e-n&q=85&s=498ccac2bdd047ef019555cf9edfee34" alt="PlayFab Economy v2 - 引き換えタイムライン" width="855" height="390" data-path="images/playfab/economy-monetization/economy-v2/playfab-economyv2-redemption-timeline.png" />

まず、PlayMarket を介して **Product ID** と **価格** を設定します。最初は、すべての製品は *無記名* です。プレイヤーが購入できるデジタル エンティティですが、PlayFab プレイヤーにとって意味を持ちません。

これらのエンティティを役立たせるには、PlayFab のアイテム カタログでミラーリングする必要があります。PlayFab は、無記名のエンティティをバンドル、コンテナ、および個々のアイテムに変えます。

それぞれに独自の顔があり、次を持ちます。

* **タイトル**
* **説明**
* **タグ**
* **タイプ**
* **画像**
* **動作**

すべてのアイテムは、ID を共有することによってマーケット製品にリンクされます。

購入可能な実際のお金のアイテムにアクセスする最良の方法は、[GetItems](https://learn.microsoft.com/en-us/rest/api/playfab/economy/catalog/get-items) を使用することです。

アイテムの ID は、PlayFab と任意の外部 IAP システムの間のリンクです。したがって、アイテム ID を IAP サービスに渡します。

この時点で購入プロセスが始まります。プレイヤーは IAP インターフェイスと対話し、購入が成功するとレシートを取得します。

PlayFab はレシートを検証し、購入を登録して、購入したアイテムを PlayFab プレイヤーに付与します。

## クライアント アプリケーションのセットアップ

このセクションでは、PlayFab、UnityIAP、Android Billing API を使用して IAP をテストするようにアプリケーションを構成する方法を説明します。

前提条件:

* Unity プロジェクト。
* [PlayFab Unity SDK](/services/playfab/sdks/unity3d) がインポートされ、タイトルで動作するように構成されている。
* [Visual Studio](https://learn.microsoft.com/en-us/visualstudio/gamedev/unity/get-started/getting-started-with-visual-studio-tools-for-unity) などのエディターがインストールされ、Unity プロジェクトで動作するように構成されている。

最初のステップは UnityIAP のセットアップです。

1. **Services** に移動します。
2. **Services** タブが選択されていることを確認します。
3. **Unity Services** プロファイルまたは組織を選択します。
4. **Create** ボタンを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-setting-up-service.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=c74b3cd003f67bb4998e4f0b36b24db6" alt="UnityIAP サービスのセットアップ" width="570" height="693" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-setting-up-service.png" />

1. 次に、**In-App Purchasing (IAP)** サービスに移動します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-navigate-to-service.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=b5a4f77ba599c1368e2a9b7185ff2dfe" alt="UnityIAP サービスに移動" width="500" height="862" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-navigate-to-service.png" />

1. **Simplify cross-platform IAP** トグルを設定して、**サービス** を有効にしていることを確認します。
2. 次に **Continue** ボタンを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-enable-service.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=dbb412be4fe8ab0d42d8417b12f4113d" alt="UnityIAP サービスを有効にする" width="428" height="325" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-enable-service.png" />

プラグインのリストが表示されるページが表示されます。

1. **Import** ボタンを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-import-plugins.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=9c25924c7488ebef1c63f914fad0ab60" alt="UnityIAP サービス - プラグインのインポート" width="444" height="525" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-import-plugins.png" />

すべてのプラグインがインポートされる時点まで、Unity のインストールとインポート手順を続けます。

1. プラグインが所定の場所にあることを確認します。
2. 次に、**AndroidIAPExample.cs** という新しいスクリプトを作成します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-create-new-script.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=3bca6b55a46e1a1ef00ee671a9e47c90" alt="UnityIAP 新しいスクリプトの作成" width="407" height="330" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-create-new-script.png" />

以下のコードを含む `AndroidIAPExample.cs` (詳細についてはコードのコメントを参照してください)。

```csharp theme={null}
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

using UnityEngine;
using UnityEngine.Purchasing;
using UnityEngine.Purchasing.Extension;

using PlayFab;
using PlayFab.ClientModels;
using PlayFab.EconomyModels;

/// <summary>
/// Unity IAP Store インターフェイスを実装する Unity ビヘイビア。
/// シーンにアセットとしてアタッチします。
/// </summary>
public class AndroidIAPExample : MonoBehaviour, IDetailedStoreListener
{
    // Google Play Store で販売されているバンドル。
    private Dictionary<string, PlayFab.EconomyModels.CatalogItem> _googlePlayCatalog;

    // サンプル ベンダーで販売されているゲーム内アイテム。
    private Dictionary<string, PlayFab.EconomyModels.CatalogItem> _storefrontCatalog;

    private string _purchaseIdempotencyId = null;

    private PlayFabEconomyAPIAsyncResult _lastAPICallResult = null;

    private static readonly PlayFabEconomyAPIAsync s_economyAPI = new();

    private static IStoreController s_storeController;

    // TODO: このコールバックは説明目的です。ニーズに合ったものを作成する必要があります
    public delegate void PlayFabProcessPurchaseCallback(PurchaseProcessingResult result);

    /// <summary>
    /// 購入が処理された際にトリガーされるイベント。
    /// </summary>
    /// <remarks>
    /// TODO: 購入結果を処理するために、ゲーム コードでこのイベントをサブスクライブします。
    /// </remarks>
    public event PlayFabProcessPurchaseCallback PlayFabProcessPurchaseEvent;

    /// <summary>
    /// Store Controller、拡張、およびカタログが設定されている場合は true。
    /// </summary>
    public bool IsInitialized => s_storeController != null
                             && _googlePlayCatalog != null
                             && _storefrontCatalog != null;

    // Start は最初のフレーム更新の前に呼び出されます。
    public void Start()
    {
        Login();
    }

    /// <summary>
    /// Android デバイス ID を使用してプレイヤーのログインを試みます。
    /// </summary>
    private void Login()
    {
        // TODO: 最終的なゲーム コードでは、LoginWithGooglePlayGamesService または同様のプラットフォーム固有のログイン方法を使用することを推奨します。

        // SystemInfo.deviceUniqueIdentifier は、新しいデバイスで権限を要求します。
        // デバイス固有ではない GUID を使用してローカル ファイルに保存する方が
        // 良いアプローチです。PlayFab では、複数の Android デバイス ID を
        // 単一の PlayFab アカウントにリンクできます。
        PlayFabClientAPI.LoginWithCustomID(new LoginWithCustomIDRequest()
        {
            CreateAccount = true,
            CustomId = SystemInfo.deviceUniqueIdentifier
        }, result => RefreshIAPItems(), PlayFabSampleUtil.OnPlayFabError);
    }

    /// <summary>
    /// PlayFab Economy Catalog V2 に更新されたリストをクエリし、
    /// ローカル カタログ オブジェクトを埋めます。
    /// </summary>
    private async void RefreshIAPItems()
    {
        _googlePlayCatalog = new Dictionary<string, PlayFab.EconomyModels.CatalogItem>();
        SearchItemsRequest googlePlayCatalogRequest = new()
        {
            Count = 50,
            Filter = "AlternateIds/any(t: t/type eq 'GooglePlay')"
        };

        SearchItemsResponse googlePlayCatalogResponse;
        do
        {
            googlePlayCatalogResponse = await s_economyAPI.SearchItemsAsync(googlePlayCatalogRequest);
            Debug.Log("Search response: " + JsonUtility.ToJson(googlePlayCatalogResponse));

            foreach (PlayFab.EconomyModels.CatalogItem item in googlePlayCatalogResponse.Items)
            {
                _googlePlayCatalog.Add(item.Id, item);
            }

        } while (!string.IsNullOrEmpty(googlePlayCatalogResponse.ContinuationToken));

        Debug.Log($"Completed pulling from PlayFab Economy v2 googleplay Catalog: {_googlePlayCatalog.Count()} items retrieved");

        _storefrontCatalog = new Dictionary<string, PlayFab.EconomyModels.CatalogItem>();
        GetItemRequest storeCatalogRequest = new()
        {
            AlternateId = new CatalogAlternateId()
            {
                Type = "FriendlyId",
                Value = "villagerstore"
            }
        };

        GetItemResponse storeCatalogResponse;
        storeCatalogResponse = await s_economyAPI.GetItemAsync(storeCatalogRequest);
        List<string> itemIds = new();

        foreach (CatalogItemReference item in storeCatalogResponse.Item.ItemReferences)
        {
            itemIds.Add(item.Id);
        }

        GetItemsRequest itemsCatalogRequest = new()
        {
            Ids = itemIds
        };

        GetItemsResponse itemsCatalogResponse = await s_economyAPI.GetItemsAsync(itemsCatalogRequest);
        foreach (PlayFab.EconomyModels.CatalogItem item in itemsCatalogResponse.Items)
        {
            _storefrontCatalog.Add(item.Id, item);
        }

        Debug.Log($"Completed pulling from PlayFab Economy v2 villagerstore store: {_storefrontCatalog.Count()} items retrieved");

        InitializePurchasing();
    }

    /// <summary>
    /// Google Play Store 向けに Unity IAP システムを初期化します。
    /// </summary>
    private void InitializePurchasing()
    {
        if (IsInitialized) return;

        var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance(AppStore.GooglePlay));

        foreach (PlayFab.EconomyModels.CatalogItem item in _googlePlayCatalog.Values)
        {
            string googlePlayItemId = item.AlternateIds.FirstOrDefault(item => item.Type == "GooglePlay")?.Value;
            if (!string.IsNullOrWhiteSpace(googlePlayItemId))
            {
                builder.AddProduct(googlePlayItemId, ProductType.Consumable);
            }
        }

        UnityPurchasing.Initialize(this, builder);
    }

    /// <summary>
    /// テスト例のためのデバッグ IMGUI を描画します。
    /// 本番ゲームのランタイム UI には、代わりに UI Toolkit を使用してください。
    /// </summary>
    public void OnGUI()
    {
        // 高解像度デバイスをサポート。
        GUI.matrix = Matrix4x4.TRS(new Vector3(0, 0, 0), Quaternion.identity, new Vector3(3, 3, 3));

        if (!IsInitialized)
        {
            GUILayout.Label("Initializing IAP and logging in...");
            return;
        }

        if (!string.IsNullOrEmpty(_purchaseIdempotencyId) && (!string.IsNullOrEmpty(_lastAPICallResult?.Message)
                                                           || !string.IsNullOrEmpty(_lastAPICallResult?.Error)))
        {
            GUILayout.Label(_lastAPICallResult?.Message + _lastAPICallResult?.Error);
        }

        GUILayout.Label("Shop for game currency bundles.");
        // 各カタログ アイテムの購入メニューを描画。
        foreach (PlayFab.EconomyModels.CatalogItem item in _googlePlayCatalog.Values)
        {
            // ディクショナリを使用して適切な言語を選択。
            if (GUILayout.Button("Get " + (item.Title.ContainsKey("en-US") ? item.Title["en-US"] : item.Title["NEUTRAL"])))
            {
                BuyProductById(item.AlternateIds.FirstOrDefault(item => item.Type == "GooglePlay").Value);
            }
        }

        GUILayout.Label("Hmmm. (Translation: Welcome to my humble Villager store.)");
        // 各カタログ アイテムの購入メニューを描画。
        foreach (PlayFab.EconomyModels.CatalogItem item in _storefrontCatalog.Values)
        {
            // ディクショナリを使用して適切な言語を選択。
            if (GUILayout.Button("Buy "
                + (item.Title.ContainsKey("en-US") ? item.Title["en-US"] : item.Title["NEUTRAL"]
                + ": "
                + item.PriceOptions.Prices.FirstOrDefault().Amounts.FirstOrDefault().Amount.ToString()
                + " Diamonds"
                )))
            {
                Task.Run(() => PlayFabPurchaseItemById(item.Id));
            }
        }
    }

    /// <summary>
    /// Unity IAP API とゲーム購入を統合します。
    /// </summary>
    public void BuyProductById(string productId)
    {
        if (!IsInitialized)
        {
            Debug.LogError("IAP Service is not initialized!");
            return;
        }

        s_storeController.InitiatePurchase(productId);
    }

    /// <summary>
    /// ID で PlayFab インベントリ アイテムを購入します。
    /// エラー処理と呼び出しパターンの詳細については、
    /// <see cref="PlayFabEconomyAPIAsync"/> クラスを参照してください。
    /// </summary>
    async public Task<bool> PlayFabPurchaseItemById(string itemId)
    {
        if (!IsInitialized)
        {
            Debug.LogError("IAP Service is not initialized!");
            return false;
        }

        _lastAPICallResult = new();

        Debug.Log("Player buying product " + itemId);

        if (string.IsNullOrEmpty(_purchaseIdempotencyId))
        {
            _purchaseIdempotencyId = Guid.NewGuid().ToString();
        }

        GetItemRequest getVillagerStoreRequest = new()
        {
            AlternateId = new CatalogAlternateId()
            {
                Type = "FriendlyId",
                Value = "villagerstore"
            }
        };

        GetItemResponse getStoreResponse = await s_economyAPI.GetItemAsync(getVillagerStoreRequest);
        if (getStoreResponse == null || string.IsNullOrEmpty(getStoreResponse?.Item?.Id))
        {
            _lastAPICallResult.Error = "Unable to contact the store. Check your internet connection and try again in a few minutes.";
            return false;
        }

        CatalogPriceAmount price = _storefrontCatalog.FirstOrDefault(item => item.Key == itemId).Value.PriceOptions.Prices.FirstOrDefault().Amounts.FirstOrDefault();
        PurchaseInventoryItemsRequest purchaseInventoryItemsRequest = new()
        {
            Amount = 1,
            Item = new InventoryItemReference()
            {
                Id = itemId
            },
            PriceAmounts = new List<PurchasePriceAmount>
            {
                new()
                {
                    Amount = price.Amount,
                    ItemId = price.ItemId
                }
            },
            IdempotencyId = _purchaseIdempotencyId,
            StoreId = getStoreResponse.Item.Id
        };

        PurchaseInventoryItemsResponse purchaseInventoryItemsResponse = await s_economyAPI.PurchaseInventoryItemsAsync(purchaseInventoryItemsRequest);
        if (purchaseInventoryItemsResponse == null || purchaseInventoryItemsResponse?.TransactionIds.Count < 1)
        {
            _lastAPICallResult.Error = "Unable to purchase. Try again in a few minutes.";
            return false;
        }

        _purchaseIdempotencyId = "";
        _lastAPICallResult.Message = "Purchasing!";
        return true;
    }

    private void OnRegistration(LoginResult result)
    {
        PlayFabSettings.staticPlayer.ClientSessionTicket = result.SessionTicket;
    }

    public void OnInitialized(IStoreController controller, IExtensionProvider extensions)
    {
        s_storeController = controller;

        extensions.GetExtension<IGooglePlayStoreExtensions>().RestoreTransactions((result, error) => {
            if (result)
            {
                Debug.LogWarning("Restore transactions succeeded.");
            }
            else
            {
                Debug.LogWarning("Restore transactions failed.");
            }
        });
    }

    public void OnInitializeFailed(InitializationFailureReason error)
    {
        Debug.Log("OnInitializeFailed InitializationFailureReason:" + error);
    }

    public void OnInitializeFailed(InitializationFailureReason error, string message)
    {
        Debug.Log("OnInitializeFailed InitializationFailureReason:" + error + message);
    }

    public void OnPurchaseFailed(UnityEngine.Purchasing.Product product, PurchaseFailureReason failureReason)
    {
        Debug.Log($"OnPurchaseFailed: FAIL. Product: '{product.definition.storeSpecificId}', PurchaseFailureReason: {failureReason}");
    }

    public void OnPurchaseFailed(UnityEngine.Purchasing.Product product, PurchaseFailureDescription failureDescription)
    {
        Debug.Log($"OnPurchaseFailed: FAIL. Product: '{product.definition.storeSpecificId}', PurchaseFailureReason: {failureDescription}");
    }

    /// <summary>
    /// ストア購入のコールバック。最終的な PurchaseProcessingResult を処理するために PlayFabProcessPurchaseEvent をサブスクライブします。
    /// <see href="https://docs.unity3d.com/Packages/com.unity.purchasing@4.8/api/UnityEngine.Purchasing.PurchaseProcessingResult.html"/>
    /// </summary>
    /// <remarks>
    /// このコードは、保留中でアプリケーション開始時に配信される購入を考慮していません。
    /// 本番コードではこれらのケースを考慮する必要があります。
    /// </remarks>
    /// <returns>エラー時にはすぐに完了。PlayFab Economy が最終処理を処理している場合は保留中で、最終結果と共に PlayFabProcessPurchaseEvent をトリガーします。</returns>
    public PurchaseProcessingResult ProcessPurchase(PurchaseEventArgs purchaseEvent)
    {
        if (!IsInitialized)
        {
            Debug.LogWarning("Not initialized. Ignoring.");
            return PurchaseProcessingResult.Complete;
        }

        if (purchaseEvent.purchasedProduct == null)
        {
            Debug.LogWarning("Attempted to process purchase with unknown product. Ignoring.");
            return PurchaseProcessingResult.Complete;
        }

        if (string.IsNullOrEmpty(purchaseEvent.purchasedProduct.receipt))
        {
            Debug.LogWarning("Attempted to process purchase with no receipt. Ignoring.");
            return PurchaseProcessingResult.Complete;
        }

        Debug.Log("Attempting purchase with receipt " + purchaseEvent.purchasedProduct.receipt);
        GooglePurchase purchasePayload = GooglePurchase.FromJson(purchaseEvent.purchasedProduct.receipt);
        RedeemGooglePlayInventoryItemsRequest request = new()
        {
            Purchases = new List<GooglePlayProductPurchase>
            {
                new()
                {
                    ProductId = purchasePayload.PayloadData?.JsonData?.productId,
                    Token = purchasePayload.PayloadData?.JsonData?.purchaseToken
                }
            }
        };

        PlayFabEconomyAPI.RedeemGooglePlayInventoryItems(request, result =>
        {
            Debug.Log("Processed receipt validation.");

            if (result?.Failed.Count > 0)
            {
                Debug.Log($"Validation failed for {result.Failed.Count} receipts.");
                Debug.Log(JsonUtility.ToJson(result.Failed));
                PlayFabProcessPurchaseEvent?.Invoke(PurchaseProcessingResult.Pending);
            }
            else
            {
                Debug.Log("Validation succeeded!");
                PlayFabProcessPurchaseEvent?.Invoke(PurchaseProcessingResult.Complete);
                s_storeController.ConfirmPendingPurchase(purchaseEvent.purchasedProduct);
                Debug.Log("Confirmed purchase with Google Marketplace.");
            }
        },
        PlayFabSampleUtil.OnPlayFabError);

        return PurchaseProcessingResult.Pending;
    }
}

/// <summary>
/// サンプル用のユーティリティ クラス。
/// </summary>
public class PlayFabEconomyAPIAsyncResult
{
    public string Error { get; set; } = null;

    public string Message { get; set; } = null;
}

public static class PlayFabSampleUtil
{
    public static void OnPlayFabError(PlayFabError error)
    {
        Debug.LogError(error.GenerateErrorReport());
    }
}

/// <summary>
/// PlayFab API のサンプル Async ラッパー。
/// 
/// これは説明目的のみの簡単なサンプルです。
/// 
/// ユーザー向けシナリオのエラーをログに記録および処理するために、独自のカスタム
/// Logger 実装を作成してください。タグを使用し、PlayFab のどのエラーが GUI やゲームプレイの
/// 更新のためにゲームで処理する必要があり、どれがクラッシュおよびエラー レポート サービスに
/// ログ記録すべきかをマッピングしてください。
/// </summary>
public class PlayFabEconomyAPIAsync
{
    /// <summary>
    /// <see href="https://learn.microsoft.com/rest/api/playfab/economy/catalog/get-item"/>
    /// </summary>
    public Task<GetItemResponse> GetItemAsync(GetItemRequest request)
    {
        TaskCompletionSource<GetItemResponse> getItemAsyncTaskSource = new();
        PlayFabEconomyAPI.GetItem(request, (response) => getItemAsyncTaskSource.SetResult(response), error => 
        {
            PlayFabSampleUtil.OnPlayFabError(error);
            getItemAsyncTaskSource.SetResult(default);
        });
        return getItemAsyncTaskSource.Task;
    }

    /// <summary>
    /// <see href="https://learn.microsoft.com/rest/api/playfab/economy/catalog/get-items"/>
    /// </summary>
    public Task<GetItemsResponse> GetItemsAsync(GetItemsRequest request)
    {
        TaskCompletionSource<GetItemsResponse> getItemsAsyncTaskSource = new();
        PlayFabEconomyAPI.GetItems(request, (response) => getItemsAsyncTaskSource.SetResult(response), error => 
        {
            PlayFabSampleUtil.OnPlayFabError(error);
            getItemsAsyncTaskSource.SetResult(default);
        });
        return getItemsAsyncTaskSource.Task;
    }

    /// <summary>
    /// <see href="https://learn.microsoft.com/rest/api/playfab/economy/inventory/purchase-inventory-items"/>
    /// </summary>
    public Task<PurchaseInventoryItemsResponse> PurchaseInventoryItemsAsync(PurchaseInventoryItemsRequest request)
    {
        TaskCompletionSource<PurchaseInventoryItemsResponse> purchaseInventoryItemsAsyncTaskSource = new();
        PlayFabEconomyAPI.PurchaseInventoryItems(request, (response) => purchaseInventoryItemsAsyncTaskSource.SetResult(response), error => 
        {
            PlayFabSampleUtil.OnPlayFabError(error);
            purchaseInventoryItemsAsyncTaskSource.SetResult(default);
        });
        return purchaseInventoryItemsAsyncTaskSource.Task;
    }

    /// <summary>
    /// <see href="https://learn.microsoft.com/rest/api/playfab/economy/catalog/search-items"/>
    /// </summary>
    public Task<SearchItemsResponse> SearchItemsAsync(SearchItemsRequest request)
    {
        TaskCompletionSource<SearchItemsResponse> searchItemsAsyncTaskSource = new();
        PlayFabEconomyAPI.SearchItems(request, (response) => searchItemsAsyncTaskSource.SetResult(response), error => 
        {
            PlayFabSampleUtil.OnPlayFabError(error);
            searchItemsAsyncTaskSource.SetResult(default);
        });
        return searchItemsAsyncTaskSource.Task;
    }
}

[Serializable]
public class PurchaseJsonData
{
    public string orderId;
    public string packageName;
    public string productId;
    public string purchaseToken;
    public long   purchaseTime;
    public int    purchaseState;
}

[Serializable]
public class PurchasePayloadData
{
    public PurchaseJsonData JsonData;

    public string signature;
    public string json;

    public static PurchasePayloadData FromJson(string json)
    {
        var payload = JsonUtility.FromJson<PurchasePayloadData>(json);
        payload.JsonData = JsonUtility.FromJson<PurchaseJsonData>(payload.json);
        return payload;
    }
}

[Serializable]
public class GooglePurchase
{
    public PurchasePayloadData PayloadData;

    public string Store;
    public string TransactionID;
    public string Payload;

    public static GooglePurchase FromJson(string json)
    {
        var purchase = JsonUtility.FromJson<GooglePurchase>(json);

        // エディター プレイ時には偽のレシートのみ返されます。
        if (Application.isEditor)
        {
            return purchase;
        }

        purchase.PayloadData = PurchasePayloadData.FromJson(purchase.Payload);
        return purchase;
    }
}
```

1. **Code** という新しい **GameObject** を作成します。
2. `AndroidIAPExample` コンポーネントを追加します (クリック アンド ドラッグ、または)。
3. シーンを **Save** することを確認してください。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-create-example-game-object.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=49dafb0589b810b6585f17cd073725df" alt="UnityIAP サンプル ゲーム オブジェクトの作成" width="1105" height="757" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-create-example-game-object.png" />

最後に、**Build Settings** に移動します。

1. **Scenes In Build** エリアにシーンが追加されていることを確認します。
2. **Android** プラットフォームが選択されていることを確認します。
3. **Player Settings** エリアに移動します。
4. **Package Name** を割り当てます。

<Note>
  **PlayMarket** の衝突を避けるために、必ず *独自の* パッケージ名を考えてください。
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-add-example-game-object.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=3475d7ac21193c6f4d8056e600146400" alt="UnityIAP サンプル ゲーム オブジェクトの追加" width="1089" height="749" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-add-example-game-object.png" />

最後に、通常どおりアプリケーションをビルドし、APK があることを確認します。

テストするには、PlayMarket と PlayFab を構成する必要があります。

## IAP 用の PlayMarket アプリケーションのセットアップ

このセクションでは、PlayMarket アプリケーションで IAP を有効にする方法の詳細について説明します。

<Note>
  アプリケーション自体のセットアップはこのチュートリアルの範囲外です。すでにアプリケーションを持ち、少なくとも Alpha リリースを公開するように構成されていることを前提とします。
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-enable-playmarket-application.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=471e393f3ea7553f6af3b71ad48d0d42" alt="PlayMarket アプリケーションを有効にする" width="608" height="157" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-enable-playmarket-application.png" />

役立つ注意事項:

* そのポイントに到達するには、APK をアップロードする必要があります。前のセクションで構築した APK を使用します。
* IAP サンドボックスを有効にするには、APK を *Alpha* または *Beta* アプリケーションとしてアップロードします。
* **Content Rating** の構成には、アプリケーションで IAP がどのように有効になっているかについての質問が含まれます。
* PlayMarket は、パブリッシャーが IAP を使用またはテストすることを *許可しません*。テスト目的で *別の* Google アカウントを選び、Alpha/Beta ビルドのテスターとして追加してください。

1. アプリケーション ビルドを公開します。
2. メニューから **In-app products** を選択します。
   * **Merchant Account** の入力を求められた場合は、リンクまたは作成します。
3. **Add New Product** ボタンを選択します。 <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-new-product.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=c1456178bcaf5cb88175f567c9d59ad8" alt="PlayMarket 新規製品追加" width="1151" height="640" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-new-product.png" />
4. 新製品画面で **Managed Product** を選択します。
5. `100diamonds` のような説明的な *Product ID* を与えます。
6. **Continue** を選択します。 <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-id.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=271b7344e7069d7f072e6ef975d574bf" alt="PlayMarket 製品 ID 追加" width="639" height="482" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-id.png" />
7. PlayMarket では、たとえば `100 Diamonds` や `A pack of 100 diamonds to spend in-game` のような **Title (1)** と **Description (2)** を入力する必要があります。**Data Item** のデータは PlayFab サービスからのみ取得され、ID が一致することのみが必要です。 <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-title-description.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=d35ca3f5054934ee2e0805a743e95538" alt="PlayMarket 製品タイトル/説明追加" width="852" height="511" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-title-description.png" />
8. さらにスクロールし、**Add a price** ボタンを選択します。 <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-price.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=904804be3624244921d814200f47bf77" alt="PlayMarket 製品価格追加" width="850" height="378" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-price.png" />
9. "\$0.99" のような有効な価格を入力します (価格が国/地域ごとに個別に変換されることに注目してください)。
10. **Apply** ボタンを選択します。 <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-apply-local-prices.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=2c65bd319208f9c6fc0dedd3f2d6c4af" alt="PlayMarket 製品ローカル価格適用" width="897" height="779" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-add-product-apply-local-prices.png" />
11. 最後に、画面の一番上まで戻り、アイテムのステータスを **Active** に変更します。 <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-make-product-active.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=efd16c08827556f36b5f5921fdf2f338" alt="PlayMarket 製品をアクティブにする" width="671" height="417" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-make-product-active.png" />
12. PlayFab を PlayMarket とリンクするために **Licensing Key** を保存します。
13. メニューの **Services & APIs** に移動します。
14. 次に、**キー** の **Base64** バージョンを探して保存します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-save-product-licensing-key.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=6e1c10d2a1f96480ef9c080247e640f5" alt="PlayMarket 製品ライセンス キーの保存" width="717" height="350" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-save-product-licensing-key.png" />

次のステップは IAP テストの有効化です。Alpha および Beta ビルドではサンドボックスが自動的に有効になりますが、アプリのテストが認可されたアカウントをセットアップする必要があります。

1. **Home** に移動します。
2. 左側のメニューで **Account details** を見つけて選択します。
3. **License Testing** エリアを探します。
4. **Test Accounts** がリストにあることを確認します。
5. **License Test Response** が **RESPOND\_NORMALLY** に設定されていることを確認します。

設定の適用を忘れないでください。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-enable-iap-testing.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=87b433152c575bc304935d1980a7b011" alt="PlayMarket IAP テストの有効化" width="562" height="657" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-playmarket-enable-iap-testing.png" />

この時点で、統合の Play Market 側がセットアップされているはずです。

## PlayFab タイトルのセットアップ

最後のステップは、製品を反映し、Google Billing API と統合するように PlayFab タイトルを構成することです。

1. **Add-ons** を選択します。
2. 次に、**Google** アドオンを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/mLCHf0iQv3VidfBe/images/playfab/identity/player-identity/platform-specific-authentication/tutorials/google-html5/open-google-add-on.png?fit=max&auto=format&n=mLCHf0iQv3VidfBe&q=85&s=1b0af874b0d7e46cf30337e322f0004a" alt="PlayFab Google アドオンを開く" width="1589" height="1043" data-path="images/playfab/identity/player-identity/platform-specific-authentication/tutorials/google-html5/open-google-add-on.png" />

1. **Package ID** を入力します。
2. 前のセクションで取得した **Google App License Key** を入力します。
3. **Install Google** ボタンを選択して変更をコミットします。

次のステップは、100 ダイヤモンド バンドルを PlayFab に反映することです。

### Game Manager

1. 新しい Economy Catalog (V2) の Currency を作成します。
2. **Title** を編集し、**Description** を追加します - たとえば `Diamonds`、`Our in-game currency of choice.`。
3. 通貨を見つけやすくするために **Friendly ID** を追加します: `diamonds`。
4. 変更を完了するために **Save and publish** を選択します。
5. **Currency** リストで通貨を確認します。
6. 次に、新しい Economy Catalog (V2) のバンドルを作成します。
7. **Title** を編集し、**Description** を追加します - たとえば `100 Diamonds Bundle`、`A pack of 100 diamonds to spend in-game.`。
   ```JSON theme={null}
   {
       "NEUTRAL": "100 Diamonds Bundle",
       "en-US": "100 Diamonds Bundle",
       "en-GB": "100 Diamonds Bundle",
       "de-DE": "100 Diamantenbüschel"
   }
   ```

<Note>
  このデータは **Play Market のアイテム タイトルと説明** とは *無関係* で、独立していることに注意してください。
</Note>

1. Content type を使用してバンドルを整理できます - たとえば `appstorebundles`。Content type は ⚙️ > Title Settings > Economy (V2) で管理されます。
2. Display properties にローカライズされた価格を追加することで、実際の価格を追跡します。
   ```json theme={null}
   {
       "prices": [
           "en-us": 0.99,
           "en-gb": 0.85,
           "de-de": 0.45
       ]
   }
   ```
3. バンドルに新しいアイテムを追加します。フィルターで Currencies を選択し、前のセットで作成した通貨を選択します。このバンドルで販売する通貨の量に合わせて Quantity を設定します。
4. "GooglePlay" マーケットプレイス用に新しい Platform を追加します。まだ GooglePlay マーケットプレイスがない場合は、Economy Settings ページで作成できます。**Marketplace ID** を、前のセクションで作成した Google Play Console の Product ID と一致するように設定します。
5. 変更を完了するために **Save and publish** を選択します。
6. **Bundles** リストでバンドルを確認します。

### REST API

***

次に、ゲーム内 NPC ベンダーを表す PlayFab ストアで、プレイヤーが通貨を使えるゲーム内購入を設定できます。

### Game Manager

1. 新しい Economy Catalog (V2) の Item を作成します。
2. **Title** を編集し、**Description** を追加します - たとえば "Golden Sword"、"A sword made of gold."。
3. プレイヤーがストアでアイテムを見つけやすくするために、ローカライズされたキーワードを追加できます。API 経由での後の取得のためにアイテムを整理するために Tag と Content type を追加します。アーマー値、アート アセットへの相対パス、またはゲームで格納する必要のあるその他のデータを格納するために Display Properties を使用します。
4. 新しい価格を追加し、前のステップで作成した通貨を選択します。デフォルトで設定したい価格に Amount を設定します。後で作成する任意のストアで価格を上書きできます。
5. 変更を完了するために **Save and publish** を選択します。
6. **Items** リストでアイテムを確認します。
7. 最後に、新しい Economy Catalog (V2) の Store を作成します。
8. **Title** を編集し、**Description** を追加します - たとえば `Villager Store`、`A humble store run by a humble villager.`。
9. 取得を容易にするために **Friendly ID** を与えます。たとえば `villagerstore`。
10. 前のステップで作成したアイテムをストアに追加します。ストアには複数のアイテムを追加でき、必要に応じてデフォルト価格を上書きできます。
11. 変更を完了するために **Save and publish** を選択します。
12. **Stores** リストでストアを確認します。

### REST API

***

これで PlayFab タイトルのセットアップが完了しました。

## テスト

テスト目的のために、Alpha/Beta リリースを使用してアプリをダウンロードします。

* テスト アカウントと実際の Android デバイスを必ず使用してください。
* アプリを起動すると、IAP が初期化され、アイテムを表す *1 つのボタン* が表示されるはずです。
* そのボタンを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-test-app-iap.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=0570ae5b0f89411e4b2fe56fe1164bab" alt="テスト アプリ - 100 ダイヤモンド購入ボタン" width="1082" height="468" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-test-app-iap.png" />

IAP 購入が開始されます。購入が成功する時点まで Google Play の指示に従います。

<img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy-v2/tutorials/unity-android-test-app-google-play-payment-successful.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=281c211a7ceb93300685c9c9e593cc8e" alt="テスト アプリ - Google Play - 支払い成功" width="428" height="290" data-path="images/playfab/economy-monetization/economy-v2/tutorials/unity-android-test-app-google-play-payment-successful.png" />

最後に、PlayFab の **Game Manager** ダッシュボードでタイトルに移動し、**New Events** を見つけます。

購入が提供、検証され、PlayFab エコシステムにパイプされたことを確認します。

UnityIAP と Android Billing API を PlayFab アプリケーションに正常に統合しました。

## 次のステップ

1. デモの IMGUI ディスプレイを置き換えるための購入用の Unity UI Toolkit インターフェイスを構築します。
2. PlayFab エラーを処理してユーザーに表示するためのカスタム Unity Logger を作成します。
3. Unity UI で表示するために、PlayFab の Items Images フィールドにアイコン画像を追加します。


## Related topics

- [PlayFab Economy Legacy、Unity IAP、Android を使い始める](/ja-jp/services/playfab/economy-monetization/economy/tutorials/getting-started-with-unity-iap-android.md)
- [Google マーケットプレイスでの引き換え](/ja-jp/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/google.md)
- [リワード広告を使い始める](/ja-jp/services/playfab/economy-monetization/rewarded-ads/quickstart.md)
- [PlayFab for Unity (v2 Unified)](/ja-jp/services/playfab/sdks/unified-unity/overview.md)
- [Android Studio とプッシュ通知の使い始め](/ja-jp/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/getting-started-android-studio-push-notifications.md)