快速集成
chat-uikit-react 介绍
chat-uikit-react 是基于腾讯云 Chat SDK 的一款 react UI 组件库,它提供了一些通用的 UI 组件,包含会话、聊天、群组等功能。基于这些精心设计的 UI 组件,您可以快速构建优雅的、可靠的、可扩展的 Chat 应用。
开发环境要求
React version 18
TypeScript
Node.js version 18+
npm(版本请与 node 版本匹配)
chat-uikit-react 集成
步骤1:创建项目
创建一个新的名为 chat-app 的 React 项目(创建项目时选择 React 18,并且建议使用 Typescript 模版),并按照提示跑通初始项目。
npm create rsbuild@latest
步骤2:下载 chat-uikit-react 组件
npm i @tencentcloud/chat-uikit-react
步骤3:引入 chat-uikit-react 组件
注意:
以下代码中未填入
SDKAppID
、userID
和 userSig
,需在 步骤4 中获取相关信息后进行替换。为尊重表情设计版权,Chat Demo/TUIKit 工程中不包含大表情元素切图,正式上线商用前请您替换为自己设计或拥有版权的其他表情包。下图所示默认的小黄脸表情包版权归腾讯云所有,可有偿授权使用,如需获得授权可 提交工单 联系我们。


import {UIKitProvider,useLoginState,LoginStatus,ConversationList,Chat,ChatHeader,MessageList,MessageInput,useUIOpenControlState,ChatSetting,Search,VariantType,} from "@tencentcloud/chat-uikit-react";function App() {const { isChatSettingOpen, isChatSearchOpen } = useUIOpenControlState();const { status } = useLoginState({SDKAppID: 0, // 参考步骤 4userID: '', // 参考步骤 5userSig: '', // 参考步骤 5})if (status !== LoginStatus.SUCCESS) {return <div>Loading...</div>}// 语言支持 en-US(default) / zh-CN / ja-JP / ko-KR / zh-TW// 主题支持 light(default) / darkreturn (<UIKitProvider><div style={{ height: '100vh', width: '100vw', display: 'flex', flexDirection: 'row' }}><ConversationList style={{ minWidth: '300px', maxWidth: '350px' }}/><Chat PlaceholderEmpty="No messages yet"><ChatHeader /><MessageList /><MessageInput /></Chat>{isChatSettingOpen && <ChatSetting />}{isChatSearchOpen && <Search style={{ minWidth: '300px'}} variant={VariantType.EMBEDDED} />}</div></UIKitProvider>);}export default App;
步骤4:创建一个应用
1. 登录 Chat Console 。
2. 单击 Create Application,输入您的应用程序名称,然后单击 Create。


3. 创建完成后,您可以在控制台概览页面看到新应用的状态、服务版本、SDKAppID、创建时间、标签、过期时间。


步骤5:获取 userID 和 userSig
userID
单击进入您上面创建的 Application,会在左侧边栏看到
Chat
产品入口,单击进入。进入 Chat 产品子页面后,点击
Users
,进入用户管理页面。单击
Create account
,弹出创建账号信息填写框。如果只是普通成员,我们建议您选择General
类型。为了您更好的体验消息收发等功能,建议您创建两个 userID。


userSig
,可使用控制台提供的开发工具实时生成,开发工具请点击 Chat Console > Development Tools > UserSig Tools > Signature (UserSig) Generator 。

步骤6:启动项目
替换 App.tsx 中的 SDKAppID、userID、userSig,然后运行命令如下:
npm run dev
注意:
1. 请确保 步骤3 代码中
SDKAppID
、userID
和 userSig
均已成功替换,如未替换将会导致项目表现异常。2.
userID
和 userSig
为一一对应关系,具体参见 生成 UserSig。3. 如遇到项目启动失败,请检查 开发环境要求 是否满足。
步骤7:发送您的第一条消息
在输入框中输入您的消息,然后按 Enter 发送。


常见问题
什么是 UserSig?
UserSig 是用户登录 Chat 的密码,其本质是对 UserID 等信息加密后得到的密文。
如何生成 UserSig?
UserSig 签发方式是将 UserSig 的计算代码集成到您的服务端,并提供面向项目的接口,在需要 UserSig 时由您的项目向业务服务器发起请求获取动态 UserSig。更多详情请参见 服务端生成 UserSig。
注意:
本文示例代码采用的获取 UserSig 的方案是在客户端代码中配置 SECRETKEY,该方法中 SECRETKEY 很容易被反编译逆向破解,一旦您的密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通功能调试。 正确的 UserSig 签发方式请参见上文。
交流与反馈
相关文档
UIKit 相关: