用途:指导在 Next.js 项目中集成 CometChat React UI Kit v6(依赖 @cometchat/chat-uikit-react@^6,可选 @cometchat/calls-sdk-javascript@^5)。因 Next.js 存在服务端渲染与 Server/Client Component 边界,而 CometChat 组件仅在浏览器可用,该技能专门解决此类集成问题。
主要能力:识别项目使用 App Router 还是 Pages Router;防止 SSR 崩溃;提供 Provider 实现与挂载位置选择;给出路由放置与模态/抽屉放置模式。
必要用法:App Router 中每个导入 CometChat 的文件首行必须写 "use client";Next.js 15+ 中 dynamic(..., { ssr: false }) 不能用于 Server Component,需页面本身为 Client Component;Pages Router 用 next/dynamic 配合 ssr: false。Provider 需处理初始化与登录,避免 StrictMode 下重复登录。全局挂载需在 app/layout.tsx 加 export const dynamic = "force-dynamic";也可用路由组将 Provider 限定在聊天路由。
限制:资料未提供收费、价格与效果信息;具体符号应以已安装包与官方文档为准。