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

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

Когда пользователь устанавливает приложение из Microsoft Teams Store или отправляет пользовательское приложение, пользователь может открыть приложение в личных или общих область:

• Личное область. Если приложение поддерживает личные область, параметр Открыть в диалоговом окне выбора область позволяет открыть приложение в личных область.

• Общий область. Если приложение поддерживает общие области, перечислены все поддерживаемые области, такие как канал, чат и собрание, чтобы выбрать необходимые область. Если приложение настроено с область установки по умолчанию, рядом с соответствующим область появится метка "Рекомендуется".

  

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

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

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

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

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

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

   "defaultInstallScope": "meetings",
   

Пользовательский интерфейс установки приложения

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

Только личные область

Если приложение настроено только с личными область, ниже приведен поток пользователя для добавления приложения:

1. Перейдите в раздел Приложения .

2. Найдите и выберите приложение, которое требуется установить.

3. В диалоговом окне сведений о приложении выберите Добавить.

   

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

4. Выберите Открыть. Приложение открывается в личных область.

   

Личные и общие области

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

1. Перейдите в раздел Приложения .

2. Найдите и выберите приложение, которое требуется установить.

3. В диалоговом окне сведений о приложении выберите Добавить.

   

   При добавлении приложения появляется диалоговое окно для выбора область.

4. Выберите Открыть, чтобы открыть приложение в личных область.

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

   

   Приложение откроется в выбранном область.

   Примечание.

   • Кнопка "Рекомендуется" указывает область, в котором приложение обеспечивает оптимальный интерфейс использования.
   • Параметр Просмотреть больше содержит список параметров канала, чата или собрания, доступных для пользователя.

Общие область

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

1. Перейдите в раздел Приложения .

2. Найдите и выберите приложение, которое требуется установить.

3. В диалоговом окне сведений о приложении выберите Добавить.

   

   При добавлении приложения появляется диалоговое окно для выбора область.

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

   

   Приложение откроется в выбранном область.

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

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

Примечание.

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

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

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

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

3. Для выбранной возможности группы доступны возможности botгруппы , tabили 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	В этом примере показано, как настроить целевую возможность по умолчанию для приложения, которое поддерживает возможности бота и вкладки в личных область.	Просмотр	Просмотр	Просмотр

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

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