このセクションには、now.ggクラウドに関連する追加ガイドが含まれており、now.ggクラウドのサービスやAPIを便利に設定することができます。
利用可能な追加のガイド
以下のガイドをご利用いただけます。
ユーザーのステータスを保存するためのクラウドストレージの設定
ゲームは通常、ゲームセッション全体の継続性を維持するために、ユーザーの進行状況をデバイスファイルにローカル保存します。 now.ggはこの機能をクラウド上で提供し、ユーザーにシームレスなゲームプレイ体験を提供します。
このセクションでは、保存ファイルパスと除外ファイルパスを定義することで、ユーザーのゲーム進行データの保存と復元に使用されるnow.ggクラウドストレージの設定が主になります。「保存」および「除外」ファイルパスを定義することは、ゲームの読み込み時間を短縮し、ユーザーエクスペリエンスを向上させ、now.ggクラウドストレージの最適な使用を保証するために必要不可欠です。クラウドストレージを設定するには、以下を指定する必要があります:
- 保存ファイルのパス
クラウド上に保存するファイルまたはフォルダの場所を示します。通常、保存ファイルは /data/data/<package_name>/<file_name>
に保存されます。
- 除外ファイルパス
クラウド上に保存したくないファイルやフォルダの場所を示します。
ファイルパスの設定
この設定は、now.ggに提出するすべての新しいアプリに対して行うことができます。既に提出・公開済みのアプリの場合は、新しいバージョンのアプリを提出する必要があります。
ファイルパスを設定するには以下の手順に従ってください。
- nowStudioにログインします。
- 新しいアプリを追加したり、新しいバージョンを提出します。
- 新しいアプリを追加するには、こちらの手順に従ってください。
- 新しいバージョンのアプリを提出する場合はこちらの手順に従ってください。
- 新しいバージョンを提出する際、2番目のオプション「アセット、タイトル、説明、または地域情報とともにAPKとアプリのコンテンツを更新する」を選択し、「提出」をクリックします。
- 「アプリコンテンツ」タブにて
- 保存ファイルパスと除外ファイルパスを指定します。
- 「保存」をクリックします。
- アプリ用のリリースを作成します。
注意事項:
- 複数のファイルパスを指定する場合は、スペースやカンマではなく、改行で区切ってください。
- 保存ファイルパスの場合、指定したファイルとフォルダのみが保存され、次のユーザー セッションで復元されます。
- 除外ファイルパス(任意)では、指定したファイルとフォルダはクラウド上に保存されません。
重要な情報
- ゲームの読み込み時間は、ユーザーセッション用に復元されるゲームデータのサイズに依存します。
- シームレスなアプリ体験のために、理想的な保存ファイルサイズは15MBまでを推奨します。
- 推奨ファイルサイズは、単一のファイル、または複数のファイルの合計サイズに適用されます。
- 大きなファイルを含めると、ゲームの読み込み時間に影響を与える可能性があります。
- より良いエクスペリエンスのために、アプリ内で
Android ID
などのAndroid識別子の使用を避けることをお勧めします。
アプリファイルの準備
このガイドを使用して、nowStudioにアップロードするアプリファイルを準備できます。
nowStudioでリリースを作成するには、アプリファイルを準備する必要があります。スタンドアロンのAPK、またはAPKとアセットのZipファイルのどちらでも構いません。
以下のいずれかを準備することができます:
- スタンドアロンのAPKファイル
- すべてのアセットを含む完全なAPKを提供することができます。
- APKとアセットのZipアーカイブ
- 通常、ゲームは起動時に必要なアセットをダウンロードするため、ゲームプレイに遅延が発生します。 now.ggを使用すると、APKとアセットを含むZipが提供されるため、ゲームの読み込み時間が大幅に短縮され、ユーザーは瞬時にゲームをプレイできるようになります。
1. APKファイルの準備
このセクションでは、nowStudioにアップロードするAPKファイルを準備する手順を説明します。
以下の要件を満たす APKファイルを用意してください:
- ARM用64bit Androidアプリ
- すべてのアセットを含む完全なAPK
APKを準備したら、nowStudioにアプリを追加することができます。
2. APKとアセットZipアーカイブを準備する
このセクションでは、nowStudioでアプリ/ゲームのAPKとアセットのZipアーカイブを準備する手順を説明します。
通常、ゲームは起動時に必要なアセットをダウンロードするため、ゲームプレイに遅延が発生します。 now.ggを使用すると、APKとアセットを含むZipが提供されるため、ゲームの読み込み時間が大幅に短縮され、ユーザーは瞬時にゲームをプレイできるようになります。
手順
1. バンドルの作成 (Zipアーカイブ)
アプリとアセットのZipアーカイブを作成するには、以下の指定されたフォーマットと内容に従ってください:
- APKファイル
- metadata.json
- アセットディレクトリ
- アセット1
- アセット2
- その他のアセット (ファイルまたはディレクトリ)
- Obbディレクトリ
- メイン.<パッケージバージョンコード>.<パッケージ名>.obb
- パッチ.<パッケージバージョンコード.<パッケージ名>.obb
以下は、ゲームAPK + アセットバンドルのサンプルです。
重要な情報
- アプリバンドルのアセットフォルダには、複数のオブジェクトを含めることができます。
- あらゆるファイルやディレクトリを含むことができます。
- ユーザーの希望に応じて、アセットまたはObbのどちらか、あるいは両方をご提供いただくことをお勧めします。ただし、アップロードを成功させるには、どちらか一方が必須です。
2. マニフェストファイルの作成
次のサンプルJSONは、マニフェストファイルmetadata.jsonに必要なフォーマットを示しています。
{
"assets": [
{
"name": "asset1.xyz",
"location": "/data/media/0/Android/data/<packageName>/files"
},
{
"name": "asset2.unity3d",
"location": "/data/media/0/Android/data/<packageName>/files"
},
{
"name": "OtherAssets",
"location": "/data/data/<packageName>/files"
}
]
}
3. アプリの追加
APKとアセットZipアーカイブを準備したら、nowStudioにアプリを追加してください。
カスタムドメインの追加と設定
このガイドでは、now.gg以外のドメインでアプリをホストしたい場合のカスタムドメインの追加手順について詳しく説明します。
now.ggクラウドに加え、nowStudioでアプリ用のカスタムドメインを追加することで、他のドメインでアプリをホストすることもできます。
以下のシナリオについての説明:
- 新規アプリにカスタムドメインを追加する。
- 公開済みアプリにカスタムドメインを追加する。
1. 新規アプリ用にカスタムドメインを追加する
このセクションでは、新規のアプリにカスタムドメインを追加する手順を説明します。
手順は以下の通りです。
- 新規のアプリを追加します。
- 「全アプリ」セクションからアプリを選択します。
- アプリ名の前にある「詳細を見る」をクリックします。
- 「プロダクション」セクションで、「情報」をクリックします。
- 以下のように、所定のフィールドにカスタムドメインのアドレスを入力します。
注意:追加したいドメインを所有していることを確認してください。
- その他の必要事項が記入されていることを確認します。
- 「保存」をクリックします。
- 当社のチームが、入力されたドメインの詳細を確認します。ドメインの詳細が確認されたら、ドメインのマッピングを続行できます。
- 必要なアプリ情報をすべて提供したら、アプリのリリースを作成することができます。
- マッピングの詳細を受け取ったら、以下のように「情報」タブ内の「マッピングの詳細」をクリックしてマッピングの詳細を見ることができます。
- ドメインマッピングの詳細は以下の通りです。
- 提供された詳細を使用して、DNSプロバイダーを設定することができます。
- 自身のDNSプロバイダーで提供された設定を実行した後、ゲームは自身のドメインで利用できるようになります。
2. 公開済みアプリ用にカスタムドメインを追加する
このセクションでは、すでに公開されているアプリにカスタムドメインを追加する手順を説明します。
手順は以下の通りです。
- 「全アプリ」セクションからアプリを選択します。
- アプリ名の前にある「詳細を見る」をクリックします。
- 「プロダクション」セクションで、「情報」をクリックします。
- 画面右下の「編集」ボタンをクリックします(これで提供されたフィールドを編集できるようになります)
- 以下のように、所定のフィールドにカスタムドメインのアドレスを入力します。
※追加したいドメインを所有していることを確認してください。
- 「保存」をクリックします。
- 以下のような確認画面が表示されます。
- 当社のチームが、提供されたドメインの詳細を確認します。ドメインの詳細が確認されたら、ドメインのマッピングを続行できます。
- マッピングの詳細を受け取ったら、以下のように「情報」タブ内の「マッピングの詳細」をクリックして表示することができます。
- ドメインマッピングの詳細は以下の通りです。
- 提供された詳細を使用して、DNSプロバイダーを設定することができます。
- 自身のDNSプロバイダーで提供された設定を実行した後、ゲームは自身のドメインで利用できるようになります。
Nowgg CLIを使用したアプリのアップロード
nowgg CLIは、アプリのビルドをnowStudioに簡単にアップロードできるコマンドラインツールです。このガイドでは、この機能の詳細を説明します。
必須事項
- アプリID
- nowStudio上のアプリを識別するために使用されます。
- アプリIDは、nowStudioのアプリの詳細セクションで確認できます。
- パブリッシャートークン
- パブリッシャー会社を識別するために使われます。
- パブリッシャートークンはnowStudioのアカウント情報セクションにて利用できます。
nowgg CLIの使用
macOSまたはWindowsでターミナルを開きます。
インストールと初期化
1. CLIツールをインストールする
2. nowgg CLIを初期化する
nowgg init --token "<your_publisherToken_from_nowStudio>"
nowgg CLIを使用してアプリをnowStudioにアップロードする
1. nowStudioにアプリをアップロードする
nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <app_version_name> --version_code <app_version_code>
※自身のアプリはnowStudio内のアプリライブラリにアップロードされます。
2. テストトラックへのアプリのアップロードとデプロイメントのトリガー
nowgg upload --app_id <your_app_id> --file_path "/directory/sample.apk" --apk_version <apk_version> --version_code <app_version_code> --deploy
重要な情報
- 各テストトラックには、そのテストトラックでドラフトリリースを作成するために使用できる固有の
app_id
があります。
- 例えば、app_idが1234の場合、テストトラック1の
app_id
は1234_t1
になります。
--deploy
は、指定したテストトラックへのデプロイ処理をトリガーします。
ヘルプ
nowgg -h
nowgg init -h
nowgg upload -h
重要な情報
- nowggコマンドの実行中に、‘command not recognized’(コマンドを認識できません) エラーが発生した場合は、<python ディレクトリ>\<Scripts> をPATHに追加してください。
- ‘permission-related errors’(権限に関するエラー)が発生した場合は、管理者としてコマンドを実行してください。