Настройка параметров по умолчанию для приложения Teams

Обычно приложение поддерживает несколько сценариев в Teams, но вы, возможно, разработали его с учетом определенных область и возможностей. Например, если ваше приложение в основном предназначено для команды или канала, вы можете убедиться, что первый вариант установки, который пользователи видят в Microsoft Teams Store, — Добавить в команду.

Если основной возможностью приложения является бот, вы также можете сделать бот возможностью по умолчанию, когда пользователь устанавливает приложение в команду.

Настройка область установки приложения по умолчанию

Настройте область установки по умолчанию для приложения. Одновременно можно задать только одну область. Дополнительные сведения см. в манифесте приложения.

Чтобы настроить область установки по умолчанию в манифесте приложения, выполните следующие действия:

1. Откройте манифест приложения и добавьте defaultInstallScope свойство .

2. Задайте значение установки область по умолчанию: personal, team, groupchatили meetings.

   "defaultInstallScope": "meetings",
   

Настройка возможности по умолчанию для общих областей

Настройте возможность по умолчанию при установке приложения для команды, собрания или группового чата. Дополнительные сведения см. в манифесте приложения.

Примечание.

defaultGroupCapability предоставляет возможность по умолчанию, добавленную в команду, групповой чат или собрание. Выберите вкладку, бота или соединитель в качестве возможности по умолчанию для приложения, но необходимо убедиться, что выбранная возможность указана в определении приложения.

Чтобы настроить сведения в манифесте приложения, выполните следующие действия:

1. Откройте манифест приложения и добавьте в defaultGroupCapability него свойство .

2. Задайте значение team, groupchatили meetings.

3. Для выбранной возможности группы доступны следующие возможности: , bottabили connector.

   Примечание.

   Вы можете выбрать только одну возможность по умолчанию, bot, tabили connector для выбранной возможности группы.

   "defaultGroupCapability": {
       "team": "bot",
       "groupchat": "bot",
       "meetings": "tab"
   }
   

Настройка целевой возможности приложения по умолчанию

Вы можете настроить целевую возможность по умолчанию для приложения, которое поддерживает возможности бота и вкладки в личных область. В зависимости от этой конфигурации приложение по умолчанию открывается в виде бота или вкладки.

Можно настроить одно из следующих действий:

• Бот в качестве целевой возможности по умолчанию
• Вкладка в качестве целевой возможности по умолчанию

Бот в качестве целевой возможности по умолчанию

Настройте приложение для открытия в качестве бота по умолчанию:

Компьютер

1. Откройте манифест приложения.

2. В свойстве bots определите scopes как personal.

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

Примечание.

Бот выступает в качестве целевой возможности по умолчанию, если его область определен как личный, даже если вы не указываете entityId как conversations в staticTabs свойстве .

В следующем примере показано открытие приложения с ботом в качестве целевой возможности по умолчанию и способ перехода пользователя на вкладку:

Мобильные устройства

1. Откройте манифест приложения.

2. В свойстве bots определите scopes как personal.

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

3. В свойстве staticTabs :

   1. Добавьте следующие свойства в качестве первой записи массива:
      1. Определите entityId как conversations.
      2. Определите scopes как personal.
   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

  Приложение открывается по умолчанию как бот. Пользователь может перейти на вкладку, нажав кнопку "Назад" или потянув вниз наложение бота.

  

Вкладка в качестве целевой возможности по умолчанию

Настройте приложение для открытия в виде вкладки по умолчанию:

Компьютер

1. Откройте манифест приложения.
2. В свойстве staticTabs :
   1. Добавьте свойства вкладки в качестве первой записи массива. Сведения об определении свойств вкладки см. в разделе Манифест приложения.
   2. Добавьте следующие свойства:
      1. Определите entityId как conversations.
      2. Определите scopes как personal.

Следующий фрагмент кода является примером настройки вкладки в качестве целевой возможности по умолчанию:

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

В следующем примере показано открытие приложения с вкладкой в качестве целевой возможности по умолчанию и способ перехода пользователя на бот:

Мобильные устройства

1. Откройте манифест приложения.
2. В разделе staticTabs свойство добавьте свойства вкладки в качестве первой записи массива. Сведения об определении свойств вкладки см. в разделе Манифест приложения.

Следующий фрагмент кода является примером настройки вкладки в качестве целевой возможности по умолчанию для мобильных устройств:

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

Примечание.

Tab выступает в качестве целевой возможности по умолчанию в мобильных устройствах, даже если вы не указываете entityId как conversations в свойстве staticTabs .

В следующем примере показано, как открыть приложение с вкладкой в качестве целевой возможности по умолчанию и как пользователь может перейти на бот для:

• Android

• iOS

  Android

  Приложение открывается по умолчанию в виде вкладки. Пользователь может перейти к боту с помощью значка бота, доступного в правом верхнем углу.

  

  iOS

  Приложение открывается по умолчанию в виде вкладки. Пользователь может перейти к боту с помощью значка бота, доступного в правом верхнем углу.

  

---

Свойство staticTabs также используется для закрепления личных вкладок и изменения порядка вкладок. Дополнительные сведения см. в манифесте приложения.

Блокировать приложения по умолчанию для пользователей, пока администратор не утвердит

Чтобы улучшить пользовательский интерфейс приложения Teams, ИНОГДА ИТ-администраторы должны вмешиваться, прежде чем пользователи будут использовать приложение. Например, рассмотрим приложение службы поддержки, созданное Contoso Electronics для Teams. Чтобы обеспечить правильную работу приложения, Contoso Electronics хочет, чтобы клиенты сначала настраивали определенные свойства приложения.

Чтобы ит-администраторы выполняли соответствующие задачи, разработчики могут блокировать приложение для пользователей, пока администратор не разрешает приложение. Чтобы заблокировать приложение по умолчанию, присвойте свойству defaultBlockUntilAdminAction значение true в файле манифеста приложения. Если для свойства задано значение true, состояние приложения в Центре администрирования Teams будет заблокировано издателем на странице Управление приложениями .

Администраторы могут выполнить тщательную проверку вашего приложения и прочитать документацию по приложению, которую вы предоставляете, прежде чем разрешить пользователям использовать ваше приложение. Например, администраторы могут приобрести необходимые лицензии и распространить лицензии, прежде чем разрешить пользователям использовать приложение. Чтобы разрешить приложение с состоянием Заблокировано издателем , администратор может выбрать Разрешить на странице Управление приложениями в Центре администрирования Teams.

Если вы не хотите, чтобы приложение было заблокировано по умолчанию, обновите defaultBlockUntilAdminAction параметр false до и отправьте обновленное приложение для публикации. После публикации новой версии приложения она будет разрешена по умолчанию.

Примечание.

Для пользовательских приложений, созданных для вашей организации, defaultBlockUntilAdminAction не поддерживается. Если вы отправляете пользовательское приложение, созданное для вашей организации, с помощью этого свойства приложение не блокируется.

Пример кода

Название примера	Описание	.NET	Node.js	Манифест
мир Hello	В этом примере показано, как настроить целевую возможность по умолчанию для приложения, которое поддерживает возможности бота и вкладки в личных область.	Просмотр	Просмотр	Просмотр

Следующий этап

Создание пакета приложения