常见问题解答

  • 项目

本部分包含常见问题解答和答案。

自适应卡片预览器

为什么我们必须在 Visual Studio Code 中使用新的扩展？无法将此扩展集成到 Teams 工具包Visual Studio Code中吗？

自适应卡片预览器是一个独立的扩展，因为它使用闭源包来呈现自适应卡片，以确保与 Teams 平台的呈现逻辑一致。 Teams 工具包是一个开源项目，不包含第三方开发人员无法访问的包的依赖项。
 

此扩展是否支持 Teams 平台中的所有自适应卡片功能？

否。 自适应卡片预览器扩展不支持几个 限制 。
 

Visual Studio 是否会集成到自适应卡片预览器中？

否，自适应卡片预览器仅在 Visual Studio Code 中可用。
 

应用验证

如何将Microsoft Entra ID连接到 MPN 帐户？

按照此处提供的页面中的步骤操作：

  1. 发布者验证概述 - Microsoft Entra。
  2. Microsoft Learn 将应用标记为发布者验证 - Microsoft Entra。
  3. Microsoft Learn 分辨率 - 将Microsoft Entra ID连接到 MPN 设置。

机器人

如何将自适应卡片与机器人配合使用，以便桌面应用行为在 Web 应用和移动应用之间保持一致？

有关对机器人使用自适应卡片的详细信息，请参阅 使用自适应卡片的通用操作。
 

如何从机器人历史记录中删除特定消息？是否有方法可以获取聊天历史记录并查找特定消息的活动 ID？

使用删除消息 - 机器人框架的 DeleteActivity 方法： 更新和删除从机器人发送的消息。
 

如何通过代码测试卡架构的有效性？

可以使用开发人员门户>工具中的自适应卡片编辑器 (预览) 选项来测试或验证自适应卡片架构。

为什么无法在开发人员门户中创建机器人？

用户禁用应用注册，或者用户没有足够的权限来创建应用。 有关详细信息，请参阅 限制和已知问题。

实时共享

是否可以使用自己的 Azure Fluid Relay 服务？

可以！ 初始化 Live Share 时，可以定义自己的 AzureConnectionConfig。 Live Share 会将你创建的容器与会议相关联，但你需要实现 接口 ITokenProvider 来为容器签名令牌。 例如，可以使用提供的 AzureFunctionTokenProvider，它使用 Azure 云函数从服务器请求访问令牌。

虽然大多数人发现使用我们的免费托管服务是有益的，但有时可能仍对 Live Share 应用使用自己的 Azure Fluid Relay 服务是有益的。 在以下情况下，请考虑使用自定义 AFR 服务连接：

  • 要求在会议生存期之后在 Fluid 容器中存储数据。
  • 通过需要自定义安全策略的服务传输敏感数据。
  • 通过 Fluid Framework 开发功能，例如 ， SharedMap为 Teams 外部的应用程序开发功能。

有关详细信息，请参阅 如何指导 或访问 Azure Fluid Relay 文档。
 

Live Share 的托管服务中存储的数据可访问多长时间？

可在 24 小时内访问通过 Live Share 托管的 Azure Fluid Relay 服务创建的 Fluid 容器发送或存储的任何数据。 如果希望将数据保留超过 24 小时，可以将托管的 Azure Fluid Relay 服务替换为你自己的服务。 或者，可以并行使用自己的存储服务提供商和 Live Share 托管服务。
 

Live Share 支持哪些会议类型？

Live Share 支持计划会议、一对一通话、群组通话和立即开会。 尚不支持频道会议。
 

Live Share 的媒体包适用于 DRM 内容吗？

Live Share 的媒体包不适用于 DRM 内容。 目前，Teams 不支持桌面上的选项卡应用程序的加密媒体。 支持 Chrome、Edge 和移动客户端。

有关详细信息，可 在此处跟踪问题。
 

有多少人可以参加实时共享会话？

目前，Live Share 每个会话最多支持 100 名与会者。 如果你对此感兴趣，可以 在此处开始讨论。
 

是否可以在 Teams 外部使用 Live Share 的数据结构？

目前，Live Share 包需要 Teams 客户端 SDK 才能正常运行。 Microsoft Teams 中的 @microsoft/live-share 功能或 @microsoft/live-share-media 功能在 Microsoft Teams 外部不起作用。 如果你对此感兴趣，可以 在此处开始讨论。
 

是否可以使用多个 Fluid 容器？

目前，Live Share 仅支持使用我们提供的 Azure Fluid Relay 服务拥有一个容器。 但是，可以使用 Live Share 容器和你自己的 Azure Fluid Relay 实例创建的容器。
 

是否可以在创建容器后更改 Fluid 容器架构？

目前，Live Share 不支持在创建或加入容器后向 Fluid ContainerSchema 添加新initialObjects内容。 由于 Live Share 会话的生存期较短，因此在向应用添加新功能后，这是开发过程中最常见的问题。

注意

如果在 中使用 dynamicObjectTypesContainerSchema中的 属性，可以随时添加新类型。 如果以后从架构中删除类型，则这些类型的现有 DDS 实例将正常失败。

若要修复在浏览器中本地测试时更改 initialObjects 时产生的错误，请从 URL 中删除经过哈希的容器 ID 并重新加载页面。 如果要在 Teams 会议中进行测试，请启动新会议，然后重试。

如果计划经常使用新的 SharedObject 或 LiveObject 实例更新应用，应考虑如何将新架构更改部署到生产环境。 虽然实际风险相对较低且持续时间较短，但当你推出更改时，可能会有活动会话。 会话中的现有用户不应受到影响，但在部署中断性变更后加入该会话的用户可能会在连接到会话时出现问题。 为了缓解此问题，可以考虑以下一些解决方案：

  • 在正常工作时间之外部署 Web 应用程序的架构更改。
  • 将 用于 dynamicObjectTypes 对架构所做的任何更改，而不是更改 initialObjects。

注意

Live Share 当前不支持版本控制 ContainerSchema，也没有任何专用于迁移的 API。


 
通过 Live Share 可以发出多少个更改事件是否有限制？

虽然 Live Share 处于预览状态，但不会强制实施对通过 Live Share 发出的事件的任何限制。 为了获得最佳性能，必须将通过 SharedObject 或 LiveObject 实例发出的更改反转为每 50 毫秒或更多一条消息。 这在根据鼠标或触摸坐标发送更改时尤其重要，例如在同步光标位置、墨迹书写和在页面上拖动对象时。
 

政府社区云 (GCC) 、政府社区云高 (GCC-High) 和国防部 (DOD) 租户是否支持 Live Share？

GCC、GCC-High 和 DOD 租户不支持 Live Share。


Live Share 是否支持外部用户和来宾用户？

是的，Live Share 支持大多数会议类型的来宾和外部用户。 但是，频道会议不支持来宾用户。


Live Share 是否支持Teams 会议室设备？

否，Live Share 不支持Teams 会议室设备。

Live Share 应用是否支持会议录制？

否，Live Share 不支持会议录制。

Microsoft 365 Chat

为什么Microsoft 365 Chat未在响应中包含我的插件？

确保应用清单 (以前称为 Teams 应用清单) 具有描述性。 应用清单有助于插件匹配以响应用户提示。 此外，请确保将应用包上传到 Outlook 并与应用交互，包括身份验证。

如果问题仍然存在，请在答复Microsoft 365 Chat中使用大拇指向下指示器，并在答复前面加上 [MessageExtension]。

应用清单中应包含哪些说明？

下面是适用于 NPM 查找器的示例说明。

 "name": { 

        "short": "NPM Finder", 

        "full": "Nuget Package Manager Finder" 

    }, 

    "description": { 

        "short": "Returns information about available NPM packages", 

        "full": "The Nuget Package Manager (NPM) Finder application provides information (such as title and description) about Nuget packages available in the global NPM catalog." 

    }, 

… 

            "commands": [ 

                { 

                    "id": "searchQuery", 

                    "context": [ 

                        "compose", 

                        "commandBox" 

                    ], 

                    "description": "Searches the global NPM catalog for available packages", 

                    "title": "Search", 

                    "type": "query", 

                    "parameters": [ 

                        { 

                            "name": "searchQuery", 

                            "title": "Search Query", 

                            "description": "A package name or description of capability to search", 

                            "inputType": "text" 

                        } 

                    ]
Microsoft 365 Chat响应中包含插件，但Microsoft 365 Chat的响应不符合我的期望。我该怎么做？

使用Microsoft 365 Chat答复中的“倒票”选项，并使用 [MessageExtension] 作为答复前缀。

是否可以生成自己的 Teams 消息扩展？

是的，可以。 确保具有描述性应用清单，并将应用上传到 Outlook 并与之交互。

如何获取现有的 Teams 消息扩展以使用 Microsoft 365 Chat？
  1. 在 Azure 机器人服务 中注册机器人通道。
  2. 将应用上传到 Outlook。
Teams 应用可作为适用于 Microsoft 365 的 Microsoft Copilot插件进行扩展的指南有哪些？

可以阅读 Teams 应用的 Teams 应用商店验证指南，该指南可扩展为适用于 Microsoft 365 的 Microsoft Copilot的插件。

认证流程是什么？

发布插件后，在合作伙伴中心启动应用合规性流。 如果 发布者验证 不完整，请确保在 Microsoft 365 认证之前完成应用合规性流。 然后，完成 发布者证明，它收集有关插件、公司和操作的自证明数据。 有关详细信息，请参阅 Microsoft 365 应用合规性计划。

若要启动 Microsoft 365 认证过程，请上传定义插件和操作环境的评估范围的初始文档。 根据范围，提供与应用程序安全性、操作安全性以及数据处理或隐私相关的特定控制措施的证据。 如果在 Azure 上生成插件，则可以使用应用合规性自动化工具 (ACAT) 扫描环境并生成多个控件的证据，从而减少手动工作负荷。 有关详细信息，请参阅 适用于 Microsoft 365 的应用合规性自动化工具。

如何对插件进行认证？

应用通过主动验证后，将鼓励未认证的现有和新消息扩展的开发人员认证其插件。 这是通过确认其邮件扩展已验证的电子邮件传达的。

如何认证新插件？

将鼓励开发人员在成功完成验证后认证其新插件。

如何为适用于 Microsoft 365 的 Copilot创建或升级消息扩展插件？

可以在 适用于 Microsoft 365 的 Copilot 中创建或升级消息扩展插件，以便与第三方工具和服务交互，并通过适用于 Microsoft 365 的 Copilot实现更多目标。 此外，扩展必须满足准则中所述的合规性、性能、安全性和用户体验标准，才能创建或升级用于适用于 Microsoft 365 的 Copilot的消息扩展插件。

Microsoft Graph

用户如何设置其时区以在首选时间获取通知？

可以使用以下图形 API获取用户邮箱设置。 可以按如下所示获取用户的时区：

  • GET /me/mailboxSettings/timeZone
  • GET /users/{id|userPrincipalName}/mailboxSettings/timeZone

 

如何使用 Teams 工具包在 Azure 中部署代码，并使用 图形 API 获取用户个人资料照片？

有关 Teams 工具包的详细信息，请参阅 创建新的 Teams 项目 和 Teams 工具包 CLI。


 
图形 API在 Postman 中工作吗？

可以将 Microsoft Graph Postman 集合与 Microsoft Graph API 配合使用。

有关详细信息，请参阅结合使用 Postman 和 Microsoft Graph API。
 

图形 API在 Microsoft Graph 资源管理器中是否工作？

是的，图形 API 在 Microsoft Graph 资源管理器中工作。

有关详细信息，请参阅 Graph 浏览器。
 

Moodle

如果同步后未创建一个或多个课程团队，该怎么办？

每个 Moodle 课程必须至少有一名教职员工和一名学生与 Microsoft 365 帐户用户名匹配。 如果同步找不到匹配项，则无法创建团队。

每个团队课程实例都必须有一个所有者，并且同步会将教职员工设置为所有者，并假定教职员工拥有 Teams 许可证。
 

从 Teams 工作时，我们应执行哪些操作来删除 Moodle 登录页？是否可以强制 (SSO) 单一登录？

应用用户具有 Moodle 登录页中的多个登录选项。

  • 若要使用 Microsoft 365 凭据以专属方式登录，请为 auth_oidc 插件启用强制重定向配置设置。 如果启用了该服务，应用用户可以看到 Microsoft 登录页。
  • 若要手动登录到 Moodle 门户，请参阅 Moodle。

 

如何指定要同步的用户？我不希望所有Microsoft Entra用户都与 Moodle 网站同步。

使用“ 用户创建限制 ”选项通过同步 local_o365 插件的配置选项来指定应用用户。 筛选器左侧的下拉菜单提供选项，例如“国家或地区”、“公司名称”和“语言”。

提示

创建动态 Microsoft 365组，以启用具有多个配置文件属性的筛选器选项。

下图显示了用户创建限制选项：

sync

Microsoft Entra ID
 

我们希望我们的教职员工能够将课程同步到 Teams。Moodle 管理员是否是唯一可以控制课程同步的人员？

默认情况下，只有 Moodle 管理员可以配置同步。 团队所有者可以控制课程是否同步到 Teams 以及是否启用允许在课程中配置课程同步。 在这种情况下，团队所有者是教职员工。 block 向具有相应所有者权限的个人显示配置选项。

下图显示了允许在课程中配置课程同步选项：

管理员

下图显示了课程同步：

同步
 

我们遵循了文档，但用户帐户无法同步Microsoft Entra ID和 Moodle。我们应该怎么做？

在用户执行 Delta 令牌清理作为最终故障排除步骤之前，可以解决此问题。

下表提供了要执行和检查的操作和依赖项：

相关项 Action 参考
稳定版本 验证 Moodle 的版本是否列为稳定版。 有关详细信息，请参阅版本支持。
权限 验证 Azure 应用程序是否具有运行同步所需的权限。 有关详细信息，请参阅 Microsoft 权限。
完全同步 验证是否已启用每次运行执行完全同步，并查看使用Microsoft Entra ID同步用户的任务日志。 有关详细信息，请参阅 启用完全同步
有关详细信息，请参阅 检查任务日志。
令牌刷新 在 local_o365 插件中清理用户同步 delta 令牌。 有关详细信息，请参阅令牌刷新。

 
一个或多个用户无法使用其 Microsoft 365 凭据登录，尽管大多数用户都可以在没有问题的情况下登录。这种不一致的原因是什么？

用户无法使用其 Microsoft 365 凭据进行登录的原因可能与同步期间的用户映射操作有关。 若要解决该问题，请执行以下步骤：

  • 检查 Moodle 用户身份验证类型是否 OpenID。
  • 检查 Moodle 用户名是否与Microsoft Entra用户名匹配。
  • 清理令牌问题并重试。
  • 检查用户是否具有访问 Azure 应用程序的权限。

 

所有用户都无法使用其 Microsoft 365 凭据登录。我们可以做些什么来解决此问题？

一开始无法登录的用户需要报告问题并验证应用程序的 客户端密码 是否未过期。

下图显示了用户在使用 Microsoft 365 凭据登录时收到的错误消息：

报告问题

下图显示了 Azure 门户中的错误：

Azure 门户

如果 客户端密码 已过期，则应用用户需要生成新的 客户端密码，并更新页面上的配置。 用户可以在更新客户端密码后重新登录，这可能需要长达 24 小时才能重新预配。
 

如何更改链接到课程的 Teams 实例？

管理员可以通过“管理团队Connections”页更改与课程关联的 Teams 实例。 选择要更改的课程旁边的“ 连接 ”，然后选择 Teams 实例。 如果使用课程重置来存档团队，则可以将其链接回上一个团队。

下图显示了 Teams 实例：

团队实例
 

为什么 Atto Teams 会议集成未显示在 Atto 编辑器中？

如果在 Atto 编辑器中显示 Teams 图标的工具栏配置中缺少图标引用，则用户可能会遇到 Atto Teams 会议问题。 用户需要使用以下步骤将 Teams 会议图标添加到链接图标的右侧：

  1. 安装插件。
  2. 使用团队会议更新工具栏配置。

下图显示了工具栏配置调整后的工具栏图标：

工具栏

链接图标

有关编辑 Atto 工具栏详细信息，请参阅：


 
通过 Microsoft 集成安排的会议显示在 Outlook 中还是 Teams 日历中？显示会议的标准时间线是什么？

通过应用安排的会议不会显示在计划的 Outlook 或 Teams 日历中，因为它们相当于频道会议。 课程频道中的所有成员都可以直接从嵌入式频道链接参加会议。 有关详细信息，请参阅频道会议。

但是，你可以访问邀请并将参与者姓名手动添加到会议邀请的必需或可选字段，以在其日历上显示远程会议。 标准日程表基于用户在创建会议时指定的日期。 有关限制的详细信息，请参阅 Microsoft Teams 的限制和规范。
 

是否有任何支持网站可以在其中获取有关产品和其他问题的更多帮助？

有关产品和服务问题的支持和帮助或开发人员社区帮助，请参阅 支持和反馈。

通知

如何在主动机器人中保存保护引用？

建议将对话引用保存到数据库，并使用相同的 来生成会话对象以发送主动消息。

页面方向

注意

常见问题解答仅适用于 Teams 移动版。


是否需要在应用中进行任何更改才能获取横向模式？

否。 默认情况下，可以在横向模式下使用应用。
 

如果我的应用不支持其中一种模式，或者如果方案仅用于其中一种模式，该怎么办？

默认情况下，Teams 支持这两种模式。 Teams 中的应用不支持仅在一种模式下工作。 如果你的应用需要此要求，请联系 支持团队。
 

如何修复应用为空状态时缺少的滚动？

将 添加到 <FlexColumn scroll></FlexColumn> 应用的空状态。
 

如何在横向和纵向模式下测试应用兼容性？

若要在这两种模式下测试应用的兼容性，请在 Teams 移动设备上以不同的设备方向运行应用。 确保所有元素（包括按钮、文本和图像）都正确对齐和显示，且没有任何 UI 扭曲或截断。
 

设计在横向模式和纵向模式下都运行良好的应用时，是否有任何最佳做法？ 是的，在设计适用于 Teams 的应用时，必须遵循响应式设计原则，以确保横向和纵向模式下的最佳性能和用户体验。 使用灵活的布局和自适应组件来适应不同的屏幕大小和方向。
 
横向模式是否同时支持 Android 和 iOS Teams 应用？

是的，Android 和 iOS Teams 应用都支持横向模式，从而为跨两个平台的用户提供一致的体验。
 

是否可以针对横向模式和纵向模式以不同的方式自定义应用的行为？

应用的行为在两种模式下保持一致。 但是，如果你有特定的用例或要求，需要在每个模式下使用不同的行为，请联系 支持团队 ，并提供你的反馈和建议。
 

在横向模式下，应用的性能是否有任何影响？

否，Teams 中的横向模式支持不会对应用性能产生任何负面影响。 无论设备方向如何，Teams 都能确保用户的流畅无缝体验。
 

合作伙伴中心

在哪里可以找到 MPN ID？

可以通过提取合作伙伴中心 ID 来查找 MPN ID。
 

我在合作伙伴中心看不到“开发人员”选项卡。如何解决此问题？

如果看不到“开发人员”选项卡，可以在合作伙伴中心提交票证。

有关提交票证的详细信息，请参阅 获取帮助或开具支持票证。
 

如何实现创建合作伙伴中心帐户？

可以通过以下方法之一创建合作伙伴中心帐户：

 

如何在合作伙伴中心查找我的帐户？

开启一个合作伙伴中心支持票证，并选择以下选项：

菜单 选项
类别 商业市场
主题 常规市场帮助和操作方法问题
子标题 Office 加载项

在哪里可以获取合作伙伴中心帐户问题的支持？

请访问发布者支持页面，以搜索你的问题。 如果相应指南无法提供帮助，请创建合作伙伴中心支持票证。
 

如何实现合作伙伴中心管理我的 Microsoft 365 应用商店帐户？

请参阅通过合作伙伴中心管理你的帐户，了解相关信息。
 

我的电话号码没有区号，如何将其添加到我的个人资料？

电话号码由三部分组成：国家/地区代码、区号和电话号码。 如果您的电话号码不包含区号，请将第二个框留空并填写第三个框。
 

如何实现合作伙伴中心管理我的帐户设置和合作伙伴配置文件？

请参阅管理帐户设置和个人资料信息，了解相关信息。
 

当我尝试提交应用时，为什么会看到“此帐户不符合发布条件”消息？

你收到此错误消息是因为帐户的验证状态为待验证。 请在合作伙伴中心的仪表板中检查帐户状态。 选择 “设置” 齿轮图标，然后选择“ 开发人员设置 > ”“帐户 > 设置”。

合作伙伴中心验证状态
 

合作伙伴中心帐户验证过程中会验证哪些内容？

有三个验证领域：电子邮件所有权、雇佣关系和企业验证。 有关详细信息，请参阅验证的内容和相应方式。

如果你是主要联系人、全局管理员或帐户管理员，可以在个人资料页面上监视验证状态并跟踪进度。

验证过程完成后，配置文件页上的注册状态将从 “挂起 ”更改为 “已授权”。 然后，主要联系人会在几个工作日内收到来自 Microsoft 的电子邮件。
 

我的帐户验证状态尚未超过Email所有权。应如何继续？

在电子邮件所有权验证过程中，系统会向主要联系人发送验证电子邮件。 检查主要联系人收件箱中是否存在主题 maccount@microsoft.com 行“ 所需操作”的电子邮件：向 Microsoft 验证电子邮件帐户 并完成电子邮件验证过程。 验证电子邮件将发送到合作伙伴中心帐户设置上列出的地址。

请记住有关电子邮件验证过程的以下几点：

  • 电子邮件验证链接仅在 7 天内有效。
  • 可以请求重新发送该电子邮件，操作方法为：访问合作伙伴个人资料页面并选择“重新发送验证电子邮件”链接。
  • 为了确保收到该电子邮件，请在安全列表中将 microsoft.com 列为安全域并检查垃圾邮件文件夹。

 

我已检查邮件文件夹，但尚未收到验证电子邮件。接下来我该怎么做？

请尝试执行以下步骤：

  • 检查垃圾邮件文件夹。
  • 清除浏览器缓存，转到你的合作伙伴中心帐户仪表板，然后选择“重新发送验证电子邮件”。
  • 尝试从其他浏览器访问“重新发送验证电子邮件”链接。
  • 请与 IT 部门协作，确保电子邮件服务器不会阻止验证电子邮件。
  • 调整服务器的垃圾邮件筛选器，以允许或安全列出来自 maccount@microsoft.com的所有电子邮件。

 

雇佣验证过程通常需要多长时间？

如果提交的所有详细信息都正确无误，则完成雇佣关系验证过程需要大约两个小时。
 

业务验证过程通常需要多长时间？

如果提交了需要的所有文档，则完成企业验证需要一到两个工作日的时间。
 

如果我联系支持团队，是否会加快我的票证？

支持票证将在一周内获得解决。 请适时检查你在创建支持票证时提供的电子邮件地址，看看是否有更新。
 

我创建了支持票证，但七个工作日内没有收到更新。在哪里可以获取帮助？

teamsubm@microsoft.com向 发送电子邮件，其中包含以下详细信息：

  • 主题行：有关应用名称的合作伙伴中心帐户问题。
  • 电子邮件正文：
    • 支持票证编号。
    • 卖家 ID。
    • 问题屏幕截图（如果可能）。

 

还可以在何处获取合作伙伴中心帮助？

以下资源也可以提供帮助：

单一登录

如何在用户调用自适应卡时对其进行验证？

当用户选择按钮时，可以在对话框中打开身份验证页， (TeamsJS v1.x) 中称为任务模块。

可以使用 代码示例 在单击按钮时打开对话框。 可以将 taskInfo.url 替换为身份验证页。


 
如何将 SSO 范围的应用程序 ID URI 更改为使用机器人 ID，以便机器人应用不需要同意窗口？

有关详细信息，请参阅在 Microsoft Entra ID 中配置应用。
 

我想打开一个 iframe，其中包含一个React应用 (，该应用) 在 TeamsJS v1.x) 中称为任务模块的机器人对话 (显示机密信息。你能建议哪种方法是执行此操作的最佳、最简单和标准的方法？

使用 Tab SSO 实现响应页面，并根据需要呈现内容。 可以从机器人打开与对话框相同的选项卡 URL。

有关详细信息，请参阅 为选项卡应用启用 SSO。
 

如何在应用用户登录时避免 SDK 超时错误？

打开登录简单起始页，而不是直接打开登录页来解决问题。
 

如何使用授权类型为authorization_code的终结点 oauth2/v2.0/token 生成访问令牌？

将所使用的应用程序配置为仅执行一次作用域的 HTML 编码，以便Microsoft Entra ID可以正确发送和评估范围。
 

如何使用 React 实现机器人 SSO？

如果使用 Teams 工具包生成应用，请参阅 向 Teams 应用添加单一登录 了解详细信息。

有关 Node js 代码示例的详细信息，请参阅 Bot SSO 快速入门。
 

Stageview


应使用哪个阶段视图？

协作阶段视图允许用户在 Teams 窗口中打开内容以及侧面板对话。 此视图最适合大多数协作方案。


Stageview 模式和对话之间有什么区别？

Stageview 模式可用于向用户显示丰富的内容，例如页面、仪表板或文件。
TeamsJS v1.x) 中称为任务模块 (对话框可用于显示需要用户注意的消息或收集移动到下一步所需的信息。


调用 Stageview 时，内容将在 Collaborative Stageview 中打开，但会加载到“main Teams”窗口中，而不是加载到新窗口中。如何在新窗口中打开内容？

确保域 contentUrl 准确反映在清单 validDomains 属性中。 有关详细信息，请参阅 应用清单架构。


为什么即使 contentUrl 与 validDomains 匹配，也不会在新的 Teams 窗口中显示任何内容？

调用 app.notifySuccess() 所有基于 iframe 的内容，以通知 Teams 应用已成功加载。 如果适用，Teams 会隐藏加载指示器。 如果未 notifySuccess 在 30 秒内调用 ，Teams 会假定应用超时，并显示错误屏幕，其中包含重试选项。 对于应用更新，此步骤适用于已配置的选项卡。 如果不执行此步骤，则会为现有用户显示错误屏幕。


是否可以在 contentUrl 中包含深层链接？

否，在 中 contentUrl不支持深层链接。


如何实现将特定线程与内容一起显示？

深层链接或 stageView API 中的协作阶段视图附带了 附加 threadId 参数。 可以显式定义要在特定 contentUrl侧面板中显示的聊天线程。 有关检索 的详细信息， threadId请参阅 获取会话线程。


选项卡

在从一个选项卡导航到另一个选项卡时，如何使用 deeplink 在移动客户端上获取 subEntityId 或 subPageId？

将 Teams JavaScript 客户端 SDK 升级到 (@microsoft/teams-js“：”^2.0.0“) 解决此问题。
 

如果在应用清单中为特定范围定义了可配置选项卡和静态选项卡，哪个选项卡会被固定？

如果你在应用清单中为特定范围定义了可配置的选项卡和静态选项卡，则默认情况下，Teams 会固定静态选项卡。
 

如果切换到静态选项卡后，我已有预先存在的固定可配置选项卡，该怎么办？

应用的预先存在的固定可配置选项卡实例将继续工作。 无法选择固定这些可配置选项卡的新实例。 选择固定选项卡时，Teams 会固定应用的静态选项卡。

Teams AI 库


Teams AI 库的作用是什么？

Teams AI 库提供抽象，用于构建可靠的应用程序，这些应用程序利用 OpenAI 大型语言模型 (LLM) 。

Microsoft 是否提供 AI 库使用的 OpenAI 模型的托管版本？

否，需要将大型语言模型 (LLM) 托管在 Azure OpenAI 或其他位置。

除了 OpenAI 之外，我们是否可以将 AI 库与其他大型语言模型配合使用？

是的，可以将 Teams AI 库与其他大型语言模型一起使用， (LLM) 。

开发人员是否需要执行任何操作才能从 LLM 中受益？如果是，为什么？

是的，Teams AI 库提供了抽象来简化对话应用程序中大型语言模型 (LLM) 的使用。 但是， (开发人员) 必须根据方案调整提示、主题筛选器和操作。

Teams AI 库如何与 ODSL 集成？

两者是独立的，不能整合。

Teams AI 库如何与开发人员在 Microsoft 365 中为技能生态系统构建的英雄故事共存？

Teams AI 库故事面向专业开发人员，与 Microsoft 365 中围绕技能生态系统的英雄故事分离。

宣布新版本后，应如何传达有关现有 Bot Framework SDK 的信息？

Teams AI 库与现有 Bot Framework SDK 一起使用，不能替代。

Teams 工具包

有关使用 Teams 工具包 预配云资源的 常见问题解答。

如何进行故障排除？

如果在 Visual Studio Code 中遇到 Teams 工具包错误，可以在错误通知中选择“获取帮助”转到相关文档。 如果使用的是 TeamsFx CLI，则错误消息末尾会有一个指向帮助文档的超链接。也可以直接查看预配帮助文档。
 

预配时如何切换到另一个 Azure 订阅？
  1. 在当前帐户中切换订阅或注销并选择新订阅。
  2. 如果已预配当前环境，则需要创建新环境并执行预配，因为 ARM 不支持对资源进行移动。
  3. 如果未预配当前环境，可以直接触发预配。

 

预配时如何更改资源组？

在预配之前，工具包会询问你是要创建新资源组还是使用现有资源组。 你可以在此步骤中提供新的资源组名称或选择现有资源组名称。
 

如何预配基于 SharePoint 的应用？

可以按照预配基于 SharePoint 的应用中的说明操作。

注意

目前，使用 SharePoint 框架 和 Teams 工具包构建 Teams 应用与 Microsoft Entra 管理中心 没有直接集成。 文档中的内容不适用于基于 SPFx 的应用。


 
如何使用 Teams 工具包在 Microsoft Entra ID 中部署代码，并使用 图形 API 获取应用用户的个人资料照片？

使用工具包部署代码的共享引用：

可以调用 图形 API 以获取应用用户的个人资料照片。