연결과 CID 수명주기
브라우저, Node.js, Arduino, CLI 모두 같은 흐름으로 서버에 연결합니다. 이 페이지는 그 공통 흐름을 다룹니다. JavaScript의 listen·subscribe·link 사용법은 JS 클라이언트: 구독과 컴포넌트 수명주기에 있습니다.
연결 흐름
- ready: 서버가 CID를 발급해 송수신할 수 있게 된 순간입니다. 소켓이 열린 것과 다릅니다. 신호는 ready 뒤에 보냅니다.
- ready는 연결마다 옵니다. 끊겼다가 다시 연결되면 ready가 다시 옵니다. 처음 한 번만 하는 일과 연결마다 하는 일을 나눠 두세요.
다시 연결되면
| 무엇 | 어떻게 되나 |
|---|---|
| CID | 익명 연결은 바뀔 수 있습니다. 장치 키로 로그인한 연결은 등록된 CID 그대로입니다. |
| 구독 | 서버는 끊긴 연결의 구독을 잊습니다. 연결마다 다시 구독해야 합니다. |
보관 값($) | 다시 구독하면 서버가 보관한 마지막 값이 바로 다시 옵니다. |
| 다른 쪽에서 보이는 것 | 연결이 끊긴 CID를 구독하던 쪽은 <cid>@$state로 close를 받습니다. 그 CID는 나중에 다른 클라이언트에게 다시 발급될 수 있습니다. |
익명 CID를 오래 저장해 두고 보내면 엉뚱한 상대가 받을 수 있습니다. 상대가 다시 연결했을 수 있으면 #search 같은 절차로 다시 찾습니다. 고정된 상대가 필요하면 장치 키로 로그인한 CID를 씁니다.
리디렉션과 응답 제한
- 리디렉션: 공개 서버는 처음 연결이나 로그인을 다른 서버로 안내할 수 있습니다. ready 전의 정상적인 과정이며, ready 뒤의 끊김과 다릅니다.
- 응답 제한: 연결을 시작한 뒤 서버의 첫 응답이 없으면 클라이언트가 연결을 닫고 처음 주소로 다시 시작합니다. JavaScript는 15초(9.19.0부터), Arduino는 10초입니다.
인증 해제
같은 장치 키로 다른 곳에서 로그인해 이 연결이 교체되면, 서버가 인증 해제를 보냅니다. 클라이언트는 다시 연결하지 않고 멈춥니다. 같은 키로 두 기기를 동시에 쓰지 않도록 장치마다 키를 따로 발급합니다. 같은 ID 중복 로그인
환경별로 구독을 다시 보내는 곳
| 환경 | 연결마다 하는 일 | 끝낼 때 |
|---|---|---|
| 브라우저·Node.js | listen()·link()로 등록한 태그는 라이브러리가 자동으로 다시 구독합니다. subscribe()는 ready 핸들러에서 매번 부릅니다. | stop()(재연결 끄기), destroy() |
| Arduino | 연결될 때마다 불리는 onReady 콜백에서 구독하고 첫 상태를 보냅니다. | — |
CLI io-client | 구독 명령으로 만든 구독은 재접속하면 복원됩니다. | exit |
- JavaScript: JS 클라이언트: 구독과 컴포넌트 수명주기
- Arduino: Arduino 시작하기
- CLI: CLI 클라이언트