빠르게 연결하고, 유연하게 확장하세요. SDK & API
Quick Start
초기화부터 첫 메시지까지, 한 흐름으로
모든 SDK가 같은 흐름을 따릅니다. 초기화 → 접속 → 채널 구독 → 메시지 전송. 아래 코드를 그대로 옮기면 첫 메시지가 도착합니다.
npm install ncloudchat 한 줄로 설치하세요. TypeScript 타입 정의가 함께 제공됩니다.
quickstart.js
// npm install ncloudchat
import { Chat } from "ncloudchat";
// 1. 프로젝트 ID로 초기화
const nc = new Chat();
nc.initialize("YOUR_PROJECT_ID");
// 2. 사용자로 접속
await nc.connect({ id: "user-001", name: "Aria" });
// 3. 채널을 만들고 구독
const channel = await nc.createChannel({
type: "PUBLIC",
name: "general",
});
await nc.subscribe(channel.id);
// 4. 메시지 수신 이벤트 바인딩
nc.bind("onMessageReceived", (channelId, message) => {
console.log(channelId, message);
});
// 5. 첫 메시지 전송
await nc.sendMessage(channel.id, {
type: "text",
message: "안녕하세요, sendstage!",
});
Android(Kotlin)·Unity SDK도 같은 흐름(초기화 → 접속 → 구독 → 전송)으로 제공됩니다.
시작하기
3단계면 충분합니다
복잡한 인프라 설정 없이, 프로젝트 생성에서 첫 메시지까지.
- 1dash.ncloudchat.com에서 무료로 가입하고 프로젝트를 만들면 프로젝트 ID가 발급됩니다.
- 2SDK를 설치하고 프로젝트 ID로 초기화한 뒤, 사용자 ID로 접속하세요.
- 3채널을 만들고 구독한 다음 첫 메시지를 보내세요. 대시보드에서 바로 확인할 수 있습니다.
개발 경험
개발자를 위해 설계된 SDK
타입, 이벤트, 재연결까지 — 채팅 개발에서 번거로운 부분을 SDK가 대신합니다.
TypeScript 타입 제공
ncloudchat 패키지에 타입 정의가 내장되어 자동완성과 타입 체크를 바로 사용할 수 있습니다.
이벤트 기반 아키텍처
onMessageReceived, onMemberJoined 등 이벤트 바인딩으로 메시지 수신과 입장·퇴장·차단을 실시간으로 처리합니다.
자동 재연결
네트워크가 끊겨도 소켓이 자동으로 재연결을 시도하고, 재연결 이벤트로 연결 상태를 추적할 수 있습니다.
REST API
클라이언트 SDK 없이도 서버에서 메시지 전송, 채널·사용자 관리를 API 호출로 처리할 수 있습니다.
지원 환경
어디서든 같은 채팅
웹 브라우저부터 모바일 앱, 게임 엔진까지 하나의 백엔드로 연결됩니다.
JavaScript
- Chrome 16+ · Edge 13+ · Safari 7+
- Firefox 11+ · Opera 12.1+
- iOS Safari 7+ · Android 브라우저 4.4+
iOS
- iOS 13.0 이상
- Swift 5 이상 · Xcode 13 이상
- Swift Package Manager 설치 지원
Android
- Android 앱(Kotlin)용 SDK 제공
- UI Kit과 함께 사용할 수 있습니다
Unity
- Unity 게임 클라이언트용 SDK 제공
- 게임 채팅에는 Express Message 고속 경로를 함께 쓸 수 있습니다