SuperAPI AI 工具集

cometchat-angular-v5-features

编程与开发

查看项目

更新于 10-21 20:28

技能介绍

用途

该技能用于在 Angular 应用中启用或构建任意 CometChat 功能,并明确告知开发者哪些功能无需编写任何客户端代码。它面向需要为 CometChat Angular v5 应用添加聊天能力的开发者,帮助其避免重复实现已有功能或误判功能不存在。

主要能力

技能以 features.angular-v5.json(位于包根目录)作为功能存在性的唯一事实来源:用户请求的功能必须是其中的一个 id,未列出即不存在,不得凭空创造。具体启用步骤和载荷需从每个条目的 docs_topic 获取,docs_topic 是一个路径,需结合 cometchat-angular-v5-core/references/docs-map.md 中的 DOCS_BASE 解析,并追加 .md。UI 组件名称来自 angular-v5 目录。

技能将功能请求分为以下几类:

  • 默认已开启:reactions、mentions、送达/已读回执、输入状态、媒体与文件附件、语音消息。这些是 v5 核心功能,不是扩展,不应手动添加。若不可见,原因通常是缺少 @Input() 或容器未设置尺寸。
  • 仪表盘扩展——零代码:在仪表盘启用即可,无需其他操作。包括 polls、stickers、协作白板、协作文档、消息翻译、链接预览、缩略图生成。
  • 仪表盘扩展——宿主自行组装:在仪表盘启用后,还需自行构建 UI,使用 CometChat.callExtension() 发送/获取,并用自有组件渲染。仅开启仪表盘开关不会产生可见效果。包括置顶消息、保存消息、消息快捷方式、语音转写、富媒体预览、GIF、提醒、URL 短链接、阅后即焚、支持集成,共 10 项。needs_stitching: true 是权威信号,而非 ui_components。
  • 仪表盘 + AI:在仪表盘启用后,可选放置组件,如 <cometchat-smart-replies>、<cometchat-conversation-starter>、<cometchat-conversation-summary>。<cometchat-message-list> 在启用时也会发出 smartReplyClick 和 conversationStarterClick。AI 助手为 CometChatAIAssistantChat,无 Component 后缀。
  • 需要客户端代码:线程回复、搜索、自定义消息类型、文本格式化/富文本、语音与视频通话、推送通知。

使用方式

当有人要求添加或启用某项能力时使用本技能。首先对请求进行分类,判断属于上述哪一类。在告知用户切换开关前,先询问是仪表盘中的哪个应用。对于宿主自行组装类扩展,需调用 CometChat.callExtension(),例如:

import { CometChat } from '@cometchat/chat-sdk-javascript';

// SEND — exact slug, endpoint and payload are on the extension's own docs page
await CometChat.callExtension('pin-message', 'POST', 'v1/pin', { msgId, receiverType });

发送只是工作的一部分,还需获取置顶/保存列表并渲染。完整模式参见 references/host-composed-extensions.md。

适用场景

适用于在 Angular 应用中添加或启用 CometChat 聊天功能的场景,包括添加投票、启用表情回应、开启智能回复等。也适用于判断某项功能是否需要编写代码,以及避免常见错误,例如手写已默认开启的功能、假设所有扩展都是零代码、因 node_modules 中无命名方法而判定功能不存在、在浏览器本地重新实现服务端功能、提供 Angular 不支持的功能(端到端加密、直播、邮件回复)、忘记仪表盘步骤、将 reactions/mentions 视为扩展。

限制

Angular 不支持端到端加密、直播、邮件回复,这些功能存在于其他平台。docs_topic 是路径而非 URL,不要硬编码 https://www.cometchat.com/docs/...,因为 DOCS_BASE 可能指向文档预览版本。扩展没有命名 SDK 方法,均通过通用的 callExtension() 访问。服务端功能(保存/置顶消息、提醒、快捷方式)存储在服务端,按用户跨设备同步,浏览器本地副本不会同步到用户手机且会随缓存消失。