You can launch Unity Players from the command line and pass in arguments to change how the Player executes. These arguments work on any standalone platform unless this page specifies other platform requirements.
| 커맨드 | 세부 정보: |
|---|---|
-batchmode |
“헤드리스” 모드에서 애플리케이션을 실행합니다. 이 모드에서 애플리케이션은 아무것도 표시하지 않거나 사용자 입력을 수신하지 않습니다. 이는 네트워크 애플리케이션에서 서버를 실행하는 데 유용합니다. |
-disable-gpu-skinning |
시작 시 그래픽처리장치(GPU) 스키닝을 비활성화합니다. |
-force-clamped |
-force-glcoreXY와 함께 사용하여 추가 OpenGL 확장자 확인을 방지하여 애플리케이션이 동일한 코드 경로가 있는 플랫폼 간에 실행될 수 있도록 합니다. |
-force-d3d11-singlethreaded |
DirectX 11.0을 D3D11_CREATE_DEVICE_SINGLETHREADED 플래그 없이 강제로 생성되도록 합니다. |
-force-device-index |
해당 GPU의 인덱스를 전달하여 스탠드얼론 플레이어가 특정 GPU 기기를 사용하도록 합니다. 이 옵션은 D3D11, D3D12, Metal, Vulkan 그래픽스 API에서 지원되지만 OpenGL에서는 지원되지 않습니다. |
-force-glcore |
렌더링 시 애플리케이션이 OpenGL 코어 프로파일을 사용하도록 합니다. 에디터는 가능한 OpenGL 최신 버전 및 OpenGL 드라이버에 의해 노출되는 모든 OpenGL 확장자를 사용하려고 합니다. 플랫폼이 OpenGL을 지원하지 않을 경우 Unity는 Direct3D를 사용합니다. |
-force-glcoreXY |
-force-glcore와 비슷하나, 특정 OpenGL 컨텍스트 버전을 요청합니다. XY에 들어갈 수 있는 값은 32, 33, 40, 41, 42, 43, 44, 45가 있습니다. |
-force-vulkan |
애플리케이션이 렌더링에 Vulkan을 사용하도록 합니다. |
-force-wayland (Linux 전용) |
Linux 플레이어 실행 시 실험 단계인 Wayland 지원을 활성화합니다. |
-monitor N |
특정 모니터에서 스탠드얼론 플레이어를 실행하며, 1기반 인덱스 숫자로 표시됩니다. |
-nographics |
배치 모드에서 이 인자를 실행할 때 Unity는 그래픽스 장치를 초기화하지 않습니다. 이를 통해 자동화 워크플로를 GPU가 없는 장비에서 실행할 수 있습니다. |
-nolog |
출력 로그를 생성하지 않습니다. 이 인자를 사용하지 않으면 Unity는 Debug.Log가 출력되는 로그 파일 폴더에서 output_log.txt를 작성합니다. |
-no-stereo-rendering |
스테레오 렌더링을 비활성화합니다. |
-popupwindow |
창을 프레임이 없는 팝업 창으로 만듭니다. 이 커맨드는 macOS에서 지원되지 않습니다. |
-screen-fullscreen |
디폴트 풀스크린 상태를 오버라이드합니다. 이 값은 반드시 0 또는 1이어야 합니다. |
-screen-height |
디폴트 스크린 높이를 오버라이드합니다. 이 값은 반드시 지원되는 해상도에 해당하는 정수여야 합니다. |
-screen-width |
기본 화면 폭을 오버라이드합니다. 이 폭 값은 반드시 지원되는 해상도에 해당하는 정수여야 합니다. |
-screen-quality |
기본 화면 품질을 오버라이드합니다. 사용 예로는 /path/to/myGame -screen-quality Beautiful을 들 수 있습니다. 지원되는 옵션은 품질 설정 이름과 일치합니다. |
-force-low-power-device(macOS 전용) |
스탠드얼론 플레이어가 저전력 기기를 사용하도록 합니다. |
-force-metal (macOS 전용) |
스탠드얼론 플레이어가 Metal을 기본 그래픽스 API로 사용하도록 합니다. |
-force-d3d11 (Windows 전용) |
애플리케이션이 렌더링에 Direct3D 11을 사용하도록 합니다. |
-force-d3d12 (Windows 전용) |
애플리케이션이 렌더링에 Direct3D 12를 사용하도록 합니다. |
-force-d3d11-flip-model (Windows only) |
Force the application to use DXGI flip model swapchain when using Direct3D 11. For more information, see PlayerSettings.useFlipModelSwapchain. |
-force-d3d11-bitblt-model (Windows only) |
Force the application to use DXGI BitBlt model swapchain when using Direct3D 11. For more information, see PlayerSettings.useFlipModelSwapchain. |
--parentHWND <HWND> delayed (Windows 전용) |
Windows 스탠드얼론 애플리케이션을 다른 애플리케이션에 임베드합니다. 이 인자를 사용하는 경우 부모 애플리케이션의 창 핸들(‘HWND’)을 Windows 스탠드얼론 애플리케이션에 전달해야 합니다.-parentHWND 'HWND' delayed를 전달하는 경우 Unity 애플리케이션은 실행되는 동안 보이지 않습니다. Unity용 Microsoft Developer 라이브러리의 SetParent도 애플리케이션에서 호출해야 합니다. Microsoft의 SetParent는 Unity 창을 임베드합니다. Unity 프로세스를 생성하면 Unity 창에 Microsoft STARTUPINFO 구조의 일부로 제공된 포지션과 크기가 유지됩니다.Unity 창의 크기를 조절하려면 Microsoft의 GetWindowLongPtr 함수에서 GWLP_USERDATA를 확인합니다. 그래픽스가 초기화되고 크기를 조절해도 안전하면 최저 비트가 1로 설정됩니다. 두 번째로 낮은 비트는 Unity 스플래시 화면 표시가 종료된 후 1로 설정됩니다.자세한 내용은 다운로드할 수 있는 EmbeddedWindow.zip 예를 참조하십시오. |
-single-instance(Linux 및 Windows 전용) |
동시에 해당 애플리케이션의 인스턴스를 하나만 실행합니다. 다른 인스턴스가 이미 실행 중인 경우 -single-instance를 통해 다시 애플리케이션을 시작했을 때 기존의 인스턴스에 포커스가 맞춰집니다. |
-window-mode(Windows 전용) |
Override fullscreen windowed mode. Accepted values are exclusive or borderless. For more information, see Player settings. |
유니버설 Windows 앱은 기본적으로 커맨드 라인 인자를 허용하지 않기 때문에 인수를 전달하려면 MainPage.xaml.cs/cpp 또는 MainPage.cs/cpp에서 특수 함수를 호출해야 합니다. 예를 들어 다음과 같습니다.
appCallbacks.AddCommandLineArg("-nolog");
이 함수는 appCallbacks.Initialize*() 함수 이전에 호출해야 합니다.
| 커맨드 | 세부 정보: |
|---|---|
-force-d3d11-singlethreaded |
DirectX 11.0을 D3D11_CREATE_DEVICE_SINGLETHREADED 플래그 없이 강제로 생성되도록 합니다. |
-force-driver-type-warp |
DirectX 11.0 드라이버 타입의 WARP 기기를 사용하도록 합니다. 자세한 내용은 Microsoft의 Windows Advanced Rasterization Platform 문서를 참조하십시오. |
-force-feature-level-9-3 |
DirectX 11.0 기능 레벨 9.3을 강제로 사용하도록 합니다. |
-force-feature-level-10-0 |
DirectX 11.0 기능 레벨 10.0을 강제로 사용하도록 합니다. |
-force-feature-level-10-1 |
DirectX 11.0 기능 레벨 10.1을 강제로 사용하도록 합니다. |
-force-feature-level-11-0 |
DirectX 11.0 기능 레벨 11.0을 강제로 사용하도록 합니다. |
-force-gfx-direct |
단일 스레드 렌더링을 강제로 사용하도록 합니다. |
-nolog |
UnityPlayer.log를 생성하지 않습니다. |