Предоставление общего доступа к отзыву:
Мы хотели бы ваши отзывы о документации разработчика Microsoft Teams. Ответьте на наш короткий трехпрошенный опрос.Пройти опрос
Этот браузер больше не поддерживается.
Выполните обновление до Microsoft Edge, чтобы воспользоваться новейшими функциями, обновлениями для системы безопасности и технической поддержкой.
Начиная с версии 2.0.0 клиентская библиотека JavaScript (TeamsJS) Microsoft Teams позволяет определенным типам приложений Teams работать в экосистеме Microsoft 365. Приложения Microsoft 365, в которых могут размещаться приложения Teams (приложения Microsoft 365 и Outlook), поддерживают только подмножество типов приложений и возможностей, которые можно создать для платформы Teams. Эта поддержка со временем расширяется.
В этой статье подробно описан уровень поддержки возможностей TeamsJS версии 2.x в различных ведущих приложениях. Дополнительные сведения об изменениях в TeamsJS версий 1.x и 2.x см. в статье Новые возможности TeamsJS версии 2.x.x.
В следующей таблице Возможности TeamsJS перечислены возможности TeamsJS (общедоступные пространства имен) и их поддержка в ведущих приложениях Microsoft 365. Некоторые возможности помечаются значками "Не рекомендуется" или "Предварительный просмотр ", которые имеют следующее значение:
Значок
Смысл
Эта возможность доступна в предварительной версии и может быть изменена в зависимости от отзывов. Не используйте эту возможность в рабочей среде.
Эта возможность не рекомендуется использовать в пользу более новых функций, хотя она поддерживается в целях обратной совместимости. Для новых приложений используйте функцию, рекомендуемую в заметках об использовании устаревшей возможности.
Узлы Microsoft 365 обозначаются значками продуктов в следующей таблице:
Teams
Приложение Microsoft 365
Outlook
Примечание
Приложение Microsoft 365 (Office) переименовано в приложение Microsoft 365 Copilot. Значок приложения также меняется: с на . Обновления к пользовательскому интерфейсу приложения и значку находятся в процессе развертывания.
В следующих таблицах выберите любую возможность TeamsJS для получения дополнительных сведений, включая справочную документацию, примеры, заметки об использовании и ограничения.
Примечание
Сведения в следующих таблицах являются производными от тестов, проведенных в TeamsJS версии 2.24, и последних версий узлов, доступных во время тестирования. Поддержка может отличаться в зависимости от последующих изменений узла. Эти таблицы помогают понять поддержку возможностей на разных узлах, однако всегда использовать соответствующие isSupported() вызовы в коде для проверки поддержки.
Возможности между узлами
В следующей таблице приведена поддержка ведущих приложений для возможностей TeamsJS, которые могут выполняться за пределами Teams.
Предварительный просмотр возможностей, ожидающих поддержки узла
Некоторые возможности в источнике находятся в ранней предварительной версии и по-прежнему ожидают начальной поддержки в одном или нескольких ведущих приложениях, включая штрихкод, мультимедиа и собрание.
Далее в этой статье вы найдете дополнительные сведения о каждой возможности клиентской библиотеки Teams JavaScript.
Пространство имен для взаимодействия с частью библиотеки, связанной с проверкой подлинности. Этот модуль используется для запуска или завершения потоков проверки подлинности.
Пространство authentication имен поддерживается глобально на всех узлах приложений и, следовательно, не имеет isSupported функции.
Предварительный просмотр. Эта группа возможностей позволяет приложениям отображать модальные диалоги (называемые модулями задач в TeamsJS версии 1.x). Существует два основных типа диалогов: диалоги на основе URL-адресов и диалоговые окна адаптивной карточки. Оба типа диалоговых окон отображаются поверх приложения, что предотвращает взаимодействие с приложением во время их отображения.
Диалоговые окна на основе URL-адресов позволяют указать URL-адрес, из которого содержимое отображается в диалоговом окне. Для диалоговых окон URL-адресов используйте функции и интерфейсы в пространстве имен URL-адреса.
Диалоговые окна на основе адаптивных карточек позволяют предоставить JSON с описанием адаптивной карточки, которая отображается в диалоговом окне. Для диалоговых окон адаптивной карточки используйте функции и интерфейсы в пространстве имен adaptiveCard.
Предварительный просмотр. Пространство имен, предоставляющее функциональные возможности, связанные с расположением. Это более новая версия модуля расположения.
Возможности, требующие предоставления пользователем разрешений устройства (например , geoLocation), частично поддерживаются для приложений, работающих за пределами Teams. Пользователи могут настраивать разрешения приложения из заголовка приложения при запуске в Outlook и приложении Microsoft 365 или из параметров приложения на мобильных устройствах. Рекомендуется изменить код, чтобы проверка поддержки Outlook и Microsoft 365:
Вызовите isSupported возможность перед ее использованием.
Перехват и обработка ошибок при вызове API TeamsJS и HTML5
Если API не поддерживает или создает ошибку, добавьте логику для сбоя или предоставьте обходной путь. Например:
Перенаправление пользователя на веб-сайт приложения
Указание пользователю использовать приложение в Teams для завершения потока
Уведомление пользователя о том, что функциональность еще недоступна
Совет
Убедитесь, что манифест приложения указывает только разрешения устройства, которые он использует.
Устарело. Пространство имен, предоставляющее функциональные возможности, связанные с расположением (получение и отображение расположения). Используйте geoLocation для новых приложений.
Пространство имен для взаимодействия с частью библиотеки, связанной с меню. Этот модуль используется для отображения конфигурации представления, меню действий и меню панели навигации.
До версии TeamsJS 2.0 все сценарии глубокого связывания обрабатывались с помощью shareDeepLink (для создания ссылки на определенную часть приложения) и executeDeepLink (для перехода по глубокой ссылке из приложения или внутри приложения). TeamsJS версии 2.0 представляет новый API для navigateToAppперехода по страницам (и вложенным страницам) в приложении в согласованном режиме между узлами приложений (приложение Microsoft 365 и Outlook, в дополнение к Teams). Для новых приложений следуйте обновленным рекомендациям в зависимости от сценария навигации:
Подробные ссылки на приложение. Используйте функцию pages.shareDeepLink (в версиях TeamsJS ниже 2.0 называемую также shareDeepLink) для создания и вывода ссылки, которую пользователь может скопировать и поделиться ею. Если этот параметр выбран, пользователю будет предложено установить приложение, если оно еще не установлено для узла приложения.
Эти API эквивалентны переходу по глубокой ссылке (как когда-то использовался устаревший executeDeepLink ), не требуя от приложения создания URL-адреса или управления различными форматами глубоких ссылок для разных узлов приложений.
Глубокие ссылки из приложения. Для получения подробных ссылок из приложения на различные области его текущего узла используйте типизированные API, предоставляемые библиотекой TeamsJS. Например, используйте calendar возможность, чтобы открыть диалоговое окно планирования или элемент календаря из приложения.
Для прямых ссылок из приложения в другие приложения, работающие в том же размещении, используйте pages.navigateToApp.
Для любых других внешних сценариев глубокой компоновки можно использовать функции, app.openLinkаналогичные устаревшим (начиная с TeamsJS версии 2.0) API executeDeepLink.
Предоставляет API-интерфейсы для взаимодействия с частью пакета SDK для конкретной конфигурации. Этот объект можно использовать только в кадре конфигурации.
Предоставляет API-интерфейсы для запросов и перехода между контекстными вкладками приложения. В отличие от личных вкладок, контекстные вкладки — это страницы, связанные с определенным контекстом, например каналом или чатом.
Предварительный просмотр. Позволяет приложению взаимодействовать с полем поиска ведущего приложения Microsoft 365. Интеграция приложения с полем поиска узла позволяет пользователям выполнять поиск в приложении с помощью того же поля поиска, что и в других приложениях Teams, Outlook или Microsoft 365.
Предварительный просмотр. Пространство имен, поддерживающее интерфейс браузера ведущем приложении. Например, открытие URL-адреса в ведущем приложении в браузере.
Более ранняя версия возможности предоставления модальных диалогов (называемых модулями задач в TeamsJS версии 1.x) поддерживает версии, предшествующие TeamsJS версии 2.8.0. Для новых приложений используйте возможность диалогового окна .
Web
Версия для настольного компьютера
Мобильная версия
Windows
Android
iOS
✓
✓
✓
✓
Примечание
Метод task.getDefaultSizeIfNotProvided не поддерживается в мобильном клиенте Teams.
Источник этого содержимого можно найти на GitHub, где также можно создавать и просматривать проблемы и запросы на вытягивание. Дополнительные сведения см. в нашем руководстве для участников.
Отзыв о Platform Docs
Platform Docs — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв:
Клиентская библиотека JavaScript в Microsoft Teams поможет интегрировать собственные функции Teams прямо в приложение. В этом модуле вы узнаете, как интегрировать возможность чата Teams в приложение с помощью клиентской библиотеки JavaScript для Teams.