埋め込み Linux の任意の機能の有効化

以下の任意の機能を有効にして、アプリケーションのパフォーマンスを向上させることができます。

ロード画面

埋め込み Linux プレイヤーを起動すると、別のロード画面が表示されます (通常、リファレンスシステムでは 200 ミリ秒以内)。この画面には、Player 設定 ウィンドウで設定された 2D 画像が表示されます。最初のシーンコンテンツもそのまま使用できますが、ロード画面の背後でロードされます。

GLES3 のシェーダーキャッシュの永続性

埋め込み Linux は、起動タイミングを速くするために、Unity Player がインストールされているデバイスでのバイナリシェーダーキャッシュをサポートしています。キャッシュは、シェーダーのロード後、ランタイムに作成されます。このキャッシュは一時フォルダー [TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/UnityShaderCache/ に書き込まれるため、システムの再起動時に消去できます。

システムの再起動時にシェーダーキャッシュを使用するには、以下の手順でキャッシュをプレイヤーデータにコピーします。

1. Unity Player をターゲットシステムに展開します。
2. アプリケーションを実行し、すべてのシェーダーがタッチされていることを確認します。
3. すべてのファイルを [TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/UnityShaderCache/ から [PATH_TO_PLAYER]/Data/UnityShaderCache/ にコピーします。

注：

• プレイヤーが更新されるたびにキャッシュを更新する必要があります。
• キャッシュはデバイス固有であるため、ハードウェアとソフトウェアの設定がまったく同じデバイス間でのみ共有する必要があります。

Vulkan のパイプラインキャッシュの永続性

埋め込み Linux は、起動タイミングを速くするために、Unity Player がインストールされているデバイスでのバイナリ Vulkan パイプラインキャッシュをサポートしています。バイナリ Vulkan パイプラインキャッシュは、Vulkan パイプラインの使用時、ランタイムに作成されます。このキャッシュは一時的な [TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/vulkan_pso_cache.bin ファイルに書き込まれるため、システムの再起動時に消去できます。

システムの再起動時にパイプラインキャッシュを使用するには、以下の手順でキャッシュをプレイヤーデータにコピーします。

1. Unity Player をターゲットシステムに展開します。
2. アプリケーションを実行し、すべてのパイプラインが使用されていることを確認します。
3. [TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/vulkan_pso_cache.bin ファイルを [PATH_TO_PLAYER]/Data にコピーします。

注：

• プレイヤーが更新されるたびにキャッシュを更新する必要があります。
• キャッシュはデバイス固有であるため、ハードウェアとソフトウェアの設定がまったく同じデバイス間でのみ共有する必要があります。

起動時間ロギング

起動時間ロギングは、アプリケーションの起動にかかる時間の長さです。これは、システムの安全性と規制要件の重要な指標としてよく使用されます。

埋め込み Linux の起動時間ロギングには、アプリケーションが起動されてからの継続時間または合計時間 (ミリ秒単位) が含まれます。起動時間ロギングには 2 つのタイプがあります。

• Real:実ウォール時間またはクロック時間のことで、時間の計算に使用されるストップウォッチによく似ています。
• User:アプリケーションまたはそのスレッドの 1 つが CPU コアで費やした時間です。アプリケーションの起動時に複数のスレッドがビジー状態になる場合は、リアルタイムよりも大きくなる可能性があります。

C# から起動タイミングログを追加するには、以下を使用します。

HmiPlatform.LogStartupTiming("log tag");

結果は、以下の Player.log 行に表示されます。

[TIMING::STARTUP] log tag: Real: xxx ms | User: yyy ms

ログタグ と、プレイヤーの開始時刻からの ウォール時間 (xxx) および CPU 時間 (yyy) がミリ秒単位で表示されます。

#if UNITY_EMBEDDED_LINUX_API ... #endif を使用してコードを保護できます。

注：Time コマンドと同じ用語を使用して、ウォール時間とCPU 時間を参照します。詳細については、Linux のメインマニュアルを参照してください。

出力例:

[TIMING::STARTUP] Initial probing done: Real: 19 ms | User: 11 ms
[TIMING::STARTUP] SDL Initialized: Real: 64 ms | User: 54 ms
[TIMING::STARTUP] Scripting runtime loaded: Real: 97 ms | User: 86 ms
[TIMING::STARTUP] Plugins loaded: Real: 97 ms | User: 87 ms
[TIMING::STARTUP] Engine initialized (nogfx): Real: 104 ms | User: 94 ms
[TIMING::STARTUP] Player Prefs loaded: Real: 104 ms | User: 94 ms
[TIMING::STARTUP] Screen initialized: Real: 139 ms | User: 112 ms
[TIMING::STARTUP] Engine initialized (gfx): Real: 187 ms | User: 161 ms
[TIMING::STARTUP] Gfx initialized: Real: 190 ms | User: 163 ms
[TIMING::STARTUP] Input initialized: Real: 190 ms | User: 163 ms
[TIMING::STARTUP] SPLASH - Begin: Real: 190 ms | User: 164 ms
[TIMING::STARTUP] SPLASH - Primary scene assets loaded (async): Real: 2197 ms | User: 1670 ms
[TIMING::STARTUP] SPLASH - All engine initial states established: Real: 2197 ms | User: 1670 ms

スクリプト API を使用したカスタムイベントからの出力

[TIMING::STARTUP] HELLO!!: Real: 2198 ms | User: 1671 ms

boot.config 出力で platform-hmi-quit-after-frame を指定すると、フレーム番号 X まで以下がログに記録されます。ここで、X はブート設定値として指定する番号です。

[TIMING::STARTUP] Frame 1 rendered: Real: 2209 ms | User: 1687 ms

[TIMING::STARTUP] Frame 2 rendered: Real: 2210 ms | User: 1692 ms

Wayland での EVDEV 入力処理

Wayland での実行中に EVDEV SDL2 入力ドライバーを有効にするには、-platform-embedded-linux-wayland-enable-evdev-input 引数を指定してプレイヤーを開始します。また、platform-embedded-linux-wayland-enable-evdev-input=1 として Data/boot.config にある設定ファイルに追加することもできます。

Wayland 使用の強制

X11 と Wayland の両方のウィンドウシステムが使用可能なシステムでは、環境変数を SDL_VIDEODRIVER=wayland に設定することで、Unity Player に Wayland の使用を強制できます。

コマンドライン引数

コマンドラインから埋め込み Linux の Unity Player を起動し、引数を渡すことで、プレイヤーの実行方法を変更することができます。

注：すべてのコマンドライン引数は、Unity エディターと boot.config の設定よりも優先されます。

追加リソース

• 埋め込み Linux のプレイヤー設定
• Linux マニュアルページ