
言語 🇯🇵 日本語
ドキュメント
はじめに
使用方法
Add Comment Widgets to Your React Native App
これは FastComments の公式 React Native ライブラリです。
リアルタイムのコメント、チャット、レビューウィジェットを React Native アプリに埋め込みます。
リポジトリ
ライブショーケース 
パブリックな demo テナントに対してローカルで実行されているすべてのウィジェットとフローを確認するには、リポジトリをクローンして次を実行してください:
yarn bootstrap
cd example
yarn ios # or: yarn android, yarn web
ショーケースのエントリーポイントは example/src/ShowcaseApp.tsx です — すべてのウィジェット、テーマ、およびフローを公開する単一のアプリです。
yarn web ターゲットは react-native-web + react-native-web-webview を使用します(WebView を iframe としてレンダリングします)。ブラウザでの簡易的な視覚スモークテストに便利ですが、injectJavaScript や onShouldStartLoadWithRequest のようなネイティブ専用の WebView API はウェブ上では完全には機能しません。
ネイティブ SDK を検討する 
このライブラリは、VanillaJS ライブラリをラップする webview を使用しています。
FastComments は現在、fastcomments-react-native-sdk の一部としてクライアントの完全なネイティブ実装をサポートしています。 完全にネイティブな実装を希望する場合は、そちらをご覧ください。
使用方法 - ライブコメントウィジェット 
The APIはfastcomments-reactと比べて若干異なります。ネイティブでは、次の構造に従う設定オブジェクトを渡します: this structure。
import { FastCommentsCommentWidget } 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, setConfig] = useState({
tenantId: myTenantId,
urlId: myAppPageId,
url: myAppPageUrl,
pageTitle: myAppPageTitle
});
// by calling setConfig(), we can do things like change the current page, or the currently logged in user
// 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 requires react-native-webview. As such, you should follow the installation steps for react-native-webview.
アカウントのリージョン(注意: EU のお客様)
アカウントが EU にある場合、ウィジェットの設定で region = 'eu' を設定してください。
それ以外の場合は region を定義する必要はありません。
メンテナンス状況 
これらのコンポーネントは、コアの VanillaJS コンポーネントのラッパーです。これらのコンポーネントはこのライブラリを公開しなくても自動的に更新(バグ修正や機能追加)できます。したがって、しばらく公開されない場合があっても、FastComments が積極的に開発されていないというわけではありません!更新情報は 当社のブログ をご覧ください。破壊的な API の変更や新機能が、このライブラリのバージョンを上げずに基礎のコアライブラリに反映されることは決してありません。
ヘルプが必要ですか?
React Native ライブラリで問題が発生したり質問がある場合は、次のいずれかを行ってください:
貢献
貢献は歓迎します!貢献ガイドラインについてはGitHubリポジトリをご覧ください。