기술 자료

Unity 엔진

Unity 엔진

Unity 플레이어 커맨드 라인 인자 참조

커맨드 라인 빌드된 플레이어를 실행할 때 사용할 수 있는 인수 리스트입니다.
읽는 시간 5분최근 업데이트: 9일 전

커맨드 라인 Unity 플레이어를 실행하고 인자를 전달하여 플레이어가 실행하는 방식을 변경할 수 있습니다.
이러한 인수는 웹 플랫폼을 제외한 모든 독립 실행형 플랫폼에서 작동합니다. 다음 표에는 추가 플랫폼 요구 사항이 나와 있습니다.
커맨드 라인에서 Unity를 실행하는 방법에 대한 자세한 내용은 커맨드 라인 인터페이스에서 Unity 실행을 참고하십시오.

명령

설명

-batchmode
헤드리스 모드에서 애플리케이션을 실행합니다. 이 모드에서는 애플리케이션이 아무것도 표시하지 않거나 사용자 입력을 받지 않습니다.
-disable-gpu-skinning
시작 시 그래픽처리장치(GPU) 스키닝을 비활성화합니다.
-dontConnectAcceleratorEvent
(UWP 전용)
AcceleratorKeyEvent에 대한 연결을 비활성화합니다. XAML 요소의 입력에 문제가 있는 경우 도움이 될 수 있습니다.
참고: Unity F10, Ctrl, Alt, Tab 등 일부 키보드 키를 처리할 수 없습니다.
-force-clamped
이를
-force-glcoreXY
와 함께 사용하여 추가 OpenGL 확장 기능을 확인하지 않도록 하여 동일한 코드 경로가 있는 플랫폼 간에 애플리케이션을 실행할 수 있습니다.
-force-d3d11
(Windows 전용)
애플리케이션이 렌더링에 Direct3D 11을 사용하도록 합니다.
-force-d3d11-bitblt-model
(Windows 전용)
Direct3D 11을 사용할 때 애플리케이션이 DXGI BitBlt 모델 스와프체인을 사용하도록 합니다. 자세한 내용은
PlayerSettings.useFlipModelSwapchain
를 참조하십시오.
-force-d3d11-flip-model
(Windows 전용)
Direct3D 11을 사용할 때 애플리케이션이 DXGI 플립 모델 스와프체인을 사용하도록 합니다. 자세한 내용은
PlayerSettings.useFlipModelSwapchain
를 참조하십시오.
-force-d3d11-no-singlethreaded
(Windows 및 UWP만 해당)
D3D11_CREATE_DEVICE_SINGLETHREADED
플래그 없이 DirectX 11.0을 만들어야 합니다.
-force-d3d11-singlethreaded
(Windows 및 UWP만 해당)
DirectX 11.0을
D3D11_CREATE_DEVICE_SINGLETHREADED
플래그로 만들어야 합니다.
-force-d3d12
(Windows 전용)
애플리케이션이 렌더링에 Direct3D 12를 사용하도록 합니다.
-force-device-index
스탠드얼론 플레이어가 해당 GPU의 인덱스를 전달하여 특정 GPU 기기를 사용하도록 합니다. 이 옵션은 D3D11, D3D12, Metal, Vulkan 그래픽스 API에서 지원되지만 OpenGL에서는 지원되지 않습니다.
-force-driver-type-warp
(Windows 및 UWP만 해당)
DirectX 11.0 드라이버 타입 WARP 기기를 강제로 사용합니다. 자세한 내용은 Windows 고급 래스터화 플랫폼에 대한 Microsoft 문서를 참조하십시오.
-force-feature-level-10-0
(Windows 및 UWP만 해당)
DirectX 11.0 기능 레벨 10.0을 강제 적용합니다.
-force-feature-level-10-1
(Windows 및 UWP만 해당)
DirectX 11.0 기능 레벨 10.1을 강제 적용합니다.
-force-feature-level-11-0
(Windows 및 UWP만 해당)
DirectX 11.0 기능 레벨 11.0을 강제 적용합니다.
-force-gfx-direct
강제로 단일 스레드 렌더링。
-force-glcore
애플리케이션이 렌더링에 OpenGL 코어 프로파일을 사용하도록 합니다. 에디터는 사용 가능한 최신 OpenGL 버전과 OpenGL 드라이버에 의해 노출되는 모든 OpenGL 확장자를 사용하려고 시도합니다. 플랫폼이 OpenGL을 지원하지 않는 경우 Unity Direct3D를 사용합니다.
-force-glcoreXY
-force-glcore
와 유사하지만 특정 OpenGL 컨텍스트 버전을 요청합니다. XY에 허용되는 값: 32, 33, 40, 41, 42, 43, 44, 45
-force-low-power-device
(macOS 전용)
스탠드얼론 플레이어가 저전력 기기를 사용하도록 만듭니다.
-force-metal
(macOS 전용)
스탠드얼론 플레이어가 Metal을 기본 그래픽스 API 사용하도록 만듭니다.
-forceTextBoxBasedKeyboard
(UWP 전용)
TouchScreenKeyboard에 TextBox 기반 구현을 사용합니다. 이 구현을 사용하면 기본값에 문제가 있는 경우 다른 구현으로 전환할 수 있습니다.

참고: 이 구현은 UWP XAML 애플리케이션에만 영향을 미칩니다.
-force-vulkan
애플리케이션이 렌더링에 Vulkan을 사용하도록 합니다.
-force-wayland
(Linux 전용)
Linux 플레이어를 실행할 때 실험적인 Wayland 지원을 활성화합니다.
-logFile <pathname>
Unity 스탠드얼론 플레이어 로그 파일을 작성할 파일 경로 위치를 지정합니다. 이 인수가 제공되지 않는 경우 로그 파일의 기본 위치에 대한 자세한 내용은 로그 파일 레퍼런스를 참조하십시오. 콘솔로 출력하려면 경로 이름의
-
를 지정합니다. Windows에서는
-logFile
를 사용하여 기본적으로 콘솔이 아닌
stdout
로 출력을 지정할 수 있습니다. 경로에 공백이 있는 경우, 이중따옴표로 래핑합니다. 일부 커맨드 라인 인터페이스는 경로에 공백이 없더라도 경로에 따옴표를 입력해야 할 수 있습니다.

예시(Windows):
"C:\Users\me\Builds\MyGame\MyGame.exe" -logFile "C:\Logs\Player.log"

예시(macOS):
"/Users/me/Builds/MyGame.app/Contents/MacOS/MyGame" -logFile "/Users/me/Logs/Player.log"

예시(Linux):
"/home/me/Builds/MyGame/MyGame" -logFile "/home/me/logs/Player.log"
-log-memory-performance-stats
플레이어를 닫을 때 플레이어 로그 파일에 자세한 메모리 리포트를 추가합니다.
-max-async-pso-job-count
Experimental.Rendering.ShaderWarmup
를 사용하여 셰이더 배리언트를 예열할 때 Unity가 PSO(파이프라인 상태 오브젝트)를 생성하는 데 사용하는 병렬 스레드 수를 설정합니다. 이는 애플리케이션이 DirectX 12, Metal 또는 Vulkan 그래픽스 API 사용하는 플랫폼에서 실행되는 경우에만 영향을 줍니다.
-monitor N
지정된 모니터에서 스탠드얼론 플레이어를 실행하며, 1 기반 인덱스 번호로 표시됩니다.
-nographics
배치 모드에서 이 인자를 사용하면 Unity 그래픽스 기기를 초기화하지 않습니다. 이를 통해 GPU가 없는 머신에서 자동화된 워크플로를 실행할 수 있습니다.
참고: 출력 로그는 이 모드에서 꺼져 있습니다.
-nolog
플레이어 로깅을 비활성화합니다. 플레이어 로그의 내용과 위치에 대한 자세한 내용은 로그 파일 레퍼런스 폴더를 참조하십시오.
-no-stereo-rendering
스테레오 렌더링을 끄십시오.
-parentHWND <HWND> delayed
(Windows 전용)
Windows 스탠드얼론 애플리케이션을 다른 애플리케이션에 포함합니다. 이 인자를 사용하면 부모 애플리케이션의 창 핸들(‘HWND’)을 Windows 스탠드얼론 애플리케이션에 전달해야 합니다.

-parentHWND 'HWND' delayed
를 전달하면 Unity 애플리케이션이 실행되는 동안 숨겨집니다. 또한 애플리케이션에서 Unity용 Microsoft 개발자 라이브러리에서 SetParent를 호출해야 합니다. Microsoft의
SetParent
는 Unity 창을 포함합니다. Unity 프로세스를 생성할 때 Unity 창은 Microsoft의 STARTUPINFO 구조의 일부로 제공된 위치와 크기를 따릅니다.

Unity 창의 크기를 조절하려면 Microsoft의
GetWindowLongPtr
함수에서 GWLP_USERDATA를 선택합니다. 최소 비트는 그래픽스가 초기화될 때 1로 설정되며 크기를 안전하게 조절할 수 있습니다. Unity 스플래시 화면이 표시되면 두 번째로 낮은 비트가 1로 설정됩니다.

자세한 내용은 다음 다운로드 가능한 예시를 참조하십시오. EmbeddedWindow.zip
-popupwindow
창을 프레임 없이 다이얼로그 창으로 만듭니다. 이 커맨드는 macOS에서 지원되지 않습니다.
-screen-fullscreen
기본 전체 화면 상태를 오버라이드합니다. 0 또는 1이어야 합니다.
-screen-height
기본 화면 높이를 오버라이드합니다. 지원되는 해상도의 정수여야 합니다.
-screen-quality
기본 화면 품질을 오버라이드합니다. 사용 예시:
/path/to/myGame -screen-quality Beautiful
. 지원되는 옵션은 품질 설정 이름과 일치합니다.
-screen-width
기본 화면 너비를 오버라이드합니다. 이 너비 값은 지원되는 해상도의 정수여야 합니다.
-single-instance
(Linux 및 Windows만 해당)
한 번에 하나의 애플리케이션 인스턴스만 실행합니다. 다른 인스턴스가 이미 실행 중인 경우
-single-instance
로 애플리케이션을 다시 시작하면 기존 인스턴스에 포커스가 맞춰집니다.
-systemallocator
플랫폼이 시스템 할당자를 사용하도록 합니다. 주소 처리기와 같은 툴을 사용하여 메모리 문제를 디버깅하려는 경우 유용할 수 있습니다. 디버깅 목적으로만 이 옵션을 사용해야 합니다.
-timestamps
모든 플레이어 로그 메시지를 현재 타임스탬프 및 스레드 ID로 접두사로 지정합니다.
-wait-for-managed-debugger
플레이어가 실행 전에 관리되는 디버거가 연결될 때까지 대기하도록 만듭니다. 플레이어의 프로세스 ID를 표시하는 다이얼로그를 생성합니다. 관리형 디버깅에 대한 자세한 내용은 Unity에서 C# 코드 디버그를 참고하십시오.
-wait-for-native-debugger
실행하기 전에 플레이어가 네이티브 디버거가 연결될 때까지 기다립니다. 플레이어의 프로세스 ID를 표시하는 다이얼로그를 생성합니다.
-window-mode
(Windows 전용)
전체 화면 창 모드를 오버라이드합니다. 허용되는 값은
exclusive
또는
borderless
입니다. 자세한 내용은 플레이어 설정을 참고하십시오.

추가 리소스