---
title: Unity 플레이어 커맨드 라인 인자 참조
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/ko-kr/engine/6000.0/manual/unity-editor/command-line-arguments/player
latest_url: https://docs.unity.com/ko-kr/engine/7000.0/manual/unity-editor/command-line-arguments/player.md
last_updated: 2026-11-12
generated_at: 2026-11-20T00:59:36.407Z
locale: ko-kr
---

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

> 커맨드 라인 빌드된 플레이어를 실행할 때 사용할 수 있는 인수 리스트입니다.

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

이러한 인수는 [웹 플랫폼](/engine/6000.0/manual/platform-specific/webgl.md)을 제외한 모든 독립 실행형 플랫폼에서 작동합니다. 다음 표에는 추가 플랫폼 요구 사항이 나와 있습니다.

커맨드 라인에서 Unity를 실행하는 방법에 대한 자세한 내용은 [커맨드 라인 인터페이스에서 Unity 실행](/engine/6000.0/manual/unity-editor/command-line-arguments/run-unity.md)을 참고하십시오.

| **명령**                                              | **설명**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `-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`](/engine/6000.0/script-reference/unityeditor/playersettings/useflipmodelswapchain.md)를 참조하십시오.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `-force-d3d11-flip-model`(Windows 전용)               | Direct3D 11을 사용할 때 애플리케이션이 DXGI 플립 모델 스와프체인을 사용하도록 합니다. 자세한 내용은 [`PlayerSettings.useFlipModelSwapchain`](/engine/6000.0/script-reference/unityeditor/playersettings/useflipmodelswapchain.md)를 참조하십시오.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `-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 고급 래스터화 플랫폼](https://docs.microsoft.com/en-gb/windows/win32/direct3darticles/directx-warp?redirectedfrom=MSDN)에 대한 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 스탠드얼론 플레이어 로그 파일을 작성할 파일 경로 위치를 지정합니다. 이 인수가 제공되지 않는 경우 로그 파일의 기본 위치에 대한 자세한 내용은 [로그 파일 레퍼런스](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md)를 참조하십시오. 콘솔로 출력하려면 경로 이름의 `-`를 지정합니다. Windows에서는 `-logFile`를 사용하여 기본적으로 콘솔이 아닌 [`stdout`](https://learn.microsoft.com/en-us/cpp/c-runtime-library/stdin-stdout-stderr?view=msvc-170)로 출력을 지정할 수 있습니다. 경로에 공백이 있는 경우, 이중따옴표로 래핑합니다. 일부 커맨드 라인 인터페이스는 경로에 공백이 없더라도 경로에 따옴표를 입력해야 할 수 있습니다.예시(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`](/engine/6000.0/script-reference/unityengine/experimental/rendering/shaderwarmup.md)를 사용하여 셰이더 배리언트를 예열할 때 Unity가 PSO(파이프라인 상태 오브젝트)를 생성하는 데 사용하는 병렬 스레드 수를 설정합니다. 이는 애플리케이션이 DirectX 12, Metal 또는 Vulkan 그래픽스 API 사용하는 플랫폼에서 실행되는 경우에만 영향을 줍니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `-monitor N`                                        | 지정된 모니터에서 스탠드얼론 플레이어를 실행하며, 1 기반 인덱스 번호로 표시됩니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-nographics`                                       | 배치 모드에서 이 인자를 사용하면 Unity 그래픽스 기기를 초기화하지 않습니다. 이를 통해 GPU가 없는 머신에서 자동화된 워크플로를 실행할 수 있습니다.**참고:** 출력 로그는 이 모드에서 꺼져 있습니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `-nolog`                                            | 플레이어 로깅을 비활성화합니다. 플레이어 로그의 내용과 위치에 대한 자세한 내용은 [로그 파일 레퍼런스](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md) 폴더를 참조하십시오.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `-no-stereo-rendering`                              | 스테레오 렌더링을 끄십시오.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-parentHWND <HWND> delayed`(Windows 전용)            | Windows 스탠드얼론 애플리케이션을 다른 애플리케이션에 포함합니다. 이 인자를 사용하면 부모 애플리케이션의 창 핸들(‘HWND’)을 Windows 스탠드얼론 애플리케이션에 전달해야 합니다.`-parentHWND 'HWND' delayed`를 전달하면 Unity 애플리케이션이 실행되는 동안 숨겨집니다. 또한 애플리케이션에서 Unity용 [Microsoft 개발자 라이브러리](https://docs.microsoft.com/en-gb/)에서 [SetParent를](https://docs.microsoft.com/en-gb/windows/win32/api/winuser/nf-winuser-setparent?redirectedfrom=MSDN) 호출해야 합니다. Microsoft의 `SetParent`는 Unity 창을 포함합니다. Unity 프로세스를 생성할 때 Unity 창은 Microsoft의 [STARTUPINFO](https://docs.microsoft.com/en-gb/windows/win32/api/processthreadsapi/ns-processthreadsapi-startupinfoa?redirectedfrom=MSDN) 구조의 일부로 제공된 위치와 크기를 따릅니다.Unity 창의 크기를 조절하려면 Microsoft의 `GetWindowLongPtr` 함수에서 [GWLP\_USERDATA](https://docs.microsoft.com/en-gb/windows/win32/api/winuser/nf-winuser-getwindowlongptra?redirectedfrom=MSDN)를 선택합니다. 최소 비트는 그래픽스가 초기화될 때 1로 설정되며 크기를 안전하게 조절할 수 있습니다. Unity 스플래시 화면이 표시되면 두 번째로 낮은 비트가 1로 설정됩니다.자세한 내용은 다음 다운로드 가능한 예시를 참조하십시오. [EmbeddedWindow.zip](/api/download.md?file=/engine/6000.0/media/downloads/EmbeddedWindow.zip) |
| `-popupwindow`                                      | 창을 프레임 없이 다이얼로그 창으로 만듭니다. 이 커맨드는 macOS에서 지원되지 않습니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `-screen-fullscreen`                                | 기본 전체 화면 상태를 오버라이드합니다. 0 또는 1이어야 합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `-screen-height`                                    | 기본 화면 높이를 오버라이드합니다. 지원되는 해상도의 정수여야 합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `-screen-quality`                                   | 기본 화면 품질을 오버라이드합니다. 사용 예시: `/path/to/myGame -screen-quality Beautiful`. 지원되는 옵션은 [품질 설정](/engine/6000.0/manual/unity-editor/editor-settings-reference/comp-manager-group/class-quality-settings.md) 이름과 일치합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `-screen-width`                                     | 기본 화면 너비를 오버라이드합니다. 이 너비 값은 지원되는 해상도의 정수여야 합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-single-instance`(Linux 및 Windows만 해당)             | 한 번에 하나의 애플리케이션 인스턴스만 실행합니다. 다른 인스턴스가 이미 실행 중인 경우 `-single-instance`로 애플리케이션을 다시 시작하면 기존 인스턴스에 포커스가 맞춰집니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `-systemallocator`                                  | 플랫폼이 시스템 할당자를 사용하도록 합니다. 주소 처리기와 같은 툴을 사용하여 메모리 문제를 디버깅하려는 경우 유용할 수 있습니다. 디버깅 목적으로만 이 옵션을 사용해야 합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `-timestamps`                                       | 모든 [플레이어 로그](/engine/6000.0/manual/scripting/debugging-and-diagnostics/log-files.md) 메시지를 현재 타임스탬프 및 스레드 ID로 접두사로 지정합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `-wait-for-managed-debugger`                        | 플레이어가 실행 전에 관리되는 디버거가 연결될 때까지 대기하도록 만듭니다. 플레이어의 프로세스 ID를 표시하는 다이얼로그를 생성합니다. 관리형 디버깅에 대한 자세한 내용은 Unity에서 [C# 코드 디버그](/engine/6000.0/manual/scripting/debugging-and-diagnostics/managed-code-debugging.md#DebugInEditor)를 참고하십시오.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `-wait-for-native-debugger`                         | 실행하기 전에 플레이어가 네이티브 디버거가 연결될 때까지 기다립니다. 플레이어의 프로세스 ID를 표시하는 다이얼로그를 생성합니다.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `-window-mode`(Windows 전용)                          | 전체 화면 창 모드를 오버라이드합니다. 허용되는 값은 `exclusive` 또는 `borderless`입니다. 자세한 내용은 [플레이어 설정](/engine/6000.0/manual/unity-editor/editor-settings-reference/comp-manager-group/class-player-settings.md)을 참고하십시오.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

## 추가 리소스##additional-resources

* [커맨드 라인에서 빌드 만들기](/engine/6000.0/manual/building-and-publishing/build-customize-build-pipeline/build-command-line.md)
* [Android 플레이어 커맨드 라인 인자](/engine/6000.0/manual/platform-specific/android/developing/application-entries/activity/unity-player-activity/custom-activity-command-line.md)
* [커맨드 라인에서 Unity 액셀러레이터 사용](/engine/6000.0/manual/assets-and-media/importing-caching-assets/accelerator-command-line.md)
* [커맨드 라인에서 임베디드 Linux용 빌드](/engine/6000.0/manual/platform-specific/embedded-systems/embedded-linux/build-and-deliver/command-line.md)
* [커맨드 라인에서 QNX용 빌드](/engine/6000.0/manual/platform-specific/embedded-systems/qnx/build-and-deliver/build-command-line.md)
* [Test Framework 커맨드 라인 인자 참조](/engine/6000.0/manual/reference-command-line.md)
* [프로파일러 커맨드 라인 인자 참조](/engine/6000.0/manual/analysis/profiler/command-line-arguments.md)
* [커맨드 라인에서 Project Auditor 실행](/engine/6000.0/manual/run-from-command-line.md)
