ドキュメント

Unity Engine

Unity Engine

Vulkan APIの使用を許可または拒否する

Android Vulkan の許可および拒否フィルターリストを使用して、Vulkan API で Android デバイスによる Unity アプリケーションの実行を許可または拒否する方法を説明しています。
読み終わるまでの所要時間 10 分最終更新 6日前

デフォルトでは、Unity は Vulkan グラフィックス API で Unity アプリケーションが正しく実行されない Android デバイスを防ぎます。ただし、テストの結果、一部の制限付きデバイスでは、実際にはOpenGLES3 APIよりもVulkan APIの方がアプリケーションの実行が優れていることが判明する可能性があります。また、一部のデバイスでVulkan APIを使用してアプリケーションを実行することをさらに制限することもできます。Android Vulkan の許可および拒否フィルターリストを使用すると、Vulkan API でアプリケーションの実行を許可するデバイスを微調整できます。
Android Vulkan 許可フィルターリストを使用すると、アプリケーション実行のデフォルトグラフィックス API として特定のデバイスに Vulkan の使用を許可できます。または、Android Vulkan 拒否フィルターリストを使用して、特定のデバイスで Vulkan API を使用してアプリケーションを実行しないように制限できます。どちらのタイプのリストでも、以下のパラメータに値を指定して、デバイスまたはデバイスのセットを識別できます。
  • ベンダー
  • device.name
  • ブランド
  • 製品名
  • Android OS バージョン
  • Vulkan APIバージョン
  • ドライバーバージョン
Vulkan API バージョンとドライバーバージョンを除くすべてのパラメーターに C# 正規表現を使用できます。例を次に示します。Unity エディターに無効な正規式のエラーが表示されます。
デバイスのプロパティは、Vulkan APIでアプリケーションの実行を許可するか拒否するかを決定するために、すべてのパラメーター値(論理AND)と一致する必要があります。許可フィルターリストは、Vulkan APIとドライバーバージョンが指定されたパラメーター値以上のすべてのデバイスを示します。例えば、GPUベンダーをQualcomm、GPUモデル名をAdreno、Vulkan APIバージョンを
1.1.128
と指定した場合、許可フィルターリストでは、Qualcomm Adreno GPUを搭載し、Vulkan APIバージョンが
1.1.128
以上のすべてのデバイスが許可されます。
拒否フィルターリストは、Vulkan APIとドライバーバージョンが指定されたパラメーター値以下のすべてのデバイスを示します。例えば、GPUベンダーをARM、GPUモデル名をMali、Vulkanドライバーバージョンを
0.676.0
と指定した場合、拒否フィルターリストでは、ARM Mali GPUのVulkanドライバーバージョンが
0.676.0
以下のすべてのデバイスが制限されます。
注
デバイスのグループでVulkanの使用を制限することはできますが、許可フィルターリストを使用して、そのグループの特定のデバイスがVulkanを引き続き使用できるようにすることができます。

デフォルト最小スペシフィケーション

Unityは、GPUベンダーに基づいて、Vulkan APIサポートに以下の最小仕様を自動的に適用します。これらの仕様を満たさないデバイスは、Unity アプリケーションを実行するときに Vulkan API を使用せず、プレイヤー設定で設定されたデフォルトのグラフィックス API を使用します。Android Vulkanの許可および拒否フィルター リストを使用してこれらをオーバーライドし、カスタムの基準セットを定義できます。
以下の表は、GPUベンダーに基づく最小仕様を示しています。

ベンダー

最小仕様

NVIDIAVulkan APIバージョン >=
1.0.13
ARMVulkan APIバージョン >=
1.0.61
想像テクノロジーVulkan APIバージョン >=
1.1.170
とドライバーバージョン >=
1.473.1397
Qualcomm最上位ビット(MSB)ビットが設定されたドライバーバージョンまたはVulkan APIバージョン>=
1.0.49
注
Unity では、Google ピクセル 6 デバイスで Vulkan API をデフォルトで使用できません。これらのデバイスで Vulkan を使用してアプリケーションのパフォーマンスをテストする場合は、Android Vulkan Deny フィルター リスト から Google ピクセル 6 エントリーを削除してください。
Android デバイスで常に Vulkan API を使用できるようにするには、以下の手順に従います。
  1. メインメニューから、編集>
    プロジェクト設定

    ?

    > プレイヤー> Android 設定> Other Settings の順に移動します。
  2. Vulkan Settings セクションで、Android Vulkan Allow フィルターリストに移動し、折りたたみ (三角形) を使用して展開します。
  3. [Add] (+) ボタンを選択して、Vulkan API の使用を許可する Android デバイスのスペシフィケーションを追加します。パラメーターのセットが表示されます。
  4. 使用可能なパラメータにデバイス仕様を入力します。すべてのパラメータは任意です。パラメータの説明については、Android プレイヤー設定 を参照してください。
パラメーター値で定義された仕様を満たすAndroidデバイスでは、常にUnityアプリケーション用のVulkan APIが使用されます。
Vulkan API の使用を Android デバイスに制限するには、Android Vulkan 拒否フィルターリストを使用し、先ほどと同じ手順に従います。
ノート:
  • 許可フィルターの両方で同じ値を設定すると、Unity はそれらの値で定義された基準を無視します。
  • 制限されたデバイスは、プレイヤー設定で設定されたフォールバックグラフィックス API を使用してアプリケーションを実行します。フォールバックAPIを使用できない場合、アプリケーションが起動しません。
  • androidVulkanDenyFilterList および androidVulkanAllowFilterList API を使用して、Android デバイスでの Vulkan API の使用を許可または制限することもできます。

追加リソース