Version: 2021.2
언어: 한국어
Unity 에디터 커맨드 라인 인자
배치 모드 및 빌트인 코루틴 호환성

Unity 스탠드얼론 플레이어 커맨드 라인 인자

커맨드 라인에서 Unity 플레이어를 실행하고 인자에 전달하여 플레이어가 실행하는 방법을 변경할 수 있습니다.

커맨드 세부 정보:
-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을 들 수 있습니다. 지원되는 옵션은 품질 설정 이름과 일치합니다.
-vrmode <devicetype> 특정 VR 기기로 실행합니다. 자세한 내용은 가상 현실을 참조하십시오.
-force-low-power-device(macOS 전용) 스탠드얼론 플레이어가 저전력 기기를 사용하도록 합니다.
-force-metal (macOS 전용) 스탠드얼론 플레이어가 Metal을 기본 그래픽스 API로 사용하도록 합니다.
-force-d3d11 (Windows 전용) 애플리케이션이 렌더링에 Direct3D 11을 사용하도록 합니다.
-force-d3d12 (Windows 전용) 애플리케이션이 렌더링에 Direct3D 12를 사용하도록 합니다.
--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 전용) 전체 화면 창 모드를 오버라이드합니다. 허용되는 값은 exclusive 또는 borderless입니다. 자세한 내용은 스탠드얼론 플레이어 설정을 참조하십시오.

유니버설 Windows 플랫폼 커맨드 라인 인자

유니버설 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를 생성하지 않습니다.
Unity 에디터 커맨드 라인 인자
배치 모드 및 빌트인 코루틴 호환성