Microsoft Graph 工具包中的聊天组件

重要

此组件为预览版,随时可能更改。 不支持在生产应用程序中使用这些组件。

注意

此组件目前仅作为React组件提供,没有等效的 Web 组件。

注意

此功能利用实时终结点和高容量 API,并受 Microsoft Teams API 的支付模型和许可要求中所述的相同计费模型的约束。

聊天组件使用户能够进行 1:1 或群组对话。 此组件不支持频道对话。 组件允许呈现对话和创作新消息。 所有数据都存储在 Microsoft Teams 中。

示例

以下示例使用 mgt-chat 组件显示一个对话。

聊天组件的屏幕截图

属性

属性 属性 说明
chat-id chatId 一个字符串 ID,用于设置要呈现的 1:1 或组 对话 。 必填。

CSS 自定义属性

组件 mgt-chat 不定义 CSS 自定义属性。

事件

组件 mgt-chat 不提供任何事件。

模板

组件 mgt-chat 不提供要替代的模板。

Microsoft Graph 权限

此控件使用以下 Microsoft Graph API 和权限。

配置 权限 API
chatId 已设置 Chat.ReadBasic、Chat.Read、ChatMessage.Read、Chat.ReadWrite、ChatMember.ReadWrite /chats/{id}/messages/chats/{id}/messages/chats/{id}/messages/{messageId}/me/chats/{id}/messages/{messageId}/softDelete/chats/{id}/members/{membershipId}/chats/{id}/members/chats/{id}/messages/{messageId}/hostedContents/{hostedContentId},/chats/{id}

子组件

组件 mgt-chat 由一个或多个子组件组成,这些子组件可能需要除前面列出的权限以外的其他权限。 有关详细信息,请参阅每个子组件的文档:

身份验证

组件 mgt-chat 使用身份验证文档中所述的全局 身份验证提供程序。

缓存

组件 mgt-chat 缓存聊天消息和相关元数据。

本地化

组件 mgt-chat 不公开任何本地化变量。

已知问题

  • 组件 mgt-chat 不支持在组件的多个实例中或跨多个选项卡使用同一 chatId 个组件。
  • mgt-chat 组件不支持主题设置,并且不会遵循浏览器首选项。