ドキュメント

Unity Engine

Unity Engine

Android スレッド設定

スレッドアフィニティとスレッド優先度を設定して、特定のデバイス向けに最適化する方法を説明します。
読み終わるまでの所要時間 11 分最終更新 6日前

Unityは、デバイスのCPUトポロジーに基づいてスレッド アフィニティとスレッド優先度を設定します。Unity のデフォルトのスレッド設定は、ほとんどのプロジェクトでうまく機能しますが、状況によってはスレッド設定の変更が必要になる場合があります (例えば、特定のデバイス用に最適化したい場合や、アプリケーションが低消費電力を目指し、高いフレームレートを必要としない場合など)。
重要
可能な場合は Unity のデフォルト設定を使用します。スレッド設定を変更して特定のデバイス用に最適化すると、他のデバイスや、将来の OS バージョンで同じデバイスに変更があった場合でも、パフォーマンスに悪影響を与える可能性があります。

スレッドアフィニティ

スレッドのアフィニティは、スレッドを実行する CPU コアを制御します。Android デバイスの場合、コアは通常 2 つのカテゴリに分類されます。
  • 大きい:バッテリーに高い負荷がかかる強力なコア
  • 少し:大きなコアよりもバッテリーの消費量が少ない遅いコア。
重要
さまざまな Android デバイスをターゲットにする一般的なアプリケーションでは、スレッドを特定のコアにバインドしないでください。

CPU コアの識別

Unityは通常、デバイスのオペレーティング システムから各CPUコアの容量と大小の割り当てを受け取ります。古いバージョンの OS では、この情報が常に利用できるわけではありません。この場合、UnityはCPUコアの容量を計算し、その情報を使用して各コアを大または小のいずれかに割り当てます。コアを割り当てるために、Unityは各コアのCPU容量をしきい値と比較します。デフォルトでは、コアは、最も低速なコアの CPU 容量の 2 倍以上あれば大きく、そうでなければ小さくなります。
Unityが大小に割り当てるコアをより細かくコントロールするには、カスタムのしきい値を指定します。カスタムしきい値を指定するには、
-platform-android-cpucapacity-threshold [value]
コマンドライン引数に 0 ~ 1024 の値を指定します。0 は最小容量コア、1024 は最大容量コアを表します。例えば、1024 の約 85% の値である
870
は、CPU 容量がチップ上のコアの上位 15% に入る場合、コアが大きいことを意味します。Android デバイスで Unity に開始コマンドライン引数を追加する方法については、「カスタム UnityPlayerActivity ファイルからの Unity 起動引数の指定」を参照してください。
注
Unityは常にコアを大/小のいずれかに分類します。一部の複雑な CPU トポロジー (例えばUnityいずれかに分類します。Unity

スレッドアフィニティエイリアス

Unity には、スレッドのアフィニティ値として使用できる以下のエイリアスがあります。
  • any
    : スレッドを任意のコアで実行できます。
  • little
    : スレッドを任意の小さなコアで実行できます。
  • big
    : スレッドを任意の大きなコアで実行できます。
16 進数およびバイナリ値を使用してスレッドアフィニティを指定することもできます。バイナリでは、ビットのインデックスは特定の CPU コアを参照します。通常、小さなコアはインデックス 0 から開始し、大きなコアはそのすぐ後にきます。
例えば、CPU に 4 つの小さなコアと 4 つの大きなコアが含まれているとします。
  • 2 進数値の
    0b11110000
    と 16 進数値の
    0xf0
    により、大きなコアでスレッドを実行できます。
  • 2 進数値の
    0b1111
    と 16 進数値の
    0xf
    により、スレッドを小さなコアで実行できます。

スレッド優先度

スレッドの優先順位は、デバイスのオペレーティングシステムがスレッドに CPU 時間を割り当てる方法を制御します。オペレーティングシステムは、優先度の低いスレッドに比べて優先度の高いスレッドにより多くの CPU 時間を割り当てます。
Unity で使用できるスレッド優先度の値は -20 から 19 までの範囲で、-20 が最高の優先度、19 が最低の優先度を示します。

設定可能なUnityスレッド

このセクションでは、設定可能な Unity スレッドと、その設定に使用するコマンドライン引数について説明します。
Android デバイスで Unity に起動コマンドライン引数を追加する方法については、「カスタム UnityPlayerActivity ファイルからの Unity 起動引数の指定」を参照してください。
重要
一部のデバイスおよび Android OS バージョンでは、Android OS がコマンドライン パラメータを無視してエラーをスローする場合があります。この場合も、アプリケーションは問題なく正常に実行されますが、Android は指定したスレッドアフィニティやスレッド優先度の設定を適用しません。

Unity のメインスレッド

Unity のメイン スレッドはすべてのスクリプトを実行し、通常、CPU ロードが高くなります。このスレッドに影響するコマンドライン引数は次のとおりです。
  • [value]
    がスレッドの優先順位である
    -platform-android-unitymain-priority [value]
    。
  • [value]
    はスレッドのアフィニティである
    -platform-android-unitymain-affinity [value]
    。

Unity JobWorkerスレッド

Unity のワーカースレッドは、コアエンジンからのジョブと、C# Job System 経由でアプリケーションがディスパッチするジョブの両方を実行します。これらのスレッドに影響するコマンドライン引数は次のとおりです。
  • [value]
    がスレッドの優先順位である
    -platform-android-jobworker-priority [value]
    。
  • -platform-android-jobworker-affinity [value] [value1 value2 value3]
    ここ
    [value]
    で、 はスレッドの アフィニティ 、
    [value1 value2 value3]
    はスレッドごとのワーカースレッドのアフィニティを指定するために使用できる任意の値です。1 つの値のみを設定すると、Unity はすべてのワーカースレッドに同じ値を使用します。'-job-worker-count' を使用してワーカースレッドの数を指定できます。

Unity レンダリングするスレッド

Unity のレンダリングするスレッドは、プロジェクトでマルチスレッドレンダリングを使用している場合はグラフィックス API と相互作用します。
  • [value]
    がスレッドの優先順位である
    -platform-android-gfxdeviceworker-priority [value]
    。
  • [value]
    はスレッドのアフィニティである
    -platform-android-gfxdeviceworker-affinity [value]
    。
注
GraphicsJobs を使用する場合、JobWorker スレッドはグラフィックス API とも対話します。