警告
Microsoft Graph 工具包已弃用。 停用期从 2025 年 9 月 1 日开始,计划于 2026 年 8 月 28 日完全停用。 开发人员应迁移到使用 Microsoft Graph SDK 或其他受支持的 Microsoft Graph 工具来构建 Web 体验。 有关详细信息,请参阅 弃用公告。
注意
此组件处于预览状态,可能会发生更改。 不支持在生产应用程序中使用这些组件。 该组件目前仅作为 React 组件提供,没有等效的 Web 组件。
聊天组件允许用户进行 1:1 或群组对话。 此组件不支持频道对话。 该组件允许呈现对话和创作新消息。 所有数据都存储在 Microsoft Teams 中。
示例
以下示例显示了使用该 mgt-chat 组件的对话。
属性
| 属性 | 属性 | 说明 |
|---|---|---|
| 聊天 ID | chatId | 用于设置要呈现的 1:1 或群组对话 的字符串 ID。 必填。 |
CSS 自定义属性
该 mgt-chat 组件不定义 CSS 自定义属性。
事件
该 mgt-chat 组件不提供任何事件。
模板
组件 mgt-chat 不提供要覆盖的模板。
Microsoft Graph 权限
此控件使用以下 Microsoft Graph API 和权限。
| 配置 | 权限 | API |
|---|---|---|
chatId 已设置 |
对话助手。ReadBasic,对话助手。Read,ChatMessage.Read,对话助手。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组件不支持主题设置,并且不会遵守浏览器首选项。