명령행 실행 인자

From Neos Wiki
Jump to navigation Jump to search
This page is a translated version of the page Command Line Arguments and the translation is 94% complete.
Outdated translations are marked like this.
Other languages:
English • ‎français • ‎日本語 • ‎한국어

데스크탑 버전의 NeosVR 클라이언트는 몇가지 명령행 인자를 지원합니다. 대부분의 실행인자는 Neos Launcher에서 제공하는 UI를 이용하여 사용하실 수 있습니다.

명령행 인자는 독립된 실행 환경에서 유용하게 사용할 수 있습니다.

특정 하드웨어를 기준으로 한 강제실행

  • none - 자동탐지
  • -SteamVR - 스팀VR
  • -RiftTouch - 오큘러스 리프트 + 터치 컨트롤러
  • -Screen - 스크린 모드(제한된 기능이 많으며, 대부분 디버깅 용도 입니다.)
  • -Screen360 - 스크린 모드(360 프로젝션)
  • -StaticCamera - 상호작용 불가 Camera Mode
  • -StaticCamera360 - 360 정방향 렌더링을 사용하는 상호작용 불가 모드
  • -MixedRealityCamera - 혼합현실을 사용하는 상호작용 불가한 카메라 모드
  • -LegacySteamVRInput - 고전 방식의 스팀VR 입력 방식을 사용합니다. 스팀VR 장치중 핸드 스켈레톤 모델이 잘못 되었거나 빠진 것으로 인한 문제를 해결할때 사용될 수 있습니다.
  • -ForceSRAnipal - Vive pro eye나 Facial tracker가 없더라도, 강제로 SR Anipal SDK을 적용하여 네오스를 실행합니다.
  • -LegacyScreen - 네오스를 과거의 "디버깅"모드로 실행

세션 참여 / 세션 시작

  • -Join Auto - LAN(로컬망)내 세션중 가장 많은 사용자가 있는 곳으로 자동참여 합니다.
  • -Join <URL or IP:Port> - URL을 이용해 특정 세션에 참여 합니다.
  • -Open <URL> - 지정된 URL의 월드를 시작합니다.
  • -Scratchspace <port> - 특정한 네트워크 포트로 스크래치 월드를 시작합니다.(초기에 쓰이던 것으로 삭제 될 예정입니다.)
  • -AnnounceHomeOnLAN - LAN에서 접속가능하도록 설정됩니다.
  • -Bootstrap <bootstrap class> - 네오스VR에서 제공되는 기본 static bootstrap 함수가 아닌, 맞춤형 함수를 실행하도록 설정합니다. 해당 함수가 있는 클래스명을 지정합니다.

카메라 기본값

카메라를 기본으로 제공되는 스크립트를 이용하여 특수한 형태로 사용할 수 있습니다.

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

아바타 관련 옵션

  • -ForceNoVoice - 아바타의 생성과 음성대화를 사용할수 없습니다. 프리젠테이션에 유용

기타

  • -Watchdog <file path> - 지정된 파일 경로에 월드를 주기적으로 저장합니다. 이는 네오스의 동작이 멈춰서 재시작 해야할 때 사용할 수 있습니다.
  • -LoadAssembly <path> - 네오스에 외부 CLR 어셈블리(eg. DLL)를 추가할 수 있습니다.
  • -Kiosk - 네오스를 키오스크 모드로 실행합니다.(로고나 월드 스위처 같은 사용자 공간류의 기능을 숨기고 손님계정의 순간이동(텔레포트)을 비활성화합니다)
  • -NoUI - 사용자 공간의 UI를 모두 숨깁니다.
  • -CubemapResolution <resolution> - 360 정방형 렌더링시 강제로 큐브맵 해상도를 사용하도록 합니다.
  • -ForceLANOnly - LAN(지역망, 내부망) 모드로 동작합니다. 인터넷을 통한 접근이 제한됩니다.
  • -DontAutoOpenCloudHome - 네오스 실행시 홈 월드를 자동으로 읽지 않도록 합니다.
  • -UseLocalCloud - 로컬 클라우드 API서버를 사용합니다. (디버깅용으로 주로 사용합니다)
  • -DeleteUnsyncedCloudRecords - 동기화 되지 않은 모든 정보를 데이터베이스에서 삭제합니다. 경고: 비동기 상태인 모든것들이 삭제되오니, 정말로 필요한 경우가 아니라면 사용하지 마시길 바랍니다.
  • -ForceSyncConflictingCloudRecords - 동기화 충돌 문제를 일으키는 대상을 로컬 정보로 덮어 씌워서 충돌을 해결합니다. 경고: 자칫하면 과거 버전으로 덮어 씌우는 불상사가 일어날 수 있으니, 신중히 사용하시기 바랍니다.
  • -UseNeosCamera - 줌 컨트롤, 미리보기 및 기타 기능이있는 정적 카메라를 생성합니다.
  • -DataPath <file path> - 지정된 경로의 데이터를 사용하여 네오스를 실행합니다.
  • -CachePath <file path> - 캐시 정보를 담아둘 경로를 수동으로 지정합니다.
  • -ResetDash - 대시 메뉴의 구성을 초기화(원상복구) 합니다.
  • -SkipIntroTutorial - 첫 또는 캐시삭제 후 네오스를 실행할 때 자습서를 건너뜁니다.
  • -Invisible - "오프라인으로 표시" 상태로 로그인합니다. 비밀리에 로그인해야 할 경우 사용합니다.
  • -Config <파일명> - 별도로 설정된 파일을 통해 네오스를 실행합니다.

네오스 커스텀 프로토콜 핸들러

네오스 설치시 사용자 지정 프로토콜 처리기가 같이 등록됩니다. 웹 링크처럼 동자하며, 브라우저 등에서 클릭하면 링크로 지정된 월드로 접속하도록 네오스를 실행합니다. 이는 Neos launcher에 전달되어 네오스가 실행되거나, 월드에 접속하도록 처리됩니다.

  • neos:?world=<URL> - 월드 오픈 또는 세션에 대한 링크 입니다.
    • 예제 : neos:?world=neosrec:///U-ProbablePrime/R-9ce872e1-ffb8-4194-bb91-3d3ab5f157a1 - 클릭시 ProbablePrime씨의 월드인 "The Directory"를 시작하게 됩니다.
    • 세션의 경우 : neos:?world=neos-session://eea1442e-0ff2-4d6a-ad16-2dac9ea786fc 같은 링크의 경우 "eea1442e-0ff2-4d6a-ad16-2dac9ea786fc"로 생성된 세션에 참여하게 됩니다.

주소를 얻는 방법은 크게 2가지로, 한가지는 인스펙터로 "월드 오브"를 살펴서 복사하거나, 대시의 세션탭에 있는 "참조 경로(Record URL) 복사"를 클릭하시어 클립보드에 복사하는 방법이 있습니다.

CopyRecordUrlButton.png


인스펙터를 이용한 방식에서의 주소 복사는 URL 속성에서 값 부분을 더블클릭하여 선택하신 뒤, Ctrl+C 또는 가상키보드의 Copy를 클릭하시면 됩니다.

유니티 스텐드얼론 플레이어의 명령행 인자

유니티 스텐드얼론 플레이어 명령행 인자를 통해 특정한 해상도나 윈도우 모드를 설정할 수 있습니다.

  • -screen-fullscreen 0 - 창모드로 실행
  • -screen-fullscreen 1 - 전체화면으로 실행
  • -screen-width - 수평 해상도 지정
  • -screen-height - 수직 해상도 지정

사용예: -screen-fullscreen 0 -screen-width 1280 -screen-height 720 네오스를 1280x720 해상도로 실행.

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

네오스를 기본값이 아닌 특정한 인자를 통해 실행하는 방법을 3가지 안내해 드리겠습니다. 각각의 예제는 -Invisible-CachePath <path> 명령을 어떻게 조합하여 사용하는지 보여드립니다. 여기에서 기본 캐시 경로(D:\Temporary files\NeosCache\)를 변경하는 방법을 보여드립니다. 대부분의 사용자는 #Launching from Steam에 설명 된 설정이 무난한 선택입니다.

스팀으로 실행하기

스팀 클라이언트의 라이브러리에서 네오스VR을 찾아 마우스 우클릭합니다. 표시되는 컨텍스트 메뉴에서 속성을 클릭합니다. 작은 다이얼로그 창(이미지 참조)이 뜨는데 '일반'탭을 선택하시면, '실행옵션' 이라는 텍스트 상자가 나오는데 그곳에 -Invisble -CachePath "D:\Temporary files\NeosCache\"를 입력하세요.

그러면, 이제 다음부터 스팀을 통해 네오스를 실행할 경우 설정한 명령행 인자가 적용될것입니다.

스팀에서 맞춤형 실행을 설정하기


네오스 런쳐를 통한 실행

네오스 런쳐는 스팀에서 플레이 버튼을 누르고, 'Launch Neos Launcher (offers advanced launch options)'을 선택하거나 네오스VR이 설치된 경로에 있는 NeosLauncher.exe를 더블 클릭하여 실행할 수 있습니다. 실행하면 아래처럼 런쳐가 실행이 됩니다. 명령행 인자를 넣고 실행하실려면 'Use custom bootstrap class'를 선택하시고 텍스트박스에 -Invisble -CachePath "D:\Temporary files\NeosCache\" 형식으로 입력하시고 'Lauch'를 클릭하시면 됩니다.

지정한 옵션은 네오스 런쳐에 저장되지 않으므로, 실행시점에만 적용됩니다.

네오스 런쳐 설정화면


바로 가기로 실행하기

Neos.exe를 바로 가기로 만들어서 사용하는 방법도 있습니다. 네오스가 설치된 곳에 있는 Neos.exe에 마우스 우클릭 하시고 '바로 가기 만들기'를 클릭하세요. 'Neos.exe - 바로 가기'가 생기는데 마찬가지로 마우스로 우클릭하시고 '속성'을 클릭하신 다음 '바로 가기' 탭으로 이동하시고 '대상'에 있는 값에 -Invisble -CachePath "D:\Temporary files\NeosCache\" 같은 인자를 추가하고 저장하세요.

저장이 완료되었으면, 이 바로 가기 아이콘을 원하는 경로(eg. 바탕화면)에 배치하시면 됩니다.

이렇게 만들어진 바로 가기 아이콘을 더블클릭하면, 네오스VR이 지정된 옵션으로 수행됨을 볼 수 있습니다. 물론, 이 바로 가기 아이콘이 아닌 다른 방법으로 실행을 하신다면, 바로 가기에 지정된 옵션이 아닌 다른 옵션으로 실행이 되겠지요.

바로 가기로 실행옵션 설정