React 向けに構築
React Chat SDK & UI Kit
Tencent RTC の React Chat SDK と UI Kit を使用して、1 対 1 およびグループメッセージングを構築します。連携した会話リスト、メッセージ、入力エリアを追加し、製品に合わせてカスタマイズできます。
開発者向けリソース
React Chat SDK のドキュメントとサンプル
React コミュニティチャット
構築コミュニティチャット React Chat SDKで、ダイレクトメッセージ、グループ会話、メディア共有を実現します。
REACT チャット機能
React Chat SDK の機能
メッセージ操作からカスタムコンテンツまで、アプリケーションに必要な機能を選択できます。
1 対 1 とグループチャット
- 1対1およびグループでの会話
- 最近のメッセージのプレビュー
- 未読の会話数
リッチメッセージタイプ
- テキスト、画像、音声、動画
- 会話内でのファイル共有
- カスタムの商品または注文ペイロード
メッセージコントロール
- コピー、引用、転送
- メッセージの取り消しと削除
- 送信者ごとのグループ化と配置
柔軟な構成
- 画像、動画、ファイルの選択ツール
- 設定可能な入力操作
- 独自のプレースホルダーとツールバー
あなたの製品、あなたの UI
- ライトテーマとダークテーマ
- カスタム会話プレビュー
- 英語、中国語、日本語、韓国語
必要に応じて拡張
- 既読通知:有効化と設定
- Cloud Search:有料プラグイン
- 音声とビデオ:TUICallKitを追加
React Chat Components を詳しく見る
会話リストからメッセージ入力欄まで、インターフェースを確認できます。
製品に合った受信トレイ
最近のメッセージと未読件数を表示します。プレビューコンポーネントを置き換えることで、各会話の表示方法を変更できます。
ConversationList API<ConversationList
style={{ width: 300, height: '100%' }}
enableSearch={false}
/>メッセージの動作を選択
メッセージの配置を制御し、連続するメッセージをグループ化して、各メッセージで利用できる操作を選択します。
MessageList APIconst actions = useMessageActions([
'copy', 'quote', 'forward',
]);
<MessageList
alignment="two-sided"
messageAggregationTime={300}
messageActionList={actions}
/>必要なメッセージ作成ツールを構築
画像、ファイル、動画の選択ツールを選びます。プレースホルダーを設定し、送信ボタンを表示するかどうかを決めます。
MessageInput API<MessageInput
placeholder="Message your community"
autoFocus={false}
hideSendButton={false}
actions={[
'ImagePicker', 'FilePicker', 'VideoPicker',
]}
/>便利な操作を手の届く場所に配置
会話タイトルの横に設定コントロールを追加し、独自のパネルまたはナビゲーションに接続します。
ヘッダー統合ガイドconst [showSettings, setShowSettings] = useState(false);
<ChatHeader
ChatHeaderRight={
<button onClick={() => setShowSettings(true)}>
Settings
</button>
}
/>人と会話をつなぐ
連絡先リストとプロフィール情報を組み合わせます。ユーザーがメッセージを開始したら、会話ビューに戻します。
連絡先統合ガイド<ContactList />
<ContactInfo
onSendMessage={() => setActiveTab('conversations')}
onEnterGroup={() => setActiveTab('conversations')}
/>会話設定用のスペースを確保
設定コンポーネントをサイドバーまたはドロワーに配置します。パネルを開閉するタイミングはアプリケーション側で制御します。
統合セットアップガイド{showSettings && (
<aside className="chat-settings">
<ChatSetting
onClose={() => setShowSettings(false)}
/>
</aside>
)}カスタマイズ
React チャット UI をカスタマイズ
React Chat SDK の統合と独自コンテンツに合わせて UI Kit のスタイルをカスタマイズします。
始める
React Chat SDK を統合
- 01
- 02
- 03
npm install @tencentcloud/chat-uikit-react<UIKitProvider theme="light">
<ConversationList />
<Chat>
<ChatHeader />
<MessageList />
<MessageInput />
</Chat>
</UIKitProvider>CHAT + CALL
通話が必要な会話もあります
TUICallKit と React チャットヘッダーを使用して音声とビデオを連携させます。
通話には TUICallKit の統合と Call サービスの有効化が必要です。Call の料金は Chat とは別にご確認ください。
React Chat SDKのよくある質問
React Chat SDK と React UI Kit の違いは何ですか?
React Chat SDK は JavaScript SDK を通じてメッセージング機能を提供します。React UI Kit には、チャットインターフェース向けの既製コンポーネントが用意されています。UI Kit で接続済みコンポーネントから始めることも、基盤となる SDK を使って独自のインターフェースを構築することもできます。
コンポーネントとメッセージレイアウトをカスタマイズできますか?
はい。ドキュメントに記載された props と拡張ポイントを使用して、コンポーネントの動作設定、会話プレビューの調整、カスタムメッセージのレンダリングが可能です。変更できる内容はコンポーネントによって異なるため、置き換えを計画する前に API を確認してください。
React Web、モバイル Web、React Native にはどの UI Kit を使用すればよいですか?
ブラウザアプリケーションには React UI Kit を使用してください。モバイル Web(H5)ガイドでは、React パッケージの ConversationListH5 や MessageListH5 などのコンポーネントを使用します。React Native で構築するネイティブ iOS および Android アプリケーションには、別途提供される React Native UI Kit とそのネイティブ設定ガイドを使用してください。
React Chat SDK を Next.js または SSR と統合するにはどうすればよいですか?
ブラウザ向けのインタラクティブなチャット画面を設計します。Next.js App Router では、ブラウザに依存するコードを Client Component に分離してください。Next.js は ssr: false によるクライアント専用の動的読み込みをサポートしています。UserSig はサーバーで生成します。インストール済みの UI Kit のバージョンと依存関係を確認し、リリース前に本番ビルド、ログイン、ナビゲーションをテストしてください。
オープンソースの React UI Kit とホスト型 Chat サービスにはどのような関係がありますか?
React UI Kit のソースコードは GitHub で公開されています。接続型メッセージングコンポーネントは Tencent RTC Chat を使用するため、Chat アプリケーションと認証済みユーザーが必要です。コンポーネントのソースコードが利用できても、ホスト型メッセージングを無制限に利用できるわけではありません。サービス利用量と機能へのアクセスは Chat プランに従います。ローカル UI プレビューはライブ接続なしでも実行できます。
React Chat SDK は無料で始められますか?
Tencent RTC Chatには、月間アクティブユーザー1,000人まで利用できる無料プランがあります。必要な機能と使用量に応じて、プランの詳細と料金をご確認ください。
React UI Kit には音声通話とビデオ通話が含まれていますか?
TUICallKit を統合して Call サービスを有効にすると、通話機能を追加できます。現在の完全な React 統合サンプルにはこの拡張機能が含まれていますが、通話の設定と料金はメッセージングとは別です。
無料プランに Cloud Search は含まれていますか?
Cloud Search は、Cloud Search プラグインを必要とする付加価値機能です。チャットインターフェースで検索を有効にする前に、要件を確認してください。
React で React Chat SDK を導入するには?
ドキュメントに記載された provider を初期化し、接続済みコンポーネントを組み合わせます。購読とクリーンアップを React のライフサイクルに合わせ、実際のアプリでナビゲーションと繰り返しマウントをテストします。
アプリのリリース前に React Chat SDK をテストするには?
ログイン、SDK の準備完了、送受信イベント、再接続後のメッセージ状態を確認します。
React Chat SDK のインターフェースをカスタマイズするには?
チャットコンポーネントを UIKitProvider で囲み、theme="light" または theme="dark" を設定します。子コンポーネントは useUIKit().setTheme で表示を切り替えられますが、この hook は provider のコンテキスト内で呼び出す必要があります。商品カードには、MessageList.messageRenderers からカスタムメッセージレンダラーを渡します。認識できないペイロードにはフォールバック表示を用意してください。商品検索と購入手続きは Chat の機能として扱わず、アプリケーション側で実装します。

