좋아요 카운터

VChatCloud의 좋아요 카운터 기능을 사용하면 채팅방에 대한 좋아요 수를 표시하고 관리할 수 있습니다. 이 문서는 좋아요 카운터 기능의 구현 방법과 활용 방안을 설명합니다.

기능 개요

좋아요 카운터는 다음과 같은 핵심 기능을 제공합니다.

• 채팅방의 현재 좋아요 수 조회
• 사용자의 좋아요 액션 처리
• 사용자 정의 이벤트 핸들링

구현 방법

1. 사전 준비

좋아요 카운터 기능은 별도의 API 키나 CMS 설정 없이 바로 사용할 수 있습니다. 먼저 Overview 페이지의 기본 설정 과정을 완료하세요.

2. 좋아요 카운터 초기화

script.js 파일에서 LikeCounter 인스턴스를 생성하고 설정합니다.

// e7lib에서 LikeCounter 불러오기
const { LikeCounter } = e7lib;

// 채팅방 연결 후 좋아요 카운터 초기화
const likeCounter = new LikeCounter({
  roomId: channelKey, // 채팅방 고유 ID
  likeButton: "#sendLike", // 좋아요 버튼 선택자
  likeCount: "#likeCounter", // 카운터 표시 요소 선택자
  likeEvent: function (result) {
    // 좋아요 클릭 이벤트 핸들러
    if (result) {
      console.log("좋아요가 성공적으로 등록되었습니다!");
      // 추가 작업 수행 (애니메이션, 사운드 등)
    } else {
      console.log("좋아요 등록에 실패했습니다.");
    }
  },
});

API 레퍼런스

LikeCounter 생성자 옵션

매개변수	타입	필수 여부	설명
roomId	String	✅	채팅방 고유 식별자 (채널 키)
likeButton	String	✅	좋아요 버튼 CSS 선택자 (ID 또는 클래스)
likeCount	String	✅	좋아요 카운터 표시 영역 CSS 선택자
likeEvent	Function		좋아요 이벤트 발생 시 호출될 콜백 함수

likeEvent 콜백 함수

likeEvent 콜백 함수는 좋아요 액션이 처리된 후 호출되며, 다음과 같은 파라미터를 받습니다.

매개변수	타입	설명
result	Boolean	좋아요 처리 성공 여부 (true: 성공, false: 실패)