remocon CLI로 명령 보내기
remocon은 IOSignal 서버에 메시지를 보내는 CLI입니다. 셸 스크립트에서 한 번 보내고 끝내거나, 터미널의 줄·키 입력을 그대로 보내 장치를 조작할 때 씁니다. 서버 실행과 대화형 디버깅은 iosignal-cli를 쓰세요. 두 CLI는 같은 저장소(iosignal-cli의 packages/remocon)에서 함께 릴리스합니다.
설치
Node.js 22.16.0 이상이 필요합니다.
npm install -g remocon
remocon과 remote 두 명령이 설치됩니다.
연결 옵션
기본 서버는 wss://io.remocon.kr/ws입니다. 공통 옵션은 하위 명령 앞에 씁니다.
remocon -c ws://localhost:7777 pub demo hello
remocon -c cong://localhost:8888 input demo --keys
remocon -c ws://localhost:7777 -i uno -k uno-key console
| 옵션 | 설명 |
|---|---|
-c, --connect <url> | ws://, wss:// 또는 cong://. host:port만 쓰면 WebSocket |
-i, --id <id> / -k, --key <key> | 인증 ID와 키, 함께 지정 |
-a, --auth-idKey <id.key> | 인증 정보 단축 표기. -i/-k 쌍이 우선 |
-j, --join-channel <tags> | 시작할 때 구독, 쉼표로 구분 |
-t, --timeout <ms> | 연결, 종료 확인, 서비스 응답 제한 시간. 기본 10000ms |
-h, --help / -V, --version | 도움말 / 버전 |
명령행의 키는 셸 기록이나 프로세스 목록에 남을 수 있습니다.
한 번 보내기
remocon pub demo hello world # payload 두 개: hello, world
remocon pub demo "hello world" # payload 하나
remocon call reply echo hello # 서버 서비스 호출, 응답 출력
remote demo hello # 예전 문법 그대로
pub, publish, sig, signal은 같은 동작입니다. 연결이 ready가 된 뒤 보내고, 끝내기 전에 서버 echo로 앞선 메시지를 서버가 받았는지 확인합니다. 이 확인은 받는 장치가 처리했다는 뜻이 아닙니다. 장치 처리를 확인하려면 장치의 $state 같은 응답을 구독하세요.
장치 하나에 명령을 보낼 때는 그 장치의 CID 뒤에 @를 붙여 직접 보냅니다(장치는 @로 받습니다).
remocon pub "?k3vd@" toggle # 익명 장치 ?k3vd에 toggle 명령
줄 단위 입력
remocon input demo # --lines가 기본
printf 'first\nsecond\n' | remocon input demo
Enter마다 한 줄 전체를 문자열 하나로 보냅니다. 앞뒤 공백, 빈 줄, 따옴표를 그대로 둡니다. 파이프 입력은 끝까지 보낸 뒤 종료합니다.
키 단위 입력
remocon input demo --keys
TTY 터미널에서 키를 누를 때마다 바로 보냅니다. 문자는 그 글자(a, 한), 특수 키는 이름(up, down, enter, ctrl+a, f1)입니다. Ctrl+C는 보내지 않고 종료합니다. 운영체제 전역 키보드가 아니라 현재 터미널의 입력이며, 키를 떼는 이벤트는 없습니다. 받는 쪽에서는 up이라는 글자와 방향키 이름이 같은 문자열입니다.
대화형 명령
인자 없이 remocon(또는 remocon console)을 실행하면 대화형 명령이 시작됩니다. 명령은 iosignal-cli와 같고(sub, pub, call, id, ping 등, 앞에 점 없음), 따옴표로 공백이 든 인자를 묶을 수 있습니다. input <tag>로 줄 입력 모드에 들어가 .back으로 돌아옵니다. 전체 목록은 help로 봅니다.
ping은 서버 ping입니다. 9.19.0부터 상대 CID로 보내는ping <cid>는 없습니다.- 접속할 때마다
iam('remocon-cli')로 연결 이름을 알립니다.