PlayFab (Legacy Economy)、Unity IAP、Android を使い始める
Economy v1 API はメンテナンス モードにあり、新機能は追加されず、バグ修正のみが行われます。v1 API は当面の間、維持されます。 PlayFab Economy の次のバージョンの詳細については、Economy v2 の概要 を参照してください。
始める前に
IAP のセットアップは、さまざまなサービスがどのように統合され連携するのかがはっきりしていないと、面倒に感じられるかもしれません。 以下の画像は、Android Billing API と PlayFab がどのように連携してクライアントに堅牢な IAP エクスペリエンスを提供するかを示しています。 まずは PlayMarket を介して Product ID と Prices をセットアップします。当初、すべての製品は 素顔なし の状態です。プレイヤーが購入可能なデジタル エンティティですが、PlayFab プレイヤーにとって意味を持ちません。 これらのエンティティを役立つようにするには、PlayFab のアイテム カタログでミラーリングする必要があります。これによって、素顔なしのエンティティがバンドル、コンテナー、個別のアイテムになります。 各エンティティは、次のような独自の姿を持ちます。- タイトル
- 説明
- タグ
- タイプ
- 画像
- 動作
クライアント アプリケーションのセットアップ
このセクションでは、PlayFab、UnityIAP、Android Billing API を使用して IAP をテストするための非常にシンプルなアプリケーションを構成する方法を説明します。 前提条件:- Unity プロジェクト。
- タイトルに対して構成された PlayFab SDK。
- Services に移動します。
- Services タブが選択されていることを確認します。
- Unity Services プロファイルまたは組織を選択します。
- Create ボタンを選択します。
- 次に、In-App Purchasing (IAP) サービスに移動します。
- Simplify cross-platform IAP トグルを設定して、サービス を有効にしてください。
- その後、Continue ボタンを選択します。
- Import ボタンを選択します。
- プラグインが配置されていることを確認します。
- AndroidIAPExample.cs という名前の新しいスクリプトを作成します。
AndroidIAPExample.cs には、下記のコードを含めます (詳細はコード コメントを参照してください)。
- Code という名前の新しい Game オブジェクトを作成します。
- それに
AndroidIAPExampleコンポーネントを追加します (2 段階のプロセス)。 - それに
AndroidIAPExampleコンポーネントを追加します。 - シーンを保存 することを忘れないでください。
- シーンが Scenes In Build エリアに追加されていることを確認します。
- Android プラットフォームが選択されていることを確認します。
- Player Settings エリアに移動します。
- Package Name を割り当てます。
PlayMarket での衝突を避けるため、必ず 独自の パッケージ名を考案してください。
IAP 用の PlayMarket アプリケーションのセットアップ
このセクションでは、PlayMarket アプリケーションで IAP を有効にする具体的な方法を説明します。アプリケーション自体のセットアップはこのチュートリアルの範囲外です。既にアプリケーションを 持っており、少なくとも Alpha リリースを公開するように構成されていることを前提とします。
- ここまで到達するには APK をアップロードする必要があります。前のセクションで作成した APK を使用してください。
- APK のアップロードを求められたときは、IAP サンドボックスを有効にするために Alpha または Beta アプリケーションとしてアップロードできます。
- Content Rating の構成には、アプリケーション内でどのように IAP を有効にするかに関する質問が含まれます。
- PlayMarket では、発行者が IAP を使用したりテストしたりすることは 許可されません - そのため、テスト用に 別の Google アカウントを選び、Alpha/Beta ビルドのテスターとして追加してください。
- メニューから In-app products を選択します。
- Merchant Account を求められた場合は、リンクまたは作成します。
- Add New Product ボタンを選択します。
- 以下に示す画面で、Managed Product を選択します。
- 分かりやすい Product ID を付けます。
- Continue を選択します。
- さらにスクロールして、Add a price ボタンを選択します。
- 有効な価格を入力します (国/地域ごとに価格が個別に換算されることに注意してください)。
- Apply ボタンを選択します。
- 最後に、画面の一番上に戻り、アイテムのステータスを Active に変更します。
- メニューで Services & APIs に移動します。
- 次に、Base64 バージョンの Key を見つけて保存します。
- Home に移動します。
- 左側のメニューで Account details を見つけて選択します。
- License Testing エリアを見つけます。
- Test Accounts がリストにあることを確認します。
- License Test Response が RESPOND_NORMALLY に設定されていることを確認します。
PlayFab タイトルのセットアップ
最後のステップは、製品を反映して Google Billing API と統合するために PlayFab タイトルを構成することです。- Add-ons を選択します。
- 次に、Google アドオンを選択します。
- Package ID を入力します。
- 前のセクションで取得した Google App License Key を入力します。
- Install Google ボタンを選択して変更を確定します。
- Economy を選択します。
- Catalogs サブタブが選択されていることを確認します。
- New Catalog を選択します。
- Catalog version の名前を入力します。
- Save Catalog を選択します。
- アイテムを選択し、PlayMarket の ID と一致するように Item ID を編集します。
- 次に、Display name を編集し、Description を追加します。
このデータは Play Market Item Title と Description とは まったく関係ない ことに注意してください - 完全に独立しています。
- アイテム に Price を割り当てます。
- Save Item を選択して変更を確定します。
このチュートリアルでは、IAP は主にリアル マネーでの購入を指します。そのため、特別なリアル マネー通貨である RM を使用します。PlayFab の金額は米セント単位で定義されます。
- Item ID リストでアイテムを確認します。
テスト
テスト目的では、Alpha/Beta リリースを使用してアプリをダウンロードします。- テスト アカウントと実際の Android デバイスを使用してください。
- アプリを起動すると、IAP が初期化され、アイテムに対応した 1 つのボタン が表示されます。
- そのボタンを選択します。
