SuperAPI AI 工具集

cometchat-angular-core

前端与建站

查看项目

更新于 10-16 05:03

技能介绍

用途:本技能是 CometChat Angular UI Kit v4 集成的基础规则,说明初始化顺序、UIKitSettingsBuilder 用法、登录、环境配置、模块导入及会破坏应用的常见反模式。支持 Angular 12、13、14、15,Angular 16+(Signals/独立优先)未覆盖,应先读本技能再读其他技能。

主要能力与必要用法:生命周期只有一条有效路径,即 CometChatUIKit.init(UIKitSettings) → CometChatUIKit.login({ uid }) → 渲染 <cometchat-*> 组件,顺序错误会出现空白组件、未初始化错误或登录挂起。Angular 必须使用 @cometchat/uikit-shared 的 UIKitSettingsBuilder 链式构建,不能像 React Native 那样传扁平对象。初始化应在 app.component.ts 的 ngOnInit 或经 APP_INITIALIZER 的 AppInitService 中执行一次,不要在懒加载模块中初始化。登录用 login({ uid: '...' }),开发用预置的 cometchat-uid-1 至 cometchat-uid-5;生产用 login({ authToken: '...' }),令牌由后端通过 REST API Key 生成。取当前用户:异步用 await CometChatUIKit.getLoggedinUser(),组件和路由守卫用同步的 CometChatUIKitLoginListener.getLoggedInUser()。退出用 CometChatUIKit.logout()。模块需显式导入所用组件,并加 CUSTOM_ELEMENTS_SCHEMA;Angular 14+ 可用独立组件。必须在 angular.json 配置 @cometchat/chat-uikit-angular/assets/ 输出到 assets/,否则图标损坏。环境变量放在 environment.ts 的常量对象中,生产不写 authKey、不写 REST_API_KEY。主题通过注入 CometChatThemeService 设置 light/dark 与主色。安装命令:npm install @cometchat/chat-uikit-angular 与 npm install @cometchat/uikit-elements @cometchat/uikit-resources @cometchat/uikit-shared,另需 @angular/animations 与 BrowserAnimationsModule。

适用场景与限制:适用于 Angular 12–15 的 CometChat UI Kit v4 集成。Visual Builder 目前不提供 Angular 导出,需走代码驱动路径。i18n 由 CometChatLocalize 提供约 40 种语言,RTL 依据 document 根节点 dir 属性自动翻转,可访问性默认包含 aria 与键盘导航。资料未提供价格、性能数据或 Angular 16+ 支持细节。