Node.js 시작하기
Node.js 프로그램을 IOSignal 서버에 연결해 봇, 다른 시스템과의 브리지, 자동화 스크립트, 가상 장치를 만듭니다. 같은 iosignal 패키지에 서버도 들어 있습니다. 처음이라면 핵심 개념 5분 요약을 먼저 읽으세요. 태그, 전달 방식, 홈채널은 모든 환경에서 같습니다.
1. 설치
Node.js 22.16.0 이상이 필요합니다.
npm install iosignal
2. 첫 연결
5분 빠른 시작에서 서버, 수신자, 송신자를 터미널 세 개로 실행합니다. 수신 터미널에 메시지가 나오면 성공입니다. 이어서 Node.js 클라이언트 만들기에서 구독과 송신을 한 프로그램에 넣습니다.
3. Node.js에서 다른 점
- 가져오기:
import { IO, Server } from 'iosignal'처럼 이름으로 가져옵니다. 브라우저용iosignal/browser/esm/io.js와 다릅니다. - 서버도 같은 패키지:
new Server({ port: 7777 })한 줄로 서버를 띄울 수 있습니다. 운영은 서버 시작하기를 보세요. - TCP 연결도 가능: WebSocket 대신 Arduino와 같은 TCP 포트로 붙으려면
IOCongSocket(cong://host:port)을 씁니다. 클라이언트 API - 프로세스 수명: 연결이 끊기면 자동으로 다시 연결합니다. 끝낼 때는
stop()(재연결 끄기)이나destroy()를 불러야 프로세스가 종료됩니다. - 장치처럼 동작: Node.js 프로그램도
#search에 답하고$name·$ui·$state를 보내면 remocon.kr에 장치로 나타납니다. 장치 만들기 (app.iosignal.net 호환): Node.js 예제
4. 만들기 가이드
| 만들고 싶은 것 | 문서 |
|---|---|
| 채널을 듣고 응답하는 봇 | Node.js 클라이언트 만들기, JS 구독과 수명주기 |
| 웹앱이 제어하는 가상 장치 | 장치 만들기 (app.iosignal.net 호환) |
| 내 서버 띄우기 | 서버 실행 |
| 서버가 판정하는 게임 | 게임 시작하기 |
| 메서드와 이벤트 찾기 | 클라이언트 API |
5. 도구
코드 없이 터미널에서 연결하고 시험할 때 씁니다.
- CLI 클라이언트
io-client: 구독하고 보내며 수신을 봅니다. - remocon CLI: 장치에 명령을 보냅니다.
- CLI 서버
io-server: 코드 없이 서버를 띄웁니다.