브라우저 시작하기
웹앱(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
- 웹 실습실: 서버에 연결해 아무 태그나 보내고 구독하며 로그를 봅니다.