유챗 사용법
채팅방을 만들고, 설치하고, 운영하고, 기능을 더하는 방법을 모았어요.
시작하기
- 유챗으로 무엇을 만들 수 있나 →
내 사이트에 붙인 유챗 채팅방에 기능을 더하는 세 가지 방법과, 어떤 일에 어떤 방법을 고르면 되는지 설명해요.
- 5분 설치 →
채팅방을 만들고 설치 코드를 붙여 내 사이트에 채팅방을 띄워요. 프레임워크·CMS·채널 채팅방 설치와 안 뜰 때 점검할 것도 다뤄요.
- 첫 스크립트 →
페이지 스크립트로 채팅방 입장 이벤트를 받고, 안내 줄을 띄우고, 메시지를 보내 봐요.
가이드
- 회원 연동 →
내 사이트에 로그인한 회원의 닉네임·아이디·레벨·권한으로 채팅방에 들어오게 하는 흐름과, 접속이 안 될 때 확인할 것을 설명해요.
- 비동기 로딩과 여러 채팅방 →
uchat.js가 불러와지기 전에 이벤트를 거는 방법, 한 페이지의 여러 채팅방에 이벤트를 나눠 거는 방법, SPA에서 채팅방을 붙이고 정리하는 방법, 오른쪽 아래에 떠 있는 위젯을 붙이는 방법을 설명해요.
- 스킨 UI 확장하기 →
기본 스킨에 메뉴 버튼을 더하고, 대화상자로 입력을 받고, 대화 위에 영역을 붙이고, 해제 함수로 정리하는 흐름을 하나의 예제로 따라 해요.
- 실시간 데이터 주고받기 →
채널(room.plugin)로 같은 채팅방 사람들끼리 채팅 메시지가 아닌 데이터를 주고받고, 받은 데이터를 검증하는 흐름을 설명해요.
- 서버에서 채팅방으로 알림 보내기 →
내 서버에서 서버 API(v2)로 채팅방 채널에 데이터를 보내고, 페이지 스크립트나 플러그인이 서버가 보낸 것만 골라 표시하는 흐름을 설명해요.
- 보안 체크리스트 →
유챗을 붙인 사이트를 공개하기 전에 토큰, 회원 연동 서명, 채널 데이터, 서버 API, 화면 출력에서 확인할 항목을 정리해요.
레퍼런스
- u-chat 속성 →
채팅방을 넣는 u-chat 태그의 속성과 설치·제거 규칙이에요.
- U.chat()과 room 객체 →
페이지 스크립트의 진입점 U.chat()과 이벤트 콜백이 받는 room 객체의 값·함수 목록이에요.
- 이벤트 →
채팅방 이벤트의 이름, 받는 값, before에서 false를 돌려줄 때 실제로 막히는 것을 정리한 목록이에요.
- 스킨 UI API →
기본 스킨(basic-v2)에 메뉴·대화상자·영역·꾸미기를 더하는 room.skin API의 전체 목록이에요.
- 채널 API와 한도 →
room.plugin 채널로 실시간 데이터를 주고받는 함수, 값 형식, 저장과 전송 한도의 정본이에요.
- 서버 REST API →
내 서버에서 채팅방 상태를 읽고 플러그인 채널로 데이터를 보내는 REST API(v2)의 인증, 엔드포인트, 응답, 오류 코드와 예전 v1 방식이에요.
- 회원 연동 서명 규격 →
회원 연동 user_data 문자열의 필드, 서명(hash) 만드는 순서, 시간 연동 검사, 검증용 고정 값이에요.
- 레거시 스킨 API →
예전 채팅방이 쓰는 레거시 스킨(basic)의 room.skin API — jQuery DOM, 메뉴바, 팝업, 닉네임 메뉴 — 목록과 기본 스킨으로 옮기는 대응표예요.
예제
- 유튜브 함께 보기 →
부관리자 이상이 고른 유튜브 영상을 채팅방의 모든 사람이 함께 보는 예제예요.
- 가위바위보 →
닉네임 메뉴로 다른 사람에게 가위바위보를 신청하고, 양쪽이 보낸 값을 확인해 결과를 알리는 예제예요.
- 닉네임·메시지 꾸미기 →
기본 스킨에서 닉네임 색·이미지와 메시지 배경·줄 간격·닉네임 숨기기를 바꾸는 예제예요.
- 결제 완료 알림 →
내 서버에서 결제가 끝나면 서버 REST API(v2)로 채팅방에 알리고, 페이지 스크립트가 받아 채팅창에 표시하는 예제예요.
관리
- 관리 기능 한눈에 →
관리 페이지 메뉴와 채팅방 안에서 쓰는 관리 명령어를 개발자 관점에서 짧게 정리해요.