React 向けに構築

React Chat SDK & UI Kit

Tencent RTC の React Chat SDK と UI Kit を使用して、1 対 1 およびグループメッセージングを構築します。連携した会話リスト、メッセージ、入力エリアを追加し、製品に合わせてカスタマイズできます。

開発者向けリソース

React Chat SDK のドキュメントとサンプル

REACT チャット機能

React Chat SDK の機能

メッセージ操作からカスタムコンテンツまで、アプリケーションに必要な機能を選択できます。

柔軟な構成

  • 画像、動画、ファイルの選択ツール
  • 設定可能な入力操作
  • 独自のプレースホルダーとツールバー

必要に応じて拡張

  • 既読通知:有効化と設定
  • Cloud Search:有料プラグイン
  • 音声とビデオ:TUICallKitを追加

React Chat Components を詳しく見る

会話リストからメッセージ入力欄まで、インターフェースを確認できます。

会話リスト

製品に合った受信トレイ

最近のメッセージと未読件数を表示します。プレビューコンポーネントを置き換えることで、各会話の表示方法を変更できます。

ConversationList API
App.tsx
<ConversationList
  style={{ width: 300, height: '100%' }}
  enableSearch={false}
/>

カスタマイズ

React チャット UI をカスタマイズ

React Chat SDK の統合と独自コンテンツに合わせて UI Kit のスタイルをカスタマイズします。

テーマ

provider でテーマを設定します。ライト表示とダーク表示を切り替えても、会話フローは同じまま維持します。

テーマ統合ガイド

始める

React Chat SDK を統合

  1. 01

    アプリを作成

    React Chat SDK を統合するための Chat アプリケーションを作成します。

    Chat コンソールを開く
  2. 02

    React UI Kitを追加

    パッケージをインストール。ニーズに合わせてコンポーネントをカスタマイズ。

    Reactチュートリアルを進める
  3. 03

    最初のメッセージを送信

    React Chat SDK の 2 つのユーザーアカウントにサインインし、テストメッセージを送信します。

    ユーザーをつなぐ
React Chat UI Kit
ターミナル
npm install @tencentcloud/chat-uikit-react
UI composition
<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 の機能として扱わず、アプリケーション側で実装します。

次のステップに適したサポートを見つける

技術的な質問

React Chat SDK のサンプルを確認するか、再現可能な問題を報告してください。

GitHub Issues を見る

製品と料金に関するご質問

アプリケーション、想定利用量、統合要件について、担当チームにご相談ください。

営業担当者への連絡

次の会話はここから始まります

React Chat SDK と UI Kit で構築。月間アクティブユーザー 1,000 人まで無料で始められます。