본문으로 건너뛰기

연결과 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.jslisten()·link()로 등록한 태그는 라이브러리가 자동으로 다시 구독합니다. subscribe()는 ready 핸들러에서 매번 부릅니다.stop()(재연결 끄기), destroy()
Arduino연결될 때마다 불리는 onReady 콜백에서 구독하고 첫 상태를 보냅니다.—
CLI io-client구독 명령으로 만든 구독은 재접속하면 복원됩니다.exit