他のサービスを利用した UDP の使用

UDP ビルドの GooglePlay ゲームサービス

概要

• アプリケーションの パッケージ名
• アプリケーションが署名された 証明書

UDP ビルド用に Google Play ゲームサービスを設定

1. Google Play Console で、ターゲットアプリケーションに移動します。
2. Play Games Services > Setup and management > Configuration の順に移動します。
   • Google Play ゲームに Google Play ゲームサービスが実装されている場合は、すでに Google Play ゲームサービスプロジェクトに紐づけられています。このケースでは、次のようにします。
     1. Use an existing Play Games Services project を選択します。
     2. プロジェクトを選択して Use を選択します。
     3. UDP アプリケーションをゲームサービスに紐づける のステップに従います。
   • Google Play ゲームに Google Play ゲームサービスが実装されていない場合は、以下を行ってください。
     1. Play Games Services 設定ページで、Yes, my game already uses Google APIs か No, my game doesn’t use Google APIs を選択します。
     2. Google Play ゲームサービスプロジェクトの作成と紐づけ のステップに従います。

Google Play ゲームサービスプロジェクトの作成と紐づけ

1. クラウドプロジェクトを選択します。
2. Use を選択して、新規の Play Games Services プロジェクトを作成し、既存のクラウドプロジェクトに紐づけます。

1. ゲーム名を入力します。
2. Create を選択して、新規の Play Games Services プロジェクトを作成し、既存のクラウドプロジェクトに紐づけます。

1. Configure OAuth consent screen を選択します。
2. Play Games Services 設定画面で Refresh を選択します。
   Add credential オプションが有効になりました。
3. Add credential を選択します。
   Add credential ページが開きます。
4. Add credential ページで以下を行います。
   1. Type に Android を選択します。
   2. Enable anti-piracy を Off に設定します。これにより、ユーザーは Google Play 以外のアプリストアからゲームをインストールした場合でも、ゲームにアクセスできます。
   3. Authorization セクションで、Create OAuth client を選択します。選択するとポップアップ画面が表示されます。
   4. Create OAuth Client ID を選択し、ポップアップ画面に入力してフォームを完成します。

UDP アプリケーションをゲームサービスに紐づける

1. Google Play Console で、Play Games Services > Setup and management > Configuration の順に移動します。
   1. Play Games Services 設定ページで Add credential を選択します。
2. Add credential ページで以下を行います。
   1. Android を選択します。
   2. Enable anti-piracy を Off に設定します。これにより、ユーザーは Google Play 以外のアプリストアからゲームをインストールした場合でも、ゲームにアクセスできます。
   3. Authorization セクションで、Create OAuth client を選択します。選択するとポップアップ画面が表示されます。
   4. Create OAuth Client ID を選択し、ポップアップ画面に入力してフォームを完成します。
3. Create OAuth client ID フォームで必要な項目を記入し、UDP ビルドのエントリーを作成します。
   1. Name フィールドで、例えば “Samsung version” のような、対応するストアに関連する名前を付けます。
   2. Package name フィールドで、UDP コンソールを通して対応するストアに登録されているビルドのパッケージ名を指定します。
      ストア特有のパッケージ名は UDP コンソールに表示されます。
      1. My Games > Publish タブを選択します。
      2. 対応するストアの Advanced を選択します。
         パッケージ名は Basic Information セクションに表示されます。
   3. Certificate フィールドには、対応する UDP ストアの証明書を使用します。Repack 操作後、UDP は新しい証明書でアプリケーションに署名します。
      ストア固有の証明書が UDP コンソールに表示されます。
      1. My Games > Publish タブを選択します。
      2. 対応するストアの Advanced を選択します。
         証明書が Basic Information セクションに表示されます。
         ノート: 以下のコマンドを使用して APK 証明書をダウンロードし、フィンガープリント情報を取得することもできます。

         openssl x509 -in [downloaded-pem-filepath] -fingerprint -noout

      3. SHA-1 を UDP コンソールから証明書フィールドにコピーします。
4. フォームを記入し終わったら Create を選択し Google Play Console に戻ります。
5. Refresh OAuth clients を選択します。
6. 新しい OAuth クライアントを選択します。
   1. Save changes を選択し、認証情報を保存します。
7. Google Play アプリケーションに紐づけるストア固有の UDP ビルドごとに、上記のステップを繰り返します。

Build Automation を UDP に使用する

• APK を Build Automation にアップロード し、そこから UDP にデプロイします。
• Build Automation でゲームをビルド し、そこから UDP にデプロイします。

Build Automation を使ってビルドを UDP コンソールにプッシュする

エディターで Build Automation を使用してゲームを UDP にデプロイする

1. Project Settings ウィンドウの Build Automation タブで、これまでビルドをアップロードしたことがない場合は、Upload Build を選択します。
2. FILE で以下を行います。
   • UDP ビルドの APK を選択してください
   • 使いやすい LABEL を入力してください
   • PLATFORM フィールドを Android に設定します。
3. UPLOAD を選択して、アップロードプロセスを完了させます。
4. Project Settings ウィンドウの Build Automation タブで、ビルドの History タイムラインから目的のビルドを見つけ、Push to Unity Distribution Portal を選択します。
   1. プッシュすることを確認します。

Unity Dashboard を使ってゲームを UDP に展開

1. Unity Developer Dashboard で、プロジェクトの Build Automation > History に移動します。
2. Upload を選択し APK ファイルを選択します。
3. Platform フィールドで Android を選択します。
4. Upload を選択します。
5. ビルド横の More メニューを選択して、ドロップダウンを開きます。
6. Push to Unity Distribution Portal を選択します。

Build Automation を使ったビルドとデプロイ

1. Manage Build Targets > Add new build target の順に選択します
2. TARGET SETUP ウィンドウで PLATFORM フィールドを Android に設定し、使いやすい TARGET LABEL を入力します。
3. Next: Save を選択します。
4. Start Build Automation を選択してから、作成したターゲットビルドを選択します。

サービスの相互運用性

どのような仕組みなのですか？

udp.json

udpStore

udp.json を保存場所

udp.json

Application.PersistentDataPath + '/Unity' + /Application.CloudProjectID + /udp/udp.json

• Application.PersistentDataPath

  はゲームの永続データパスです。

• Application.CloudProjectID

  はゲームの Unity プロジェクト ID です。

udp.json

path/storage/emulated/0/Android/data/com.mystudio.mygame/files/Unity/c83d2de2-de74-4b75-83fc-ade948bda064/udp/udp.json

• Application.PersistentDataPath

  =

  path/storage/emulated/0/Android/data/com.mystudio.mygame

• Application.CloudProjectID

  =

  c83d2de2-de74-4b75-83fc-ade948bda064

udp.json の読み込み

udp.json

{"key":"UDP","udpStore":"StoreName","udpClientId":"value_of_udpClientId","CloudProjectId":"value_of_CloudProjectId"}

udpStore

udp.json

{"key":"UDP","udpStore":"Huawei","udpClientId":"icjaB7wmu_q7AOjrSLH8yw","cloudProjectId":"bc2be074-09f3-450f-8e98-a0f79c9746f7"}

JSONUtility.FromJsonOverwrite

udpStore 値

udpStore

Remote Config を通した udpStore の使用

udpStore

1. UDP パッケージ をダウンロードしてインストールします。
2. Unity Remote Config パッケージをダウンロードしてインストールします。Remote Config ドキュメントを参照してください。
3. "udpStore" パラメーターを最低限含む AppAttributes 構造体を作ります。

   public struct AppAttributes{  public string udpStore;}

4. ゲームコードで Remote Config の ConfigManager.FetchConfigs コールを実装します。
5. FetchConfigs を呼び出すときは、AppAttributes 構造体の新しいインスタンスを作成し、UDP ストアデータファイルを Application.PersistentDataPath + '/Unity' + /Application.CloudProjectId + /udp/udp.json から読み取ります。JSONUtility.FromJsonOverwrite を使用してファイルのコンテンツをテキストアセットとして読み取ります。

   {    string udpFilePath = System.IO.Path.Combine(Application.persistentDataPath, "Unity", Application.cloudProjectId, "udp", "udp.json");    string udpFileContents = System.IO.File.ReadAllText(udpFilePath);    var appAttr = JsonUtility.FromJson<AppAttributes>(udpFileContents);    Unity.RemoteConfig.ConfigManager.FetchCompleted += ConfigManager_FetchCompleted;    Unity.RemoteConfig.ConfigManager.FetchConfigs(null, appAttr);}

6. AppAttributes 構造体を ConfigManager.FetchConfigs で使用するよう注意してください。
7. Remote Config (Services > Remote Config > Configure) 設定を開き、UDP ストアに基づいて変更したいパラメーターを作成します。
8. パラメーターを設定し、ゲームコードに組み込んだら、Remote Config ウィンドウで各ストアのルールを作成します。
9. 各ルールの条件に、app.udpStore == "[storeName]" を入力します。
   • udpStore 値 を参照

     

10. 設定を有効にするには、Remote Config 設定の左パネルにあるルール名 の横にあるチェックボックスを選択します。
11. アプリケーションをデバイスにビルドし、ルールが正しく適用されていることを確認して、配布します。

Unity IAP を使用した UDP 用の IAP アイテムの実装

• UDP の初期化
• ストアの IAP プロダクトインベントリのクエリ
• プロダクトの購入のリクエスト
• 購入したアイテムの消費

IAP インベントリのクエリ

Unity IAP (コードによる実装) を使用

エディターで定義した IAP プロダクトを取得

queryInventory

ProductCatalog.LoadDefaultCatalog()

var catalog = ProductCatalog.LoadDefaultCatalog();foreach (var product in catalog.allValidProducts){   if (product.allStoreIDs.Count > 0)   {       var ids = new IDs();       foreach (var storeID in product.allStoreIDs)       {           ids.Add(storeID.id, storeID.store);       }       builder.AddProduct(product.id, product.type, ids);   }   else   {       builder.AddProduct(product.id, product.type);   }}

UDP コンソールから IAP プロダクト情報を取得

queryInventory

builder.AddProduct(product.id, product.type, new IDs{})

productInfo.Value.Price

UDP コンソールから IAP カタログを取得

Unity IAP パッケージを IAP カタログに入力

1. Unity エディターで Services > Unity IAP > IAP Catalog を選択します。
2. Add Product を選択し、各 IAP プロダクトに詳細情報を入力します。
   1. Unity Distribution Portal Configuration で IAP アイテムの価格を追加します。

      

3. IAP プロダクトを UDP コンソールに保存するには、Sync to UDP を選択します。作成した各 IAP プロダクトに対し、この操作を行います。