버전과 검증 기준
이 사이트의 JavaScript 문서는 IOSignal 9.x를 기준으로 합니다. 문서 기준 버전은 이 페이지에서만 안내하며, 각 가이드에는 버전 차이가 있는 동작에만 "8.0.0부터"처럼 버전을 적습니다.
- 설치: 가이드의 설치 명령은
npm install iosignal입니다. 설치 시점의 최신 버전이package.json에^9.x범위로 기록되고, 잠금 파일이 실제 설치 버전을 고정합니다. 새 메이저 버전이 나오면 이 페이지에서 먼저 안내합니다. - CDN: 잠금 파일이 없으므로 URL에 메이저 버전을 고정합니다(
iosignal@9). 그래야 새 메이저 버전이 나와도 기존 페이지가 깨지지 않습니다.
| 구성 | 기준 | 확인 범위 |
|---|---|---|
| IOSignal JavaScript | 9.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, remocon | 9.x (9.19.0) | 2026-11-18: 두 CLI를 한 저장소에서 함께 릴리스, 패키지 시험(iosignal-cli 25개, remocon 14개). 내장 서버는 IOSignal 9.19.0. 8.x CLI와 옵션이 다르므로 io-server --version으로 확인하세요 |
| IOSignal Arduino | 9.23.1 | 2026-11-21: 예제 34개를 대상 보드별로 컴파일(개발 원본), 공개 저장소에서 보드별 대표 10개와 예전 remocon:: 이름을 쓰는 스케치 컴파일. 예제는 실물로 다시 돌리지 않음. 변경은 9.23.1, 9.23.0, 9.21.0 |
| Remocon Arduino | 9.22.0 (마지막) | 장치 예제가 든 마지막 버전이고 더 고치지 않습니다. 9.23.0부터 예제는 IOSignal Arduino에 있습니다. 예제별 실물 확인 여부는 arduino.iosignal.net 예제 페이지에 있습니다 |
| Boho | JS 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·WebRTC | 5개 프로덕션 빌드 통과 |
| 채팅 4종 | 각각 두 클라이언트 양방향 송수신·재접속 통과 |
| WebRTC | 로컬 브라우저 통합 테스트 5개 통과 |
| 문서 JS 예제 | 한국어·영어의 서버·클라이언트·직접 토픽·구독 규약 검사 |
| Arduino 실물·업로드 | 이번 작업에서는 미검증 |
| 실제 카메라·마이크, Safari/iOS, 다른 인터넷망, TURN | 이번 작업에서는 미검증 |
채팅 테스트는 로컬 IOSignal 서버를 사용했습니다. WebRTC는 같은 컴퓨터의 Chrome과 가상 캡처 장치를 사용했습니다. 보드 확인 순서는 실물 확인 순서에 있습니다.