본문으로 건너뛰기

버전과 검증 기준

이 사이트의 JavaScript 문서는 IOSignal 9.x를 기준으로 합니다. 문서 기준 버전은 이 페이지에서만 안내하며, 각 가이드에는 버전 차이가 있는 동작에만 "8.0.0부터"처럼 버전을 적습니다.

  • 설치: 가이드의 설치 명령은 npm install iosignal입니다. 설치 시점의 최신 버전이 package.json에 ^9.x 범위로 기록되고, 잠금 파일이 실제 설치 버전을 고정합니다. 새 메이저 버전이 나오면 이 페이지에서 먼저 안내합니다.
  • CDN: 잠금 파일이 없으므로 URL에 메이저 버전을 고정합니다(iosignal@9). 그래야 새 메이저 버전이 나와도 기존 페이지가 깨지지 않습니다.
구성기준확인 범위
IOSignal JavaScript9.x (검증 9.12.0, 서버 호스트 9.13.0, 대시보드 9.14.0, 연결 응답 제한 9.19.0)2026-11-12: 예제 5개 빌드, 채팅 4개 양방향 송수신·재접속, WebRTC 테스트 5개. 2026-11-18: 9.19.0 공개 빌드 시험 293개
iosignal-cli, remocon9.x (9.19.0)2026-11-18: 두 CLI를 한 저장소에서 함께 릴리스, 패키지 시험(iosignal-cli 25개, remocon 14개). 내장 서버는 IOSignal 9.19.0. 8.x CLI와 옵션이 다르므로 io-server --version으로 확인하세요
IOSignal Arduino9.23.12026-11-21: 예제 34개를 대상 보드별로 컴파일(개발 원본), 공개 저장소에서 보드별 대표 10개와 예전 remocon:: 이름을 쓰는 스케치 컴파일. 예제는 실물로 다시 돌리지 않음. 변경은 9.23.1, 9.23.0, 9.21.0
Remocon Arduino9.22.0 (마지막)장치 예제가 든 마지막 버전이고 더 고치지 않습니다. 9.23.0부터 예제는 IOSignal Arduino에 있습니다. 예제별 실물 확인 여부는 arduino.iosignal.net 예제 페이지에 있습니다
BohoJS 2.2.1 / Arduino 1.1.0암호화 설명의 구현 기준

버전 번호: 공개 번호는 개발 버전 번호를 따르므로 중간 번호를 건너뛸 수 있습니다(9.6.0 다음 9.12.0). iosignal-cli, remocon(npm), IOSignal Arduino, Remocon Arduino가 iosignal과 같은 번호를 쓰는 것은 권장이며, 바뀐 것이 없으면 이전 번호를 유지합니다(예: iosignal 9.13.0과 iosignal-cli 9.12.0). 9.0.0~9.12.0에는 iosignal, iosignal-cli, remocon을 같은 번호로 함께 릴리스했습니다. 9.19.0의 iosignal-cli·remocon처럼 바뀐 것이 쌓이면 다시 같은 번호로 맞춥니다. 9.x끼리는 접속 호환이므로 번호가 달라도 함께 쓸 수 있습니다. Boho는 따로 관리합니다. Arduino Library Manager 등록 상태는 저장소 상태보다 늦을 수 있습니다.

7.2.0부터 적용된 동작​

  • 직접 메시지는 공통 @ 다음에 정확한 토픽 @topic 이벤트가 발생합니다. 같은 처리를 양쪽에 등록하면 중복 실행될 수 있습니다. 토픽 없는 @는 한 번 발생하며 직접 수신은 message에 전달되지 않습니다.
  • 직접 수신에 subscribe('@topic') 또는 unsubscribe('@topic')를 사용하면 TypeError입니다. on()이나 listen()을 사용합니다. 발행 CID를 포함한 A@topic 구독은 허용합니다.
  • link()·unlink()는 컴포넌트 소유 구독과 리스너를 정리하며 다른 소유자의 공유 구독을 유지합니다.
  • EMPTY 수신은 인수가 없는 (tag)이고 명시적 null과 구별합니다. 이전 개발 버전은 EMPTY에 null을 전달했습니다. 태그는 UTF-8 255바이트 제한을 따릅니다.

자세한 규약은 클라이언트 API, JS 구독과 수명주기, 데이터 형식을 확인하세요.

실물 보드, 실제 카메라·마이크, Safari/iOS, 다른 인터넷망, TURN relay는 이번 검증에 포함하지 않았습니다(검증 범위).

9.19.0에서 바뀐 동작​

9.14.0 다음 공개 버전입니다(9.15.0~9.18.0은 공개하지 않았습니다). iosignal-cli와 remocon도 9.19.0입니다. 와이어 프로토콜은 그대로이고 9.x 서버·클라이언트와 접속 호환입니다.

  • 서버 응답 제한 시간(클라이언트): 연결을 시작한 뒤 15초 안에 서버의 첫 응답(hello)이 오지 않으면 error 이벤트(no reply from the server in 15 s)를 내고 연결을 닫습니다. 자동 재연결이 켜져 있으면 처음 주소로 다시 접속합니다. 서버가 다른 주소로 안내(redirecting)했는데 그 주소에 닿지 않으면 원래 서버로 돌아갑니다. 값은 SIZE_LIMIT.SERVER_HELLO_TIMEOUT(15000ms)입니다. 연결과 CID 수명주기
  • IOCongSocket 주소: cong:// 없이 192.168.0.10:8888 같은 IPv4 숫자 주소도 받습니다. 이전에는 new URL() 오류가 났습니다. host:port, cong://host:port는 그대로입니다.
  • BohoAuth.beforeAccept(): 키와 역할 검사를 통과한 로그인을 받아들이기 전에 하위 클래스가 다른 서버로 안내할 수 있습니다. 기본은 모두 받아들입니다. 서버 인증 설정
  • Redis 키 목록: RedisKeyProvider가 장치 키 목록을 KEYS 대신 SCAN으로 읽어 큰 Redis에서 서버를 멈추지 않습니다. SCAN을 쓸 수 없는 클라이언트나 서버면 KEYS로 돌아갑니다. RedisService가 SCAN(scan) 명령을 허용합니다.
  • 피어 ping 제거: CLI(iosignal-cli, remocon)와 remocon.kr 웹 CLI의 ping <cid>를 없앴습니다. ping은 서버 ping만이며 응답을 한 줄에서 갱신합니다. 입력 중에 메시지가 와도 입력하던 줄이 유지됩니다.
  • remocon CLI 위치: remocon 저장소를 iosignal-cli 저장소(packages/remocon)로 합쳤습니다. npm 패키지 이름과 명령은 그대로입니다. remocon CLI
  • 확인 범위(2026-11-18): 공개 빌드 시험 293개(ESM·CJS). 서버 응답 제한과 숫자 주소는 개발 원본의 단위 시험 4개(응답하지 않는 서버, 응답하지 않는 redirect 대상, 제때 응답하는 서버, IPv4 숫자 주소)로 확인했습니다.

IOSignal Arduino 9.23.1​

통신 API와 프로토콜은 9.23.0과 같고, 기존 스케치는 그대로 컴파일됩니다.

  • 도우미 이름공간이 iosignal: IOSignalUi.h, IOSignalBinding.h의 함수와 상수는 iosignal::formatNameSetting()처럼 씁니다. 9.23.0의 remocon::은 같은 이름공간의 별칭으로 남아 있습니다(예전 Remocon 라이브러리의 RemoconUi.h와 한 스케치에 함께 넣을 수는 없음).
  • 예제 기본 서버 io.iosignal.net: 전에는 io.remocon.kr(같은 브로커). 보드 설정에 저장한 서버가 먼저 쓰입니다.
  • 예제 머리 주석의 "Remocon example"을 "device example"로 바꿨습니다.

IOSignal Arduino 9.23.0​

통신 API는 그대로이고, 예제와 도우미 헤더를 한 라이브러리로 모았습니다.

  • 예제를 모두 IOSignal로: Remocon Arduino 9.22.0에 있던 장치 예제 22개가 파일 > 예제 > IOSignal에 들어 있습니다. 예제 이름은 그대로입니다. Remocon 라이브러리는 9.22.0에서 멈추고, 새 예제는 IOSignal에만 더합니다.
  • 도우미 헤더 이름: RemoconUi.h → IOSignalUi.h, RemoconBinding.h → IOSignalBinding.h, RemoconButtons.h → IOSignalButtons.h(클래스 RemoconButtons → IOSignalButtons). 함수와 동작은 같으므로 #include와 클래스 이름만 바꾸면 됩니다.
  • 의존성: 그대로(Boho, Crypto, Bounce2)입니다. FastLED, U8g2, IRremote, Ethernet은 그 라이브러리를 쓰는 예제에만 필요하므로 따로 설치합니다.
  • 예제 사이트: 아두이노 예제는 모두 arduino.iosignal.net에 있습니다(예전 test.iosignal.net과 arduino.remocon.kr을 합침). IOSignalConfig.h의 Wi-Fi 안내도 https://arduino.iosignal.net/wifi/를 가리킵니다. 웹 예제는 lab.iosignal.net에 있습니다.
  • 번호: 같은 시점의 iosignal(npm)과 같은 9.23.0입니다. 직전 IOSignal Arduino는 9.21.0이고, 9.22.0 번호는 없습니다.

IOSignal Arduino 9.21.0​

  • 응답 없는 연결을 다시 연결: 마지막으로 받은 뒤 50초(pingPeriod) 동안 아무것도 오지 않으면 PING을 보내고, 15초 안에 답이 없으면 연결을 닫고 다시 접속합니다. 공유기 재시작 등으로 연결이 살아 있는 것처럼 보이며 멈추던 문제를 막습니다.
  • 재접속을 기다리는 동안 loop()가 멈추지 않음: 전에는 io.loop() 안에서 3초를 delay()로 기다렸습니다. 이제 3초마다 한 번 접속을 시도하고 바로 돌아옵니다(접속 시도 한 번은 끝날 때까지 기다림).
  • Boho 1.1.0 이상 필요: 로그인 nonce를 ESP32·ESP8266은 하드웨어 난수에서 얻습니다. 서버와 프로토콜은 그대로입니다.
  • esp01_channel_txrx 예제를 뺐습니다. 9.15~9.20 번호의 IOSignal Arduino는 없습니다.

IOSignal Arduino 9.13.0~9.14.2​

JS 9.13.0·9.14.0과 같은 시기의 Arduino 라이브러리 변경입니다. 통신 API는 그대로입니다.

  • 보드 설정(ESP32·ESP8266, 9.13.0): IOSignalConfig.h를 쓰는 스케치는 USB로 연결한 브라우저에서 Wi-Fi, 서버, 장치 키와 스케치 설정 항목을 바꿉니다. Arduino 보드 설정
  • 익명 접속 선택(9.14.1): 보드 설정에서 "익명으로 접속"을 고르면 스케치에 장치 키가 있어도 익명으로 접속합니다.
  • UNO(AVR) RAM 절약(9.14.0): setLog() 문구와 redirect 주소 서식을 플래시에 둡니다.
  • 예제 이름(9.14.2): esp8266_channel_txrx → esp_channel_txrx(ESP8266·ESP32 공용), uno_r4_wifi_channel_receiver_txrx → uno_r4_wifi_channel_txrx. peer_ping_pong, esp32cam(Remocon으로 옮김), esp01_channel_txrx 예제를 뺐습니다.
  • Remocon Arduino 9.14.0~9.14.8, 장치 규칙 v2: 장치는 <cid>@$name(이름:분류)과 <cid>@$ui(버튼 목록 on,off 또는 t=switch4.1)로 자신을 알립니다. 9.12.0 예제의 장치 정보 형식은 remocon.kr, 안드로이드 앱, IOSignal Desktop이 더 이상 읽지 않으므로 그 예제를 올린 보드는 다시 설치합니다. 보드 설정 name에 $name을 이름:분류로 넣습니다. 버튼 제어기 예제(button-controller, iris-button-controller, esp01-button-controller)가 추가되었습니다. 버전별 상세는 remocon-arduino를 참고하세요.

9.14.0에서 추가된 기능​

iosignal(npm) 9.14.0만 나왔고 iosignal-cli, remocon, Arduino 라이브러리는 9.12.0 그대로입니다. 와이어 프로토콜과 클라이언트 API는 바뀌지 않았습니다.

  • 서버 대시보드: new Server({ dashboard })로 서버와 호스트의 상태를 실시간 그래프로 보여 주는 페이지(/dashboard)를 켭니다. 보는 권한은 공개, 토큰, IOSignal 로그인(역할·CID) 중에서 고릅니다. 기본은 꺼짐입니다. 서버 대시보드, 서버 API
  • 호스트 측정: host.report(), host.loop(), host.loopStats(), host.counters, host.activity(), host.journal(). 서버 API
  • port로 연 서버에서 대시보드를 켜면 서버가 HTTP 서버를 직접 만들어 같은 포트에서 페이지를 제공합니다. 대시보드를 켜지 않은 서버는 이전과 같습니다.
  • 확인 범위(2026-11-14): 공개 빌드 시험 293개(ESM·CJS, 대시보드 시험 포함), 실시간 게임 서버에 붙여 브라우저에서 모든 패널과 위조 차단 표시 확인(라이트·다크).

9.13.0에서 추가된 기능​

iosignal(npm) 9.13.0만 나왔고 iosignal-cli, remocon, Arduino 라이브러리는 9.12.0 그대로입니다. 와이어 프로토콜과 클라이언트 API는 바뀌지 않았습니다.

  • 서버 호스트 server.host(): 게임·퀴즈 같은 판정 로직을 서버 안에서 실행합니다. 입력마다 서버가 확인한 보낸 사람(from.cid)이 붙고, own 태그는 클라이언트가 보낼 수 없으며, 참가자 연결이 끊기면 leave가 옵니다. 서버 안의 게임 로직, 서버 API
  • server.stats()의 counters에 hostInbound, hostRejected, hostDenied가 추가되었습니다.
  • 호스트를 등록하지 않은 서버의 동작은 같습니다.
  • 확인 범위(2026-11-13~14): 공개 빌드 시험 277개(ESM·CJS), npm에서 받은 9.13.0으로 Node.js(WebSocket·TCP)와 브라우저 번들에서 입력·발신자·위조 차단·leave 확인, 호스트로 만든 게임 서버 부하 시험(관전 1,000개까지). 실제 휴대폰과 Arduino 보드의 버튼 입력은 확인하지 않았습니다.

9.12.0에서 바뀐 동작​

9.6.0 다음 공개 버전입니다(9.7.0~9.11.0은 공개하지 않았습니다). 9.6.0과 접속 호환이며 클라이언트 API는 바뀌지 않았습니다.

  • 익명 CID 문자: ? 다음 문자가 base64url에서 소문자 Crockford base32(0-9, a-z 중 i·l·o·u 제외)로 바뀌었습니다. 예: ?k3x9. 길이는 4자(겹침이 계속되면 8자) 그대로입니다. 익명 CID 형식을 검사하는 코드가 있다면 확인하세요.
  • remote.site: 브라우저 연결의 Origin 호스트 이름입니다(Node.js·앱·TCP 연결은 ''). 표시용이며 인증에 쓰지 않습니다.
  • nick: 로그인한 연결의 nick에 CID를 더 이상 복사하지 않습니다.
  • RedisKeyProvider: addAuth·delAuth가 사용 중인 장치 CID 집합(sets_cid)을 함께 관리합니다.
  • iosignal-cli, remocon 9.12.0: 접속할 때마다 iam()으로 연결 이름(iosignal-cli, remocon-cli)을 알립니다.
  • IOSignal Arduino 9.6.0~9.12.0: unsubscribe(tag)(빈 태그는 전체 해제)가 생겼고, 보내지 못한 쓰기가 있으면 연결을 닫아 loop()가 다시 접속합니다. 겹치는 예제(sender/receiver, esp32_channel_txrx, uno_ethernet_duplicate_login)를 지웠습니다.
  • Remocon Arduino 9.12.0: 타입 이름이 light.1, switch4.1처럼 <이름>.<major>가 되었습니다. 장치 정보 형식은 9.14.0에서 지금 규칙($name, $ui)으로 다시 바뀌었습니다. 타입 목록은 장치 타입에 있습니다.

9.6.0에서 바뀐 동작​

IOSignal JavaScript 9.6.0은 9.0.0과 접속 호환입니다. 클라이언트의 구독 순서와 호출 시점 검사가 바뀌었으므로 아래를 확인하세요.

  • listen()·link()로 저장한 구독은 CID를 받은 뒤 ready 이벤트 전에 전송됩니다. 이전에는 ready 핸들러 뒤에 전송되어, ready에서 바로 보낸 신호가 자신의 구독보다 앞설 수 있었습니다.
  • subscribe()는 연결이 ready가 아니면 Error를 던집니다(destroy() 뒤에는 무시). 연결 전에 등록하려면 listen()이나 link()를 씁니다.
  • ready 핸들러 안에서 listen()을 호출하면 Error입니다. 그 자리에서는 on()과 subscribe()를 씁니다.
  • link()는 ready인 연결에서만 바로 구독하고, 아니면 ready가 될 때 구독합니다.
  • 서버: 소유자가 있는 장치별 수신 정책, server.manager.setDeliveryPolicy(), 'delivery:denied' 이벤트, policyDenied 집계. 장치별 수신 정책
  • iosignal-cli 9.6.0: 대화형 클라이언트의 구독 명령은 ready 전에는 오류를 표시합니다.

9.0.0에서 바뀐 동작​

IOSignal JavaScript 9.0.0은 major 버전입니다. 연결의 역할(무엇을 할 수 있는지)과 쿼터 프로필(얼마나 보낼 수 있는지)을 나누고, 쿼터 레벨 표를 호환 계층 없이 없앴습니다. 옛 설정 이름을 쓰면 대신 쓸 이름을 알려주는 오류가 발생합니다. 같은 번호의 IOSignal Arduino 9.0.0은 접속할 때 수신 버퍼 크기를 서버에 알리고, 버퍼보다 큰 프레임은 연결을 끊지 않고 건너뜁니다(setRxBuffer()는 begin() 전에 호출). IOSignal Arduino 7.0.0도 그대로 접속합니다(새 QUOTA 메시지는 무시).

  • 키 항목은 레벨 대신 역할과 쿼터 이름을 씁니다: id.key.cid[.role[.quota]], 파일은 [id, key, cid, role, quota]. id.key.cid.255는 id.key.cid.admin, id.key.cid.3은 id.key.cid가 됩니다. 서버 인증 설정
  • 역할은 낮은 것부터 anonymous, device(로그인 기본값), service, admin입니다. sudo는 admin, RedisService(client, minRole)는 기본 service 이상이 필요합니다. 새 export: ROLES, hasRole(remote, role), defaultQuota.
  • 쿼터 프로필(quotas: maxMessageBytes, fanout, msgPerSec, bytesPerSec, maxConnections)은 서버가 항상 적용합니다. 8.x 기본 설정은 쿼터를 적용하지 않았으므로, 많은 메시지를 보내는 익명 클라이언트는 anonymousQuota나 프로필을 확인하세요. 서버 API
  • 클라이언트는 io.quota.maxMessageBytes로 크기 한도를 읽습니다. io.level, io.quota.signalSize는 없어졌습니다.
  • 모든 설정은 서버별이며 serverOption은 Server가 바꾸지 않는 기본값입니다. 이름 변경: timeout → heartbeatInterval, pingTimeoutGrace → heartbeatGrace, retain.isAvailable → retain.enabled, auth.delay_auth_fail → auth.failDelay. showMessage, showMetric, monitorPeriod 대신 logMessages, logStats, server.stats()를 씁니다.
  • 새 서버 옵션: maxPayload, maxBufferedBytes, trustProxy, 서버별 membersOnly·duplicateLogin, retain의 소유자별 저장 예산. 익명 연결이 남긴 retain은 연결이 끊긴 뒤 만료됩니다.
  • 수정: IOCongSocket이 IPv6 주소(cong://[::1]:port)에 접속하고, X-Forwarded-*는 신뢰하는 프록시에서만 믿으며, listen 오류는 프로세스를 끝내지 않고 'error'로 전달됩니다.
  • iosignal-cli 9.0.0: -t --heartbeat-interval, -m --log-stats <ms>, -s --log-messages, -q --anonymous-quota 옵션과 역할 형식의 --auth-param. CLI 서버

8.1.0에서 추가된 기능​

  • 서버 옵션 localAuth와 LocalKeyProvider: 키 목록 없이 로그인 ID를 CID로 쓰는 로컬 테스트 인증입니다. 로컬 테스트 로그인
  • iosignal-cli 8.1.0: io-server의 --id-key, --shared-key <key>, --members-only 옵션. iosignal 8.1.0 이상이 필요합니다.
  • CongSocket만 연 서버의 close()가 WebSocket 서버를 기다리지 않습니다.

8.0.0에서 바뀐 동작 (Arduino 7.0.0)​

IOSignal JavaScript 8.0.0과 IOSignal Arduino 7.0.0은 major 버전입니다. 7.x에서 올릴 때 아래 변경을 확인하세요.

  • 중복 로그인 기본값이 기존 연결 유지에서 **기존 연결 교체(keepNew)**로 바뀌었습니다. 이전 동작은 duplicateLogin: 'keepOld'로 지정합니다. 중복 로그인
  • sudo 서비스는 Boho 인증된 level 255 연결만, RedisService는 기본적으로 인증된 연결만 허용합니다. 인증 없는 실습 구성은 { requireAuth: false }를 명시합니다(9.0에서 역할 admin과 RedisService(client, minRole)로 바뀜).
  • 서버 확장: BohoAuth의 onAuthEvent, 서비스의 onRemoteClose(remote).
  • 익명 CID는 접속 중인 CID와 겹치지 않게 발급됩니다. 형식(? + 4자)은 같습니다(9.12.0에서 문자 집합이 바뀜).
  • IOSignal Arduino 7.0.0: AUTH_CLEAR 후 재접속하지 않고 멈추며 setLog로 사유를 출력할 수 있습니다. 6.x는 인증 정보를 지운 뒤 익명 연결로 다시 접속했습니다.

검증 범위​

2026-11-12, JavaScript 9.12.0을 기준으로 확인했습니다. 채팅 4종 브라우저 테스트는 이번에 실행하지 못해 9.6.0(2026-11-09) 결과를 따릅니다. 9.12.0은 클라이언트 API 변경이 없습니다.

대상결과
React·Svelte·Vanilla·CDN·WebRTC5개 프로덕션 빌드 통과
채팅 4종각각 두 클라이언트 양방향 송수신·재접속 통과
WebRTC로컬 브라우저 통합 테스트 5개 통과
문서 JS 예제한국어·영어의 서버·클라이언트·직접 토픽·구독 규약 검사
Arduino 실물·업로드이번 작업에서는 미검증
실제 카메라·마이크, Safari/iOS, 다른 인터넷망, TURN이번 작업에서는 미검증

채팅 테스트는 로컬 IOSignal 서버를 사용했습니다. WebRTC는 같은 컴퓨터의 Chrome과 가상 캡처 장치를 사용했습니다. 보드 확인 순서는 실물 확인 순서에 있습니다.