ĐƯỢC XÂY DỰNG CHO React

React Chat SDK & UI Kit

Xây dựng tính năng nhắn tin trực tiếp và theo nhóm bằng React Chat SDK cùng UI Kit của Tencent RTC. Thêm danh sách cuộc trò chuyện, tin nhắn và trình soạn thảo được kết nối, sau đó tùy chỉnh cho sản phẩm của bạn.

TÀI NGUYÊN DÀNH CHO NHÀ PHÁT TRIỂN

Tài liệu và ví dụ về React Chat SDK

KHẢ NĂNG TRÒ CHUYỆN REACT

Các tính năng của React Chat SDK

Từ thao tác tin nhắn đến nội dung tùy chỉnh, hãy chọn những tính năng ứng dụng của bạn cần.

Các loại tin nhắn phong phú

  • Văn bản, hình ảnh, âm thanh và video
  • Chia sẻ tệp trong cuộc trò chuyện
  • Payload tùy chỉnh cho sản phẩm hoặc đơn hàng

Bố cục linh hoạt

  • Trình chọn hình ảnh, video và tệp
  • Thao tác nhập có thể cấu hình
  • Placeholder và thanh công cụ riêng của bạn

Mở rộng khi cần

  • Thông báo đã đọc: bật và cấu hình
  • Cloud Search: plugin trả phí
  • Thoại và video: thêm TUICallKit

Khám phá React Chat Components

Khám phá giao diện, từ danh sách cuộc trò chuyện đến trình soạn tin nhắn.

Danh sách cuộc trò chuyện

Hộp thư đến phù hợp với sản phẩm của bạn

Hiển thị tin nhắn gần đây và số lượng chưa đọc. Thay thế thành phần xem trước để thay đổi cách hiển thị từng cuộc trò chuyện.

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

TÙY CHỈNH

Tùy chỉnh UI trò chuyện React

Điều chỉnh kiểu dáng của UI Kit cho phù hợp với tích hợp React Chat SDK và nội dung của riêng bạn.

Chủ đề

Thiết lập giao diện tại provider. Giữ nguyên một luồng trò chuyện khi chuyển đổi giữa chế độ sáng và tối.

Hướng dẫn tích hợp chủ đề

BẮT ĐẦU

Tích hợp React Chat SDK

  1. 01

    Tạo ứng dụng của bạn

    Tạo ứng dụng Chat để tích hợp React Chat SDK.

    Mở bảng điều khiển Chat
  2. 02

    Thêm React UI Kit

    Cài đặt gói. Tùy chỉnh các thành phần theo nhu cầu của bạn.

    Làm theo hướng dẫn React
  3. 03

    Gửi tin nhắn đầu tiên

    Đăng nhập vào hai tài khoản người dùng React Chat SDK và gửi tin nhắn thử nghiệm.

    Kết nối người dùng của bạn
Bộ giao diện trò chuyện React
Terminal
npm install @tencentcloud/chat-uikit-react
UI composition
<UIKitProvider theme="light">
  <ConversationList />
  <Chat>
    <ChatHeader />
    <MessageList />
    <MessageInput />
  </Chat>
</UIKitProvider>

CHAT + CALL

Một số cuộc trò chuyện cần một cuộc gọi

Kết nối thoại và video thông qua TUICallKit và phần đầu chat React.

Tính năng gọi yêu cầu tích hợp TUICallKit và bật dịch vụ Call. Hãy xem giá Call riêng với giá Chat.

Câu hỏi thường gặp về React Chat SDK

React Chat SDK khác React UI Kit như thế nào?

React Chat SDK cung cấp khả năng nhắn tin thông qua JavaScript SDK. React UI Kit bổ sung các thành phần dựng sẵn cho giao diện trò chuyện. Sử dụng UI Kit để bắt đầu với các thành phần đã kết nối hoặc tự xây dựng giao diện dựa trên SDK nền tảng.

Tôi có thể tùy chỉnh các thành phần và bố cục tin nhắn không?

Có. Sử dụng props và các điểm mở rộng trong tài liệu để cấu hình hoạt động của thành phần, điều chỉnh bản xem trước cuộc trò chuyện và hiển thị tin nhắn tùy chỉnh. Các thay đổi được hỗ trợ tùy thuộc vào từng thành phần; hãy kiểm tra API trước khi lên kế hoạch thay thế.

Tôi nên sử dụng UI Kit nào cho React web, web di động hoặc React Native?

Sử dụng React UI Kit cho các ứng dụng chạy trên trình duyệt. Hướng dẫn web di động (H5) sử dụng các thành phần như ConversationListH5 và MessageListH5 trong gói React. Với các ứng dụng iOS và Android native được xây dựng bằng React Native, hãy sử dụng React Native UI Kit riêng cùng hướng dẫn thiết lập native.

Làm cách nào để tích hợp React Chat SDK với Next.js hoặc SSR?

Lập kế hoạch cho giao diện trò chuyện tương tác trên trình duyệt. Trong Next.js App Router, hãy tách mã phụ thuộc vào trình duyệt vào một Client Component; Next.js hỗ trợ tải động chỉ ở phía máy khách với ssr: false. Tạo UserSig trên máy chủ. Kiểm tra phiên bản và các phần phụ thuộc của UI Kit đã cài đặt, đồng thời kiểm thử bản dựng production, quy trình đăng nhập và điều hướng trước khi phát hành.

React UI Kit mã nguồn mở liên quan như thế nào đến dịch vụ Chat được lưu trữ?

Mã nguồn React UI Kit có trên GitHub. Các thành phần nhắn tin có kết nối sử dụng Tencent RTC Chat và yêu cầu một ứng dụng Chat cùng người dùng đã xác thực. Việc cung cấp mã nguồn thành phần không bao gồm dịch vụ nhắn tin lưu trữ không giới hạn: mức sử dụng dịch vụ và quyền truy cập tính năng tuân theo gói Chat của bạn. Bạn có thể chạy bản xem trước UI cục bộ mà không cần kết nối trực tiếp.

Tôi có thể bắt đầu sử dụng React Chat SDK miễn phí không?

Tencent RTC Chat cung cấp gói miễn phí với 1,000 người dùng hoạt động hằng tháng. Hãy xem chi tiết gói và mức giá cho các tính năng cũng như mức sử dụng bạn cần.

React UI Kit có hỗ trợ cuộc gọi thoại và video không?

Bạn có thể thêm tính năng gọi bằng cách tích hợp TUICallKit và bật dịch vụ Call. Ví dụ tích hợp React đầy đủ hiện tại có phần mở rộng này; việc thiết lập và định giá cuộc gọi vẫn tách biệt với dịch vụ nhắn tin.

Cloud Search có nằm trong gói miễn phí không?

Cloud Search là tính năng giá trị gia tăng yêu cầu plugin Cloud Search. Hãy xem xét các yêu cầu trước khi bật tìm kiếm trong giao diện chat.

Làm thế nào để tích hợp Chat SDK React với React?

Khởi tạo provider theo tài liệu và kết hợp các thành phần đã kết nối. Đồng bộ đăng ký sự kiện và dọn dẹp với vòng đời React, rồi kiểm thử điều hướng và mount lặp lại trong ứng dụng thực tế.

Làm thế nào để kiểm thử Chat SDK React trước khi phát hành ứng dụng?

Kiểm tra đăng nhập, SDK sẵn sàng, sự kiện gửi nhận và trạng thái tin nhắn sau kết nối lại.

Làm thế nào để tùy chỉnh giao diện Chat SDK React?

Bao các thành phần chat trong UIKitProvider và đặt theme="light" hoặc theme="dark". Thành phần con có thể dùng useUIKit().setTheme để chuyển giao diện; hook phải chạy trong ngữ cảnh của provider. Với thẻ sản phẩm, cung cấp trình hiển thị tin nhắn tùy chỉnh qua MessageList.messageRenderers. Giữ phương án hiển thị dự phòng cho payload không nhận diện được, và để ứng dụng xử lý việc tra cứu sản phẩm cùng thanh toán, thay vì xem đó là tính năng của Chat.

Tìm hình thức hỗ trợ phù hợp cho bước tiếp theo

Câu hỏi kỹ thuật

Xem mẫu React Chat SDK hoặc báo cáo sự cố có thể tái hiện.

Xem GitHub Issues

Câu hỏi về sản phẩm và giá cả

Trao đổi với đội ngũ của chúng tôi về ứng dụng, mức sử dụng dự kiến và nhu cầu tích hợp của bạn.

Liên hệ bộ phận kinh doanh

Cuộc trò chuyện tiếp theo của bạn bắt đầu tại đây

Xây dựng với React Chat SDK và UI Kit. Bắt đầu miễn phí với 1.000 người dùng hoạt động hằng tháng.