
언어 🇰🇷 한국어
문서
시작하기
사용법
React Native 앱에 댓글 위젯 추가
이것은 FastComments의 공식 React Native 라이브러리입니다.
React Native 앱에 실시간 댓글, 채팅 및 리뷰 위젯을 임베드하세요.
저장소
라이브 쇼케이스 
공용 demo 테넌트에 대해 로컬에서 실행되는 모든 위젯과 플로우를 보려면, 저장소를 클론하고 다음을 실행하세요:
yarn bootstrap
cd example
yarn ios # 또는: yarn android, yarn web
The showcase entry point is example/src/ShowcaseApp.tsx — a single app that exposes all widgets, themes, and flows.
The yarn web target uses react-native-web + react-native-web-webview (which renders the WebView as an iframe). Useful for quick visual smoke tests in a browser; native-only WebView APIs like injectJavaScript and onShouldStartLoadWithRequest won't fully behave on web.
네이티브 SDK 고려하기 
이 라이브러리는 VanillaJS 라이브러리를 감싸는 웹뷰를 사용합니다.
FastComments는 이제 fastcomments-react-native-sdk의 일부로 클라이언트의 완전한 네이티브 구현을 지원합니다. 완전한 네이티브 구현을 원한다면 그곳을 확인해 보세요.
사용법 - 라이브 댓글 위젯 
API는 fastcomments-react에 비해 약간 다릅니다. 네이티브에서는 이 구조를 따르는 config 객체를 전달합니다.
import { FastCommentsCommentWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // 귀하의 tenant id입니다. https://fastcomments.com/auth/my-account/api-secret 에서 가져올 수 있습니다
const myAppPageId = 'native-test'; // 앱 내 댓글 스레드의 ID 또는 URL입니다.
const myAppPageUrl = 'https://example.com/external-page'; // 외부 페이지의 url을 선택적으로 설정할 수 있습니다
const myAppPageTitle = 'Example Title'; // ... 그리고 아마 이 콘텐츠에 대한 제목을 원할 것입니다
const [config, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// setConfig()를 호출하면 현재 페이지를 변경하거나 현재 로그인한 사용자를 변경하는 등의 작업을 할 수 있습니다
// 자세한 내용은 example/src/App.tsx를 참조하세요
return (
<FastCommentsCommentWidget config={config}/>
);
사용법 - 라이브 채팅 위젯 
import { FastCommentsLiveChatWidget } from 'fastcomments-react-native';
// ...
const myTenantId = 'demo'; // 귀하의 테넌트 ID입니다. https://fastcomments.com/auth/my-account/api-secret에서 가져올 수 있습니다
const myAppPageId = 'native-test'; // 앱 내 댓글 스레드의 ID 또는 URL입니다.
const myAppPageUrl = 'https://example.com/external-page'; // 외부 페이지의 URL을 선택적으로 설정할 수 있습니다.
const myAppPageTitle = 'Example Title'; // 그리고 아마도 이 콘텐츠의 제목을 지정하고 싶을 것입니다.
const config = {
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
};
return (
<FastCommentsLiveChatWidget config={config}/>
);
사용법 - SSO(싱글 사인온) 
FastComments는 보안 SSO에 HMAC을 사용합니다. 사용하려면, 백엔드에서 SSO 객체(sso 구성 속성)를 생성하고 이를
댓글 위젯에 전달하세요.
다양한 백엔드 예제는 다음에서 확인할 수 있습니다: https://github.com/FastComments/fastcomments-code-examples/tree/master/sso
피어 의존성 
fastcomments-react-native는 react-native-webview를 필요로 합니다. 따라서 react-native-webview의 설치 절차를 따라야 합니다.
계정 지역 (주의: EU 고객)
계정이 EU에 있는 경우 위젯 구성에서 region = 'eu'로 설정하세요. 그렇지 않으면 region을 정의할 필요가 없습니다.
유지보수 상태 
이 컴포넌트들은 우리의 핵심 VanillaJS 컴포넌트를 감싸는 래퍼입니다. 이 컴포넌트들은 이 라이브러리를 배포하지 않고도 자동으로 업데이트(버그 수정, 기능 추가)할 수 있으므로, 이 라이브러리가 당분간 공개되지 않을 수 있다고 해서 FastComments가 활발히 개발되고 있지 않다는 뜻은 아닙니다! 업데이트는 우리 블로그에서 확인하세요. 중대한 API 변경이나 기능은 이 라이브러리의 버전이 올려지지 않는 한 기반이 되는 코어 라이브러리에는 절대 반영되지 않습니다.
도움이 필요하신가요?
React Native 라이브러리에서 문제가 발생하거나 질문이 있는 경우, 다음을 이용해 주세요:
기여하기
기여를 환영합니다! 기여 가이드는 GitHub 저장소를 방문해 주세요.