ダウンロードサイズを管理するためのアセットファイル

• OBB拡張ファイル - モバイルアプリには、サイズが最大4 GBのopaque binary blob (OBB)⁠形式の拡張ファイルを1つ含めることができます。このファイルはインストール時に自動的にダウンロードされます。
• 必須アセットファイル - モバイルアプリは、OBB形式を含むほぼすべての形式の複数の一般アセットファイルを提供できます。必須としてマークしたアセットはインストール時にダウンロードされます。

• 最大サイズは4 GB。
• アップロード時にこのファイルに任意の名前を付けることができ、main.[package-name].[version-code].obbという形式で名前が変更されます。
• アセットファイルシステムは、このファイル名を使用して、ユーザーのヘッドセットにあるOBB拡張ファイルをアップデートするかどうかを決定します。

• 複数のOBBファイルがある場合、アセット構成ファイルを使って、追加のOBBを必須アセットファイルとしてアップロードすることができます。

• 任意のファイル拡張子(追加のOBBファイルを含む)が付いた任意の形式が使用できます。
• それぞれは4 GBまでにすることができますが、最大2 GBのサイズにすることをおすすめします。
• アプリのアップロード処理時に、当該アイテムを必須として指定する設定ファイルが必要です。
• ビルドのすべてのバージョンで同じファイル名を使用してください。ビルドのすべてのバージョンで同じファイル名を使用することで、パッチアップデートが高速になります。同じ名前のアセットファイルに対する変更のみが、ビルドのより新しいバージョンでダウンロードされます。

• アセットファイルを使ってAPKのダウンロードサイズを抑えるには、アプリに必ずインターネット接続が必要であることを示すマークを付けます。このマークがあれば、ユーザーはMetaから必要なファイルをダウンロードできます。
  1. 開発者ダッシュボード⁠にログインします。
  2. [Distribution (配信)] > [App Submissions (アプリの申請)]を選択します。
  3. ダイアログで該当アプリを選択し、アプリ申請ページの手順([Draft (下書き)] > [App Metadata (アプリメタデータ)] > [Specs (仕様)] > [Internet Connection (インターネット接続)])に従います。
  4. [Internet connection required for downloadable contents (コンテンツをダウンロードするには、インターネット接続が必要です)]を選択します。
• 通常、アセットファイルは外部ストレージに保存されているため、AndroidマニフェストファイルがREAD_EXTERNAL_STORAGEアクセス許可を持っていることを確認してください。以下は、マニフェストエントリの例です。

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

• 拡張OBBファイルの場合、--obbパラメーターを使用して、OBBファイルへのパスを指定します
• 必須アセットファイルまたはDLCアセットファイルの場合には、--assets_dirパラメーターを使用して、アップロードするアセットが格納されたディレクトリを指定します。
• 購入も可能なDLC、または必須アセットの場合は、--asset_files_configパラメーターを使って構成ファイルのパスを指定します。

ovr-platform-util upload-quest-build
-a 12345 // Specifies the app ID for the app you want to upload the build to
-s 1234 // Specifies the app secret for the app you want to upload the build to.
-d path/to/mygame.zip // Specifies the path to the APK file for the Quest build.
--obb path/to/myGame.obb // Specifies the path to the OBB file for the Quest build.
--assets_dir /path/to/myGame/assets // Specifies the directory containing additional asset files for the Quest build.
--asset_files_config /path/to-config-file.json // Specifies the path to a JSON configuration file that lists the required asset files and their metadata.
-c ALPHA // Specifies the release channel for the build (in this case, "ALPHA").

{
    "asset1.ext": {
        "required": true
    }
}

{
  "scene_12_Q2.obb": {
    "required": true,
    "supportedDevices": ["quest2"]
  },
  "scene_12_Q3.obb": {
    "required": true,
    "supportedDevices": ["quest3", "quest3s"]
  },
  "scene_12_shared.obb": {
    "required": true,
    "supportedDevices": ["quest2", "questpro", "quest3", "quest3s"]
  }
}

1. Meta Horizon開発者ダッシュボード⁠に移動します。
2. アプリを選択します。
3. 左側のナビゲーションで、[Distribution (配信)] > [App Submissions (アプリの申請)]を選択します。
4. [App Submission (アプリの申請)]ページの[Build (ビルド)]列で、表示する申請のハイパーリンクをクリックします。
5. [Expansion Files (拡張ファイル)]タブをクリックします。
   タブ内に[OBB File (OBBファイル)]と[Asset Files (DLC) (アセットファイル(DLC))]のセクションが表示されます。[Required (必須)]列に[Yes (はい)]が表示されている場合、そのファイルはアプリのインストール時にダウンロードされます。
   次の画像はタブの例を示しています。
   
6. ファイルを編集したりダウンロードしたりするには、[Required (必須)]列の横にある省略記号ボタンをクリックします。
   拡張ファイルのアップロードセクションで説明されているコマンドラインユーティリティを使って、新しいファイルをアップロードする必要があります。

• 以前にインストールされたファイルを削除するには、次のようにします。

    adb uninstall com.oculus.demo // Uninstalls the app
    adb shell rm /sdcard/Android/obb/main.1.com.oculus.demo.obb // Removes the previously installed expansion file for the app with specified location.
  
• APKファイルをインストールします。

    adb push -p bundles.apk /data/local/tmp // Pushes the APK file to the device's temporary storage directory.
    adb shell pm install -g /data/local/tmp/bundles.apk // Installs the APK file on the device, granting all runtime permissions requested by the app.
    adb shell rm /data/local/tmp/bundles.apk // Removes the APK file from the device's temporary storage directory after installation.
  
• 新しい拡張ファイルをプッシュする場合は、次のようにします。

    adb push -p main.1.com.oculus.demo.obb /sdcard/Android/obb/ // pushes the new expansion file to the device's OBB directory
  

• 一般アセットファイルとは、ランタイムでダウンロードされるコンテンツの場合もあれば、インストール時にダウンロードされる必須アセットの場合もあります。

• 任意のファイル拡張子が付いた任意の形式を使用できます(言語パックを含む)。
• サイズはそれぞれ最大4 GBまで可能ですが、2 GB以内にすることをおすすめします。
• アプリのアップロード処理時に、当該アイテムを必須として指定する設定ファイルが必要です。

• 必須ファイルの場合は、--assets_dirパラメーターを使用してアップロード対象のアセットを含むディレクトリを指定し、--asset_files_configパラメーターを使用して必須アイテムを指定するJSON形式の設定ファイルへのパスを含めます。
  以下はその例です。
  $ ovr-platform-util upload-rift-build -a 12345 -s 1234 -d path/to/mygame.zip --assets_dir /path/to/myGame/assets --asset_files_config /path/to/config-file.json -c ALPHA
  JSON形式の設定ファイルには、以前に定義したIAPアイテムをDLCと関連付けるエントリ、またはアイテムを必須に指定するエントリを記載します。各SKUは、前のセクションでダッシュボードにより定義したSKUへと解決される必要があることに注意してください。
  以下はその例です。

   {
    "asset1.ext": {
        "required": true
    }
   }