기술 자료

Unity 엔진

Unity 엔진

임베디드 Linux 대한 옵션 기능 활성화

선택적 기능을 활성화하여 애플리케이션 성능을 개선합니다.
읽는 시간 5분최근 업데이트: 9일 전

다음 옵션 기능을 활성화하여 애플리케이션의 성능을 향상할 수 있습니다.

화면 로딩

임베디드 Linux 플레이어를 시작하면 플레이어 설정 창에 설정된 2D 이미지가 포함된 별도의 로딩 화면이 나타납니다(일반적으로 참조 시스템에서 200ms 이내). 로딩 화면 뒤에 로드되는 것을 제외하고 초기 씬 콘텐츠는 여전히 사용할 수 있습니다.

GLES3 셰이더 캐시 지속성

내장된 Linux Unity 플레이어 설치된 기기에서 바이너리 셰이더 캐싱을 지원하여 시작 타이밍을 개선합니다. 캐시는 셰이더 로드한 후 런타임 시 생성됩니다. 이 캐시는 임시 폴더에 기록되므로 시스템을 재시작할 때 지울 수 있습니다.
[TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/UnityShaderCache/
시스템이 재시작될 때 셰이더 캐싱을 사용하려면 다음 단계에 따라 캐시를 플레이어 데이터에 복사합니다.
  1. Unity 플레이어 타겟 시스템에 배포합니다.
  2. 애플리케이션을 실행하고 모든 셰이더가 터치되었는지 확인합니다.
  3. 모든 파일을
    [TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/UnityShaderCache/
    에서
    [PATH_TO_PLAYER]/Data/UnityShaderCache/
    로 복사합니다.
참고:
  • 플레이어가 업데이트될 때마다 캐시를 새로 고쳐야 합니다.
  • 캐시는 디바이스별로 다르므로 정확히 동일한 하드웨어 및 소프트웨어 구성을 가진 디바이스 간에만 공유해야 합니다.

Vulkan의 파이프라인 캐시 지속성

내장된 Linux Unity 플레이어 설치된 기기에서 바이너리 Vulkan 파이프라인 캐싱을 지원하여 시작 타이밍을 개선합니다. 바이너리 Vulkan 파이프라인 캐시는 Vulkan 파이프라인을 사용할 때 런타임 시 생성됩니다. 이 캐시는 임시
[TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/vulkan_pso_cache.bin
파일에 기록되므로 시스템을 재시작할 때 지울 수 있습니다.
시스템이 재시작될 때 파이프라인 캐싱을 사용하려면 다음 단계에 따라 캐시를 플레이어 데이터에 복사합니다.
  1. Unity 플레이어 타겟 시스템에 배포합니다.
  2. 애플리케이션을 실행하고 모든 파이프라인이 사용 중인지 확인합니다.
  3. [TEMP]/[COMPANY_NAME]/[PROJECT_NAME]/vulkan_pso_cache.bin
    파일을
    [PATH_TO_PLAYER]/Data
    에 복사합니다.
참고:
  • 플레이어가 업데이트될 때마다 캐시를 새로 고쳐야 합니다.
  • 캐시는 디바이스별이므로 정확히 동일한 하드웨어 및 소프트웨어 구성의 디바이스 간에만 공유해야 합니다.

시작 시간 로깅

시작 시간 로깅은 애플리케이션을 시작하는 데 걸리는 시간입니다. 시스템 안전 및 규제 요구 사항에 중요한 지표로 사용되는 경우가 많습니다.
임베디드 Linux 시작 시간 로깅에는 애플리케이션 실행 이후의 지속 시간 또는 총 시간(밀리초)이 포함됩니다. 다음 두 가지 타입의 시작 시간 로깅이 있습니다.
  • 실제: 시간 계산에 사용되는 스톱워치와 유사하게 실제 벽이나 시계 시간입니다.
  • User 애플리케이션 또는 해당 스레드 중 하나가 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 매뉴얼을 참조하십시오.

예제 출력

[타이밍::STARTUP] 초기 프로브 완료: 실제: 19ms | 사용자: 11ms[타이밍::STARTUP] SDL Initialized: 실제: 64ms | 사용자: 54ms[TIMING::STARTUP] 스크립팅 런타임 로드: 실제: 97ms | 사용자: 86ms[타이밍::STARTUP] 로드된 플러그인: 실제: 97ms | 사용자: 87ms[타이밍::STARTUP] 엔진이 초기화됨(nogfx): 실제: 104ms | 사용자: 94ms[타이밍::STARTUP] 플레이어 프리픽이 로드되었습니다. 실제: 104ms | 사용자: 94ms[타이밍::STARTUP] 화면 초기화: 실제: 139ms | 사용자: 112ms[타이밍::STARTUP] 엔진 초기화(gfx): 실제: 187ms | 사용자: 161ms[타이밍::STARTUP] Gfx가 초기화되었습니다. 실제: 190ms | 사용자: 163ms[타이밍::STARTUP] 입력 초기화: 실제: 190ms | 사용자: 163ms[타이밍::STARTUP] 스플래시 - 시작: 실제: 190ms | 사용자: 164ms[TIMING::STARTUP] SPLASH - 로드된 기본 씬 에셋(비동기): 실제: 2197ms | 사용자: 1670ms[TIMING::STARTUP] SPLASH - 모든 엔진 초기 상태가 설정됨: 실제: 2197ms | 사용자: 1670ms
스크립트 API 사용한 커스텀 이벤트의 출력
[TIMING::STARTUP] HELLO!!: Real: 2198 ms | User: 1671 ms
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
인자를 사용하여 플레이어를 시작합니다.

Wayland 강제 사용

X11 및 Wayland 윈도잉 시스템을 모두 사용할 수 있는 시스템에서 환경 변수를
SDL_VIDEODRIVER=wayland
로 설정하여 Unity 플레이어가 Wayland을 사용하도록 강제할 수 있습니다.

커맨드 라인 인자

커맨드 라인 Unity Embedded Linux 플레이어를 실행하고 인자를 전달하여 플레이어 실행 방식을 변경할 수 있습니다.
참고
모든 커맨드 라인 인자 Unity 에디터 설정된 설정보다 우선합니다.

커맨드 라인 인자

설명

-platform-hmi-force-srgb-blit
렌더링 시 리니어 색 공간 대신 감마 색 공간(sRGB)이 사용되는지 여부를 제어하려면
Force SRGB blit
설정을 변경합니다. 자세한 내용은 플레이어 설정 > 렌더링 > Force SRGB blit을 참조하십시오.
-platform-hmi-log-startup-times
플레이어의 시작 타이밍 데이터를 로깅합니다. 시작 프로파일링 툴
-platform-hmi-quit-after-frame N
를 사용하려면 이 인수가 필요합니다.
-platform-hmi-quit-after-frame N
첫 번째
N
프레임에 대해 플레이어의 시작 타이밍 데이터를 기록하고,
N
두 번째 프레임을 렌더링한 후 플레이어를 자동으로 종료합니다.
N
는 플레이어의 시작 시간을 기록할 프레임 수를 나타냅니다. 이 인자를 사용하여 플레이어의 시작 성과를 프로파일링합니다.

참고: 이 인수는
-platform-hmi-log-startup-times
가 활성화된 경우에만 효과가 있습니다.
-platform-hmi-single-gl-context
OpenGL ES의 컨텍스트 공유를 비활성화합니다. 기본적으로 Unity 두 개의 OpenGL ES 컨텍스트를 사용합니다. 하나는 시작용이고 다른 하나는 렌더링용입니다. 이 인자는 Unity 단일 컨텍스트를 대신 사용하도록 합니다. 이 인자를 사용하여 그래픽스 드라이버 문제를 감지하고 문제를 해결합니다.

참고: 이 인수는 멀티 디스플레이 지원을 비활성화합니다.
-platform-hmi-cpu-configuration <configuration>
플레이어의 CPU 구성을 지정합니다. 이 인수는 문자 조합이 포함된 문자열을 예상합니다. H(고성능 코어), L(저성능 코어), 또는 D(비활성 코어) 문자열은 각 CPU 코어의 성능 모드를 정의합니다.

예를 들어 4코어 CPU의
DHLL
는 첫 번째 코어를 비활성화하고 두 번째 코어를 고성능으로 할당하고 세 번째 코어와 다음 코어를 저성능으로 설정합니다. 자세한 내용은 플레이어 설정 > 설정 > CPU 설정을 참조하십시오.
-platform-hmi-player-data-path
.config
및 로그 파일을 저장할 시스템의 디렉토리 경로를 입력합니다. 자세한 내용은 플레이어 설정 > 설정 > 플레이어 데이터 경로를 참조하십시오.
-platform-hmi-force-vsync-count [C]
각 프레임 간에 전달할 수 있는 수직 동기화 횟수를 정의합니다. vsync를 완전히 비활성화하려면
0
로 설정하거나,
QualitySettings
에 설정된 값을 사용하려면
-1
로 설정합니다.
-platform-hmi-enable-signal-handlers
내장형 플랫폼에 대한 Unity 엔진의 신호 핸들러 설정을 구성합니다. 기본값은 Unity의 신호 핸들러를 활성화하는
1
입니다. 크래시 처리 또는 코어 덤프 생성이 올바르게 작동하지 않는 경우 이 인자를
0
로 설정하여 비활성화합니다.
-platform-embedded-linux-enable-gamepadinput
게임 컨트롤러 설정을 변경합니다. 플레이어 설정 > 설정 > 게임 컨트롤러 활성화를 참조하십시오.
-platform-embedded-linux-offscreen-video
플레이어가 SDL2의 오프스크린 렌더링 드라이버를 사용하도록 설정합니다. 이는 시뮬레이션과 렌더 서버 설정에 유용합니다. 모든 렌더링은 화면 외부에서 수행되지만 GPU 가속도 유지됩니다.

참고: 이 기능을 사용하는 경우
Application.targetFrameRate
를 조정하여 CPU/GPU 사용을 제한할 수 있습니다.
-platform-embedded-linux-wayland-enable-evdev-input
Wayland에서 플레이어를 실행하는 동안 EVDEV SDL2 입력 드라이버를 활성화합니다. 자세한 내용은 Wayland에서 EVDEV 입력 처리을 참조하십시오.

추가 리소스