配置 Teams 应用的默认选项

项目
11/18/2024

应用通常支持 Teams 中的多个方案，但你可能在设计时考虑了特定的范围和功能。例如，如果你的应用主要用于团队或频道，你可以确保用户在 teams 应用商店中看到的第一个安装选项Microsoft是 “添加到团队”。

屏幕截图显示“添加到团队”选项。

如果应用的主要功能是机器人，也可以在用户将应用安装到团队时将机器人设为默认功能。

配置应用的默认安装范围

为应用配置默认安装范围。一次只能设置一个范围。有关详细信息，请参阅应用清单。

若要在应用清单中配置默认安装范围，请执行以下操作：

打开应用清单并添加 defaultInstallScope 属性。
将默认安装范围值设置为 personal、 team、 groupchat或 meetings。
```
"defaultInstallScope": "meetings",
```

配置共享范围的默认功能

为团队、会议或群聊安装应用时，配置默认功能。有关详细信息，请参阅应用清单。

注意

defaultGroupCapability 提供添加到团队、群组聊天或会议的默认功能。选择选项卡、机器人或连接器作为应用的默认功能，但必须确保已在应用定义中提供了所选功能。

若要在应用清单中配置详细信息，请执行以下操作：

打开应用清单并 defaultGroupCapability 向其添加属性。
将值 team设置为、 groupchat或 meetings。
对于所选组功能，可用的组功能为、bottab、或 connector。

注意

只能为所选组功能 bot选择一个默认功能、、 tab或 connector 。
```
"defaultGroupCapability": {
    "team": "bot",
    "groupchat": "bot",
    "meetings": "tab"
}
```

配置应用的默认登陆功能

可以为支持个人范围内的机器人和选项卡功能的应用配置默认登陆功能。根据此配置，应用默认以机器人或选项卡的形式打开。

可以配置以下任一项：

机器人作为默认登陆功能
Tab 作为默认登陆功能

机器人作为默认登陆功能

默认情况下，将应用配置为以机器人身份打开：

桌面设备
移动设备

打开应用清单。

在属性下bots，定义为 personalscopes 。

"bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

注意

如果机器人的范围定义为个人，则机器人将充当默认登陆功能，即使未在属性中staticTabs指定entityId为 conversations 。

以下示例演示如何使用机器人作为默认登陆功能打开应用，以及用户如何转换到选项卡：

该图显示了使用机器人作为默认登陆功能打开应用的过程。

打开应用清单。

在属性下bots，定义为 personalscopes 。

"bots": [
    {
        "botId":"<botId>",
        "scopes": [
        "personal"
        ]

在属性下 staticTabs ：
1. 添加以下属性作为数组的第一个条目：
  1. conversations定义为 entityId 。
  2. personal定义为 scopes 。
2. 添加应用清单中定义的选项卡属性。

以下代码片段是将机器人配置为移动版的默认登陆功能的示例：

"staticTabs":[
     {
        "entityId":"conversations",
        "scopes":[
           "personal"
        ]
     },
     {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   }
]

以下示例演示如何使用机器人作为默认登陆功能打开应用，以及用户如何转换到选项卡：

Android 客户端
iOS 客户端
- Android
- iOS
默认情况下，应用将作为机器人打开。用户可以使用右上角提供的选项卡图标转换到选项卡。

默认情况下，应用将作为机器人打开。用户可以通过选择后退按钮或拉下机器人覆盖层来转换到选项卡。

Tab 作为默认登陆功能

将应用配置为默认以选项卡的形式打开：

桌面设备
移动设备

打开应用清单。
在属性下 staticTabs ：
1. 将选项卡属性添加为数组的第一个条目。若要定义选项卡属性，请参阅应用清单。
2. 添加下列属性：
  1. conversations定义为 entityId 。
  2. personal定义为 scopes 。

以下代码片段是将选项卡设置为默认登陆功能的示例：

"staticTabs": [
   {
       "entityId": "com.contoso.helloworld.hellotab",
       "name": "Hello Tab",
       "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
       "scopes": [
           "personal"
       ]
   },
   {
       "entityId":"conversations",
        "scopes":[
           "personal"
        ]
   }
]

以下示例演示如何打开具有选项卡作为默认登陆功能的应用，以及用户如何转换到机器人：

该图显示了使用选项卡作为默认登陆功能打开应用的过程。

打开应用清单。
在“属性”下 staticTabs ，添加选项卡属性作为数组的第一个条目。若要定义选项卡属性，请参阅应用清单。

以下代码片段是将选项卡设置为移动版的默认登陆功能的示例：

 "staticTabs":[
      {
        "entityId": "com.contoso.helloworld.hellotab",
        "name": "Hello Tab",
        "contentUrl": "https://p4p9bji0-7130.inc1.devtunnels.ms/hello",
        "scopes": [
            "personal"
        ]
    }
 ]

注意

Tab 充当移动版中的默认登陆功能，即使未在属性中staticTabs指定 entityId 为 conversations 。

以下示例演示如何打开具有选项卡作为默认登陆功能的应用，以及用户如何转换为机器人：

Android
iOS
- Android
- iOS
默认情况下，应用以选项卡的形式打开。用户可以使用右上角提供的机器人图标转换到机器人。

默认情况下，应用以选项卡的形式打开。用户可以使用右上角提供的机器人图标转换到机器人。

属性 staticTabs 还用于固定个人选项卡和重新排序选项卡。有关详细信息，请参阅应用清单。

默认情况下，在管理员批准之前阻止用户的应用

为了增强 Teams 应用的用户体验，有时，IT 管理员必须在用户使用应用之前进行干预。例如，请考虑由 Contoso Electronics for Teams 创建的技术支持应用。为确保应用正常运行，Contoso Electronics 希望客户首先配置应用的特定属性。

为了确保 IT 管理员执行相关任务，开发人员可以阻止用户的应用，直到管理员允许该应用为止。若要默认阻止应用，请在 defaultBlockUntilAdminAction 应用清单文件中将属性 true 设置为。当属性设置为 true时，Teams 管理中心中的应用状态为“管理应用”页中的发布者阻止。

管理员可以对你的应用进行尽职调查，并且可以在允许用户使用你的应用之前阅读你提供的应用文档。例如，管理员可以在允许用户使用应用之前购买所需的许可证并分发许可证。若要允许发布者状态为“已阻止”的应用，管理员可以在 Teams 管理中心的“管理应用”页中选择“允许”。

如果不希望默认情况下阻止你的应用，请将设置更新 defaultBlockUntilAdminAction 为 false 并提交更新的应用以供发布。发布新版本的应用后，默认允许该版本。

注意

对于为组织生成的自定义应用， defaultBlockUntilAdminAction 不支持。如果使用此属性上传为组织生成的自定义应用，则不会阻止该应用。

代码示例

示例名称	说明	.NET	Node.js	清单
Hello世界	此示例演示如何为支持个人范围内的机器人和选项卡功能的应用配置默认登陆功能。	View	View	View

后续步骤

创建应用包

通过