Предоставление общего доступа к отзыву:
Мы хотели бы ваши отзывы о документации разработчика Microsoft Teams. Ответьте на наш короткий трехпрошенный опрос.Пройти опрос
Этот браузер больше не поддерживается.
Выполните обновление до Microsoft Edge, чтобы воспользоваться новейшими функциями, обновлениями для системы безопасности и технической поддержкой.
Настройка параметров по умолчанию для приложения Teams
Статья
Приложение обычно поддерживает несколько сценариев в Microsoft Teams, но вы, возможно, разработали его с учетом конкретных область и возможностей. Пользовательский интерфейс Teams помогает пользователям определить область по умолчанию для установки приложения.
Когда пользователь устанавливает приложение из Microsoft Teams Store или отправляет пользовательское приложение, пользователь может открыть приложение в личных или общих область:
Личное область. Если приложение поддерживает личные область, параметр Открыть в диалоговом окне выбора область позволяет открыть приложение в личных область.
Общий область. Если приложение поддерживает общие области, перечислены все поддерживаемые области, такие как канал, чат и собрание, чтобы выбрать необходимые область. Если приложение настроено с область установки по умолчанию, рядом с соответствующим область появится метка "Рекомендуется".
Если основной возможностью вашего приложения является бот, предназначенный для работы в личных область, можно задать функцию по умолчанию в качестве бота, а также задать область по умолчанию как личную.
Настройка область установки приложения по умолчанию
Вы можете использовать область установки по умолчанию, чтобы указать, доступно ли ваше приложение для личных, каналов, чатов или собраний. При настройке область установки по умолчанию можно задать только один область за раз. Дополнительные сведения см. в манифесте приложения.
Чтобы настроить область установки по умолчанию в манифесте приложения, выполните следующие действия:
Откройте манифест приложения и добавьте defaultInstallScope свойство .
Задайте значение установки по умолчанию область значение personal, , teamgroupChatили meetings.
JSON
"defaultInstallScope": "meetings",
Пользовательский интерфейс установки приложения
Установка приложения в пределах настроенных область установки по умолчанию, таких как личные, каналы, чат или собрания, выполняется быстро и просто. В следующих процедурах описывается пользовательский поток для установки приложения в настроенном область.
Только личные область
Если приложение настроено только с личными область, ниже приведен поток пользователя для добавления приложения:
Перейдите в раздел Приложения .
Найдите и выберите приложение, которое требуется установить.
В диалоговом окне сведений о приложении выберите Добавить.
При добавлении приложения появится диалоговое окно, чтобы открыть приложение в личных область.
Выберите Открыть. Приложение открывается в личных область.
Личные и общие области
Если для приложения настроены личные и общие области, а также область установки по умолчанию, ниже приведен поток пользователя для добавления приложения в необходимый область:
Перейдите в раздел Приложения .
Найдите и выберите приложение, которое требуется установить.
В диалоговом окне сведений о приложении выберите Добавить.
При добавлении приложения появляется диалоговое окно для выбора область.
Выберите Открыть, чтобы открыть приложение в личных область.
Кроме того, можно выбрать один из рекомендуемых область или выполнить поиск и выбрать необходимый общий область, а затем перейти через диалоговое окно, чтобы выбрать Перейти.
Приложение откроется в выбранном область.
Примечание
Кнопка "Рекомендуется" указывает область, в котором приложение обеспечивает оптимальный интерфейс использования.
Параметр Просмотреть больше содержит список параметров канала, чата или собрания, доступных для пользователя.
Общие область
Если приложение настроено с общими областями вместе с область установки по умолчанию, вот поток пользователя для добавления приложения в необходимый область:
Перейдите в раздел Приложения .
Найдите и выберите приложение, которое требуется установить.
В диалоговом окне сведений о приложении выберите Добавить.
При добавлении приложения появляется диалоговое окно для выбора область.
Выберите из рекомендуемого область или выполните поиск, выберите необходимый общий область, а затем перейдите по диалоговому окку, чтобы выбрать Перейти.
Приложение откроется в выбранном область.
Настройка возможности по умолчанию для общих областей
Настройте возможность по умолчанию при установке приложения для команды, собрания или группового чата. Дополнительные сведения см. в манифесте приложения.
Примечание
defaultGroupCapability предоставляет возможность по умолчанию, добавленную в команду, групповой чат или собрание. Выберите вкладку, бота или соединитель в качестве возможности по умолчанию для приложения, но необходимо убедиться, что выбранная возможность указана в определении приложения.
Чтобы настроить сведения в манифесте приложения, выполните следующие действия:
Откройте манифест приложения и добавьте в defaultGroupCapability него свойство .
Задайте значение team, groupchatили meetings.
Для выбранной возможности группы доступны возможности botгруппы , tabили connector.
Примечание
Вы можете выбрать только одну возможность по умолчанию, bot, tabили connector для выбранной возможности группы.
Настройка целевой возможности приложения по умолчанию
Вы можете настроить целевую возможность по умолчанию для приложения, которое поддерживает возможности бота и вкладки в личных область. В зависимости от этой конфигурации приложение по умолчанию открывается в виде бота или вкладки.
Бот выступает в качестве целевой возможности по умолчанию, если его область определен как личный, даже если вы не указываете entityId как conversations в staticTabs свойстве .
В следующем примере показано открытие приложения с ботом в качестве целевой возможности по умолчанию и способ перехода пользователя на вкладку:
В следующем примере показано открытие приложения с вкладкой в качестве целевой возможности по умолчанию и способ перехода пользователя на бот:
Откройте манифест приложения.
В разделе staticTabs свойство добавьте свойства вкладки в качестве первой записи массива. Сведения об определении свойств вкладки см. в разделе Манифест приложения.
Следующий фрагмент кода является примером настройки вкладки в качестве целевой возможности по умолчанию для мобильных устройств:
Tab выступает в качестве целевой возможности по умолчанию в мобильных устройствах, даже если вы не указываете entityId как conversations в свойстве staticTabs .
В следующем примере показано, как открыть приложение с вкладкой в качестве целевой возможности по умолчанию и как пользователь может перейти на бот для:
Блокировать приложения по умолчанию для пользователей, пока администратор не утвердит
Чтобы улучшить пользовательский интерфейс приложения Teams, ИНОГДА ИТ-администраторы должны вмешиваться, прежде чем пользователи будут использовать приложение. Например, рассмотрим приложение службы поддержки, созданное Contoso Electronics для Teams. Чтобы обеспечить правильную работу приложения, Contoso Electronics хочет, чтобы клиенты сначала настраивали определенные свойства приложения.
Чтобы ит-администраторы выполняли соответствующие задачи, разработчики могут блокировать приложение для пользователей, пока администратор не разрешает приложение. Чтобы заблокировать приложение по умолчанию, присвойте свойству defaultBlockUntilAdminAction значение true в файле манифеста приложения. Если для свойства задано значение true, состояние приложения в Центре администрирования Teams будет заблокировано издателем на странице Управление приложениями .
Администраторы могут выполнить тщательную проверку вашего приложения и прочитать документацию по приложению, которую вы предоставляете, прежде чем разрешить пользователям использовать ваше приложение. Например, администраторы могут приобрести необходимые лицензии и распространить лицензии, прежде чем разрешить пользователям использовать приложение. Чтобы разрешить приложение с состоянием Заблокировано издателем , администратор может выбрать Разрешить на странице Управление приложениями в Центре администрирования Teams.
Если вы не хотите, чтобы приложение было заблокировано по умолчанию, обновите defaultBlockUntilAdminAction параметр false до и отправьте обновленное приложение для публикации. После публикации новой версии приложения она будет разрешена по умолчанию.
Примечание
Для пользовательских приложений, созданных для вашей организации, defaultBlockUntilAdminAction не поддерживается. Если вы отправляете пользовательское приложение, созданное для вашей организации, с помощью этого свойства приложение не блокируется.
Пример кода
Название примера
Описание
.NET
Node.js
Манифест
мир Hello
В этом примере показано, как настроить целевую возможность по умолчанию для приложения, которое поддерживает возможности бота и вкладки в личных область.
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Отзыв о Platform Docs
Platform Docs — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:
Продемонстрировать навыки для планирования, развертывания, настройки и управления Microsoft Teams, чтобы сосредоточиться на эффективной и эффективной совместной работе и взаимодействии в среде Microsoft 365.