본문으로 건너뛰기

브라우저 시작하기

웹앱(Vanilla JavaScript, React, Svelte 등)에서 IOSignal 서버에 연결해 채팅, 장치 제어 화면, 화상통화 시그널링, 게임 화면을 만듭니다. 처음이라면 핵심 개념 5분 요약을 먼저 읽으세요. 태그, 전달 방식, 홈채널은 모든 환경에서 같습니다.

1. 설치​

환경방법문서
Vite, React, Svelte 등 번들러npm install iosignal 후 import IO from 'iosignal/browser/esm/io.js'번들러에서 사용
HTML과 CDN<script>로 iosignal@9의 ESM 또는 IIFE 빌드HTML과 CDN에서 사용

2. 첫 연결​

아래 HTML 하나로 공개 서버에 연결할 수 있습니다. 두 탭에서 열고 한쪽 콘솔에서 io.signal('room#chat', 'hi')를 실행해 보세요.

<script type="module">
import IO from 'https://cdn.jsdelivr.net/npm/iosignal@9/dist/browser/esm/io.js';

const io = new IO('wss://io.iosignal.net/ws');
window.io = io;
io.listen('room#chat', (tag, message) => console.log(tag, message));
io.on('ready', () => console.log('CID:', io.cid));
</script>

3. 브라우저에서 다른 점​

  • 가져오기 경로: 브라우저는 import IO from 'iosignal/browser/esm/io.js'(default export)를 씁니다. import { IO } from 'iosignal'은 Node.js용이라 번들에 넣지 않습니다.
  • HTTPS 페이지는 wss://: HTTPS로 서비스하는 페이지에서 ws:// 서버에 연결하면 브라우저가 막을 수 있습니다. 로컬 개발은 http://localhost 페이지에서 ws://localhost:7777을 씁니다. 연결 환경
  • 컴포넌트 수명주기: 컴포넌트가 사라질 때 io.destroy()로 정리합니다. 여러 컴포넌트가 인스턴스 하나를 함께 쓰면 link()로 등록하고 unlinkAll(컴포넌트)로 그 컴포넌트 것만 해제합니다. JS 구독과 수명주기
  • 구독 시점: 고정 태그는 연결 전에 listen()으로, 실행 중에 바뀌는 태그는 ready 핸들러에서 subscribe()로 등록합니다. 재접속하면 ready가 다시 옵니다.
  • 홈채널 범위: 브라우저도 접속한 공인 IP로 홈채널이 정해집니다. 같은 공유기의 장치를 #search로 찾을 수 있지만 보안 경계는 아닙니다. 홈채널

4. 만들기 가이드​

만들고 싶은 것문서와 예제
채팅React, Svelte, Vanilla 채팅 예제
화상통화(WebRTC 시그널링)WebRTC 예제, lab.iosignal.net/webrtc
장치를 찾고 제어하는 화면장치 만들기 (app.iosignal.net 호환)의 검색·제어 규칙, remocon.kr
실시간 게임·퀴즈 화면게임 시작하기
메서드와 이벤트 찾기클라이언트 API

5. 예제​

  • iosignal-examples: React·Svelte·Vanilla·CDN 채팅, 채널 협상 채팅, WebRTC, Host Quiz
  • 웹 실습실: 서버에 연결해 아무 태그나 보내고 구독하며 로그를 봅니다.

6. 막혔을 때​