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
组件不支持主题设置,并且不会遵循浏览器首选项。