このページは Cloud Translation API によって翻訳されました。

Unity で Google Play Instant を使用する

Unity 用の Google Play Instant プラグインは、Instant App 版のゲーム作成用に Unity プロジェクトを設定します。このガイドでは、Google Play Instant プラグインをインストールして使用する方法を説明します。

プラグインをダウンロードしてインポートする

このプラグインは、Google Play の Unity 向けプラグインの一部です。プラグインをインポートする手順は、次のとおりです。

Google Play の Unity 向けプラグインのリリースから最新のリリースをダウンロードします。
Unity IDE メニューオプションの [Assets] > [Import Package] > [Custom Package] を選択し、すべてのアイテムをインポートして、.unitypackage ファイルをインポートします。

Unity エディタの機能

プラグインをインポートして、Unity で [Google] > [Play Instant] サブメニューを追加します。このサブメニューには次のオプションがあります。

ビルド設定

[Installed] と [Instant] の開発モードを切り替えるウィンドウを開きます。[Instant] に切り替えると、次の変更が行われます。

#if PLAY_INSTANT と #endif を使用したスクリプト記述に使用できる、PLAY_INSTANT というスクリプト定義シンボルを作成します。
android:targetSandboxVersion など、必要な特定の変更に対する AndroidManifest.xml の更新を管理します。

プレーヤー設定

図 1 のプレーヤー設定ダイアログには、Google Play Instant のサポートの最適化、より互換性の高いグラフィック API での開発、APK のサイズの縮小に役立つヒントが表示されます。

具体的には、OpenGL ES 2.0 のみの使用や、マルチスレッドレンダリングの無効化などです。 — **図 1.** **プレーヤー設定**ダイアログ

これらのプレーヤー設定は、必須設定と推奨設定に分類されます。設定の更新ボタンがある場合は、クリックして設定を希望の値に変更できます。

APK のサイズをさらに縮小するには、Unity Package Manager を開いて未使用のパッケージを削除します。

Quick Deploy

Quick Deploy は、一部のアセットを AssetBundle にパッケージ化することにより、Unity ベースの Instant App のサイズを縮小できます。Quick Deploy を使用すると、Unity のゲームエンジンと読み込み画面が Instant App APK にパッケージ化され、Instant App の起動後に AssetBundle がサーバーから取得されます。

インストールのワークフローをサポートする

多くの場合、Instant App の目標は、ユーザーが完全版のインストールに先駆けてアプリを体験できるようにすることです。Unity 用の Google Play Instant プラグインは、Play ストアのインストールダイアログの表示、Instant App からインストール済みアプリへの状態の移行のための API を備えています。

インストールメッセージを表示する

Instant App にインストール ボタンがある場合、インストールボタンのクリックハンドラから次のコードを呼び出すことで、Play ストアのインストールダイアログを表示できます。

Google.Play.Instant.InstallLauncher.ShowInstallPrompt();

ShowInstallPrompt() メソッドのオーバーロードでは、次の 1 つ以上の操作が可能です。

ユーザーがインストールプロセスを無効にしたかどうかを判断する。Instant App のメインアクティビティで、onActivityResult() をオーバーライドし、指定した requestCode で RESULT_CANCELED を確認します。
referrer パラメータを使用してインストールリファラー文字列を渡す。
現在のゲームセッションの状態を PutPostInstallIntentStringExtra() 経由で渡す。

次の例で説明します。

using Google.Play.Instant;
...
const int requestCode = 123;
var sessionInfo = /* Object serialized as a string representing player's current location, etc. */;
using (var activity = UnityPlayerHelper.GetCurrentActivity())
using (var postInstallIntent = InstallLauncher.CreatePostInstallIntent(activity))
{
    InstallLauncher.PutPostInstallIntentStringExtra(postInstallIntent, "sessionInfo", sessionInfo);
    InstallLauncher.ShowInstallPrompt(activity, requestCode, postInstallIntent, "test-referrer");
}

ユーザーがアプリのインストールを完了すると、Play ストアは提供された postInstallIntent を使用してアプリを再起動します。インストール済みのアプリは、以下のコードを使用して postInstallIntent に設定された値を取得できます。

var sessionInfo = InstallLauncher.GetPostInstallIntentStringExtra("sessionInfo");

注:

ユーザーがアプリをインストールした後に起動をキャンセルした場合、postInstallIntent に含まれるエクストラがインストール済みのアプリに届かないことがあります。インテントエクストラを渡すには、永続的な状態を保持するよりもアクティブなセッション状態を保持する方法が適しています。永続的な状態を保持する場合については、Cookie API を参照してください。
どなたでも、追加フィールドを使用してインテントを作成し、インストール済みのアプリを起動できます。そのため、価値を持つペイロードは、一度しか使用できないように設計します。また、暗号技術を使って署名し、サーバー上で署名を検証するようにします。

Cookie API を使用する

Cookie API は、Instant App から対応するインストール済みのアプリに Cookie（プレーヤー ID やステータスを補完するデータなど）を渡すためのメソッドを提供します。postInstallIntent エクストラとは異なり、Cookie の状態はユーザーがインストール済みのアプリをすぐに起動しなくても使用できます。たとえば、Instant App では、インストールボタンのクリックハンドラから次のコードを呼び出すことができます。

using Google.Play.Instant;
...
var playerInfo = /* Object serialized as a string representing game levels completed, etc. */;
var cookieBytes = System.Text.Encoding.UTF8.GetBytes(playerInfo);
try
{
    var maxCookieSize = CookieApi.GetInstantAppCookieMaxSize();
    if (cookieBytes.Length > maxCookieSize)
    {
        UnityEngine.Debug.LogErrorFormat("Cookie length {0} exceeds limit {1}.", cookieBytes.Length, maxCookieSize);
    }
    else if (CookieApi.SetInstantAppCookie(cookieBytes))
    {
        UnityEngine.Debug.Log("Successfully set cookie. Now display the app install dialog...");
        InstallLauncher.ShowInstallPrompt();
    }
    else
    {
        UnityEngine.Debug.LogError("Failed to set cookie.");
    }
}
catch (CookieApi.InstantAppCookieException ex)
{
    UnityEngine.Debug.LogErrorFormat("Failed to set cookie: {0}", ex);
}

ユーザーがアプリのインストールを完了すると、インストール済みのアプリは以下のコードを使用して Cookie データを取得できるようになります。

var cookieBytes = CookieApi.GetInstantAppCookie();
var playerInfoString = System.Text.Encoding.UTF8.GetString(cookieBytes);
if (!string.IsNullOrEmpty(playerInfoString))
{
    // Initialize game state based on the cookie, e.g. skip tutorial level completed in instant app.
}