API から SDK への移行

PC 版 Google Play Games のネイティブ ゲームが Play Billing API を直接呼び出している場合は、PC SDK を使用するようにゲームを移行する必要があります。

使用しているゲームエンジンに応じて、C++ SDK または C# SDK を統合できます。ネイティブ ゲームを SDK に移行するために使用できる例を示すサンプル プロジェクトを参照してください。

セットアップと準備

このセクションでは、API ベースのソリューションから PC 版 Google Play Games ネイティブ SDK への移行手順について説明します。

コマンドライン引数

PC 版 Google Play Games Native SDK は、ゲーム プロセスの起動時に渡される一部のコマンドライン引数に依存してユーザーを認証します。これらの引数は、Initialize SDK を呼び出すプロセスに渡す必要があります。ゲームの起動に複数のプロセスが関与している場合は、最終的に SDK を使用するプロセスにすべての引数が渡されることを確認する必要があります。セットアップの複数のゲーム プロセスのサポートの手順を確認してください。

API マッピング

移行を完了するには、Google Play サーバーへの直接 API 呼び出しをすべて削除する必要があります。SDK には、同じ機能を実現するための対応する関数呼び出しがあります。このセクションでは、各機能のマッピングを一覧表示します。

Google ログイン

Google ログイン（Google でログインとも呼ばれます）は、Google アカウントを持つユーザーにワンクリック認証オプションを提供する OAuth 認証方法です。API ベースのプロジェクトでは、プレーヤーのアカウントを購入に関連付けます。SDK ベースのソリューションでは、この関連付けは必要ありません。

SDK ベースのソリューションでは、プレーヤーのゲーマー プロフィールと利用資格にすでに関連付けられている Google Play Games クライアントの Google アカウントを使用します。これにより、SDK が IPC を介して Google Play Games クライアントと安全に通信できるため、プレーヤーにはよりシームレスなエクスペリエンスが提供され、デベロッパーにはより安全な環境が提供されます。

Google ログインの代わりに、できるだけ早く SDK を初期化します。エラーコードに応じて対応し、ゲームのランタイムに安全な環境を提供します。

商品リストを取得する

API ソリューションでは、バックエンド サーバーが Play Developer API の inappproduct.gets エンドポイントを使用して商品リストを取得します。

SDK で、QueryProductDetails 関数を使用して、クライアントでアプリ内アイテムのリストを直接取得します。

購入を促す

API ソリューションでは、バックエンド サーバーが Play Developer API の purchases.products.get エンドポイントを使用してユーザーの購入情報を取得します。

SDK で、ゲーム クライアントから QueryPurchases 関数を直接使用します。

購入フローを開始する

API ソリューションでは、購入フローを開始するには、設定のために複数のエンドポイントを呼び出し、必要なトークンを取得する必要があります。

SDK で、BillingClient の LaunchPurchaseFlow 関数を呼び出してプロセスを起動します。必要な作業はすべて SDK が処理します。

購入を処理する

ユーザーの購入を処理するには、購入が正当であることを検証した後に、購入を承認して使用することが含まれます。API ソリューションと SDK ソリューションの両方で、セキュリティ上の理由からバックエンドで完了する手順が推奨されています。

API ソリューションと SDK ソリューションのプロセスは似ています。

API ソリューションの ProductPurchase.purchaseToken や SDK ソリューションの ProductPurchaseDetails の purchase_token など、購入から purchaseToken を取得したら、検証のためにバックエンドに送信します。

検証が完了すると、バックエンドは利用権を付与した後、購入を安全に承認または消費できます。

テスト用に送信する

テスト用にゲームを送信する手順は次のとおりです。

提出用パッケージ

SDK を使用するゲームは、Windows アプリバンドル形式でパッケージ化し、Google Play Console からアップロードする必要があります。ドキュメントを参照して、ゲームを Windows App Bundle にパッケージ化します。