====== Eunhasu CMD URL ======

Eunhasu V0.6.5부터 지원되는 기능입니다.

===== CMD URL =====

CMD URL(App control URL)은 브라우저 주소창에 URL을 입력해 Eunhasu 기기의 앱을 시작, 중지, 재시작하고 상태를 확인하는 기능입니다. Web GUI에서 메뉴를 찾아 들어가지 않아도 URL 하나로 앱을 제어할 수 있습니다.

Eunhasu 기기와 같은 네트워크에 연결된 PC나 스마트 기기의 웹 브라우저에서 사용합니다. 아래 설명의 <IP>는 사용하는 기기의 IP 주소로 바꿔 입력합니다(예: 192.168.0.38).

===== 앱 목록과 상태 확인 =====

브라우저 주소창에 아래 주소를 입력하면 제어할 수 있는 앱 목록과 각 앱의 현재 상태, 사용할 URL이 표시됩니다.

<code>http://<IP>/cmd/</code>

{{ :ko:cmd_01_list.jpg |}}

  * **app**: 제어할 앱의 이름입니다.
  * **status**: 앱의 현재 상태입니다. 'active'는 실행 중, 'inactive'는 중지된 상태입니다.
  * **start / stop / restart**: 각 동작에 사용하는 URL입니다.

===== CMD URL 사용 방법 =====

URL은 아래 형식으로 입력합니다. 앱 이름 뒤에 Start, Stop, Restart 중 하나를 붙입니다.

<code>http://<IP>/cmd/<앱 이름><동작></code>

^ 동작 ^ URL 예시 (Roon Ready) ^ 결과 ^
| 시작 | ''%%http://<IP>/cmd/roonreadyStart%%'' | 앱을 실행합니다. |
| 중지 | ''%%http://<IP>/cmd/roonreadyStop%%'' | 앱을 중지합니다. |
| 재시작 | ''%%http://<IP>/cmd/roonreadyRestart%%'' | 앱을 중지한 후 다시 실행합니다. |

URL을 입력하면 결과가 한 줄로 표시됩니다. 'OK'는 명령이 정상적으로 처리되었다는 뜻이고, 화살표(->) 뒤에 실행 후의 상태가 표시됩니다.

<code>OK    roonready  start  ->  active</code>

<note tip>URL은 목록 화면에 표시된 그대로(대소문자 포함) 입력합니다.</note>

==== 시작하기 (Start) ====

앱 이름 뒤에 Start를 붙여 입력합니다. 결과에 'active'가 표시되면 앱이 실행된 것입니다.

{{ :ko:cmd_02_start.jpg |}}

Eunhasu 홈 화면을 새로고침하면 해당 앱이 'Active'로 표시됩니다.

{{ :ko:cmd_03_start_ui.jpg |}}

==== 중지하기 (Stop) ====

앱 이름 뒤에 Stop을 붙여 입력합니다. 결과에 'inactive'가 표시되면 앱이 중지된 것입니다.

{{ :ko:cmd_04_stop.jpg |}}

Eunhasu 홈 화면을 새로고침하면 'Active' 표시가 사라지고 앱 이름(Roon Ready)이 표시됩니다.

{{ :ko:cmd_05_stop_ui.jpg |}}

==== 재시작하기 (Restart) ====

앱 이름 뒤에 Restart를 붙여 입력합니다. 앱이 중지된 후 다시 실행되며, 결과에 'active'가 표시됩니다. 앱이 정상적으로 동작하지 않을 때 사용합니다.

{{ :ko:cmd_06_restart.jpg |}}

{{ :ko:cmd_07_restart_ui.jpg |}}

===== 지원 앱 목록 =====

CMD URL로 제어할 수 있는 앱은 아래와 같습니다. 각 앱의 URL은 ''%%http://<IP>/cmd/%%'' 뒤에 앱 이름과 동작을 붙인 형식입니다(예: mpdStart, mpdStop, mpdRestart).

^ 앱 이름 (app) ^ 설명 ^
| roonready | [[:ko:roon#roon_ready|Roon Ready]] |
| roonserver | [[:ko:roon#roon_server|Roon Server]] |
| mpd | [[:ko:mpd|MPD (Music Player Daemon)]] |
| qobuz | Qobuz Connect |
| hqplayer | HQPlayer Embedded |
| hqplayernaa | [[:ko:hqplayer_naa|HQPlayer NAA]] |
| lms | LMS (Lyrion Music Server) |
| squeezelite | [[:ko:squeezelite|Squeezelite]] |
| shairport | [[:ko:shairport|Shairport]] (AirPlay 수신) |
| librespot | [[:ko:librespot|LibreSpot]] (Spotify Connect) |
| minimserver | [[:ko:minimserver|MinimServer]] |
| bubbleserver | BubbleUPnP Server |
| diretta | Diretta |
| audirvana | Audirvana |