Command Line Arguments/ko: Difference between revisions

From Resonite Wiki
No edit summary
No edit summary
Line 24: Line 24:


<!--T:5-->
<!--T:5-->
* '''-Join Auto''' - LAN에서 활성 세션에 자동으로 참여 및 팔로우(현재 사용자가 가장 많은 세계로 이동됨)
* '''-Join Auto''' - LAN에서 활성 세션에 자동으로 참여 (현재 사용자가 가장 많은 세계로 이동됨)
* '''-Join ''Insert_URL_or_IP:Port_here''''' - 지정된 URi (Resonite-session | lnl)에서 세션에 참여
* '''-Join ''Insert_URL_or_IP:Port_here''''' - 지정된 URi에서 세션에 참여 (Resonite-session | lnl)
* '''-Open ''Insert_URL_here''''' - 시작 시 지정된 URL에서 월드 열기(Resoniterec)
* '''-Open ''Insert_URL_here''''' - 시작 시 지정된 URL에서 월드 열기(Resoniterec)
* '''-Scratchspace ''Insert_port_here''''' - 지정된 포트에서 새 스크래치 스페이스 월드를 시작합니다(레거시, 제거될 가능성이 높음).
* '''-Scratchspace ''Insert_port_here''''' - 지정된 포트에서 새 스크래치 스페이스 월드를 시작합니다(레거시, 제거될 가능성이 높음).

Revision as of 03:25, 6 February 2024

레소나이트 데스크톱 빌드는 여러 명령줄 인자를 지원합니다. 이러한 인자의 대부분은 레소나이트 런처를 사용할떼, 보다 시각적인 방식으로 설정할 수 있고, 여러가지 실행 설정을 지정해 관리할 수 있습니다.

이러한 명령줄 인수는 독립형 채험을 설정할 때 유용할 수 있습니다.

특정 하드웨어 강제 적용

  • 없음 - 자동 감지
  • -SteamVR - SteamVR 모드
  • -RiftTouch - 오큘러스 리프트 및 터치 컨트롤러 모드
  • -Screen - 데스크톱 모드
  • -Screen360 - 360 등장방형 렌더링 데스크톱 모드
  • -StaticCamera - 비-상호작용 카메라 모드
  • -StaticCamera360 - 360 등장방형 렌더링을 사용하는 비-상호작용 카메라 모드
  • -MixedRealityCamera - 혼합 현실 렌더링을 사용하는 비-상호작용 카메라 모드
  • -LegacySteamVRInput - 기존 Steam VR 입력 처리 강제. 오큘러스 퀘스트에 사용되는 Virtual Desktop과 같이 손 골격 모델이 없거나 잘못된 일부 Steam VR 기기에 대한 해결 방법으로 사용됩니다.
  • -ForceSRAnipal - Vive Pro Eye가 없는 경우에도 HTC 눈 및 입술 트래킹을 위해 SR Anipal SDK를 강제로 초기화합니다.
  • -LegacyScreen - Resonite가 이전 데스크톱 "디버깅" 모드에서 강제로 실행되도록 합니다.
  • -EnableOWO Insert_ip_address_here - OWO 게임 햅틱 조끼 연동을 활성화하며, 조끼의 IP 주소를 입력해야 합니다. 현재 작동하지 않으니 관련 Github 이슈를 참조하세요.

세션 참여 / 월드 열기

  • -Join Auto - LAN에서 활성 세션에 자동으로 참여 (현재 사용자가 가장 많은 세계로 이동됨)
  • -Join Insert_URL_or_IP:Port_here - 지정된 URi에서 세션에 참여 (Resonite-session | lnl)
  • -Open Insert_URL_here - 시작 시 지정된 URL에서 월드 열기(Resoniterec)
  • -Scratchspace Insert_port_here - 지정된 포트에서 새 스크래치 스페이스 월드를 시작합니다(레거시, 제거될 가능성이 높음).
  • -AnnounceHomeOnLAN - 홈과 사용자 공간은 기본적으로 LAN에서 액세스할 수 있습니다.
  • -Bootstrap Insert_bootstrap_class_here - 지정된 이름의 클래스에서 사용자 정의 부트스트랩 함수를 실행합니다.

네트워킹

  • -ForceLANOnly - 모든 월드는 기본적으로 LAN 네트워크에서만 공개되며 인터넷에서는 액세스할 수 없습니다
  • -ForceRelay - 세션에 연결할 때 NAT 펀치스루 프로세스를 건너뛰어, 릴레이 서버 사용을 효과적으로 강제합니다.
  • -UseLocalCloud - 로컬 클라우드 API 서버 사용 - 주로 디버깅에 사용
  • -UseStagingCloud - 스테이징 API 서버 사용 - 주로 디버깅에 사용

드론 카메라 프리셋

These initialize the static camera with a drone script, using a specific movement preset.

  • -CameraBiggestGroup
  • -CameraTimelapse
  • -CameraStayBehind
  • -CameraStayInFront

And also these args usable for Drone Camera.

  • -UseResoniteCamera - Will spawn Static Camera as the Resonite Camera with zoom controls, preview and other functions

== Common Avatar Builder ==

  • -ForceNoVoice - CommonAvatarBuilder won't setup any avatars with voice (useful for local presentations)

데이터 폴더

Resonite has multiple Data Folders, these have various command line arguments to control:

로그 폴더

  • -LogsPath C:\specified\directory - Redirect log files to be saved in a custom specified directory.

동기화 관련 문제

  • If you're having synchronization issues then see Sync Errors which has various guides on how to use command line arguments to resolve sync issues.

데이터베이스 복구

  • If you're having database issues then Database repair is a guide on how to use a Command Line Argument to resolve the issue.

포스트 프로세싱

  • -ctaa - Enables ctaa (Cinematic Temporal Anti-Aliasing)
  • -ctaaTemporalEdgePower Insert_Number_here - Sets ctaa's TemporalEdgePower
  • -ctaaSharpnessEnabled Insert_True_or_False_here - Sets whether ctaa's Sharpness is Enabled
  • -ctaaAptiveSharpness Insert_Number_here - Sets ctaa's ctaaAptiveSharpness amount

기타

  • -Watchdog Insert_filepath_here - Resonite will periodically write current time into given file. This can be used to restart the process when it freezes
  • -LoadAssembly Insert_path_here - Loads extra CLR assembly into the Resonite process
  • -Kiosk - Will run Resonite in Kiosk mode (hides the Userspace items such as logo and world switcher and disables teleporting for guests by default)
  • -NoUI - Hides the Userspace UI
  • -CubemapResolution Insert_resolution_here - Force the 360 equirectangular rendering to use this resolution for the cubemap
  • -DoNotAutoLoadHome - Wont' automatically load your cloud home on start (can still load manually)
  • -ResetDash - Resets the layout of the dash to the default configuration.
  • -SkipIntroTutorial - Prevents the intro tutorial from starting
  • -Forceintrotutorial - Forces the intro tutorial to run
  • -Invisible - Force your online status to be invisible on login.
  • -EngineConfig Insert_filepath_here - Specifies a custom config file.
  • -BackgroundWorkers Insert_number_here - overrides the number of background worker processes. WARNING: Don't use this unless you really need to, things could break!
  • -PriorityWorkers Insert_number_here - overrides the number of priority worker processes. WARNING: Don't use this unless you really need to, things could break!
  • -ForceReticleAboveHorizon - Disallows looking below the Horizon for desktop when in first person by default.

== Resonite Custom Protocol Handler (Steam only) ==

Resonite registers a custom protocol handler with your computer on installation. You can use this to create links which will open Resonite to a set location or world when they are clicked. These arguments are given to the Resonite launcher, which will make sure Resonite is launched and running and forward them to the running instance.

  • Resonite:?world=Insert_URL_here - Open a world or session at given URL
    • For example Resonite:?world=resrec:///U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1 - Will Open "The Directory" by ProbablePrime
    • And for Sessions Resonite:?world=Resonite-session://eea1442e-0ff2-4d6a-ad16-2dac9ea786fc will join session eea1442e-0ff2-4d6a-ad16-2dac9ea786fc

The URL of a world can be accessed by opening the inspector for a world orb and navigating to the WorldOrb component or by using the Session menu's "Copy Record URL" button:

Dashboard on the "Session" tab and the "Settings" selected with the button "Copy Record URL" highlighted

The URL field can be selected by double clicking into the field. The URL text can be copied to the Windows clipboard via Ctrl+C.

When linking to a world on a platform that restricts the clickability protocol handlers, you can use the redirect junction located at https://api.resonite.com/open/ instead. They will redirect to use the above Resonite: protocol handler.

== Unity Standalone Player command line arguments ==

The Unity Standalone Player command line arguments can be useful for setting a specific resolution, or the windowed mode.

  • -screen-fullscreen 0 - Launch Resonite in a window.
  • -screen-fullscreen 1 - Launch Resonite in full-screen.
  • -screen-width - Sets the horizontal resolution.
  • -screen-height - Sets the vertical resolution.

Example: If you use -screen-fullscreen 0 -screen-width 1280 -screen-height 720 Resonite will launch in a 1280x720 window.

명령줄 인자를 사용하는 방법

Below are three methods for launching Resonite using non-default command line arguments. Each example explains how to combine the -Invisible and -CachePath Insert_path_here commands. Here the examples show how to specify a non-default cache location at D:\Temporary files\ResoniteCache\. DO NOT COPY THIS EXAMPLE IF YOU DO NOT NEED TO DO THIS! Choosing the best method to use depends on how you normally launch Resonite. For most users, the setup described in #Launching from Steam is likely the best choice.

Steam에서 시작하는 법

  1. Open Steam
  2. Right click on Resonite in your library
  3. Select "Properties" and then "Set Launch Options".
  4. Enter the command you need to use, exactly as it appears above and Run Resonite.

Setting custom launch options via Steam

Now, if Resonite is launched via Steam, the custom command line arguments will take effect.

Commands entered via this method will not take effect if Resonite is launched any other way, such as directly launching the Resonite.exe.

=== For the Standalone build ===

Use a shortcut

It is possible to use launch commands via a custom shortcut targeting the Resonite.exe file.

To create a shortcut:

  1. Find the Resonite install folder and right-click on the Resonite.exe.
  2. In the context menu click 'Create Shortcut'
  3. Move the 'Resonite.exe - Shortcut' file to somewhere more convenient (such as the Desktop).
  4. Right-click on the shortcut file and click 'Properties' in the context menu.
  5. This opens a dialog window. Select the 'Shortcut' tab.
  6. In the 'Target' text box add a space after the Resonite.exe filepath and then add your command line arguments.
  7. Click 'Apply' and 'OK'.

Now, if Resonite is launched by double clicking on the shortcut it will launch using the custom options. These will not be applied if a different method is used to start Resonite.

Setting custom launch options for a Shortcut