警告
Microsoft Graph 工具包已弃用。 停用期从 2025 年 9 月 1 日开始,计划于 2026 年 8 月 28 日完全停用。 开发人员应迁移到使用 Microsoft Graph SDK 或其他受支持的Microsoft Graph 工具来构建 Web 体验。 有关详细信息,请参阅 弃用公告。
注意
此组件为预览版,随时可能更改。 不支持在生产应用程序中使用这些组件。 此组件目前仅作为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组件不支持主题设置,并且不会遵循浏览器首选项。