Поддержка возможностей TeamsJS в Microsoft 365

Начиная с версии 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. Значок приложения также меняется: с на . Обновления к пользовательскому интерфейсу приложения и значку находятся в процессе развертывания.

Дополнительные сведения о новых Teams и Outlook см. в блоге Outlook и внедрении Teams.

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

Примечание.

Сведения в следующих таблицах являются производными от тестов, проведенных в TeamsJS версии 2.24, и последних версий узлов, доступных во время тестирования. Поддержка может отличаться в зависимости от последующих изменений узла. Эти таблицы помогают понять поддержку возможностей на разных узлах, однако всегда использовать соответствующие isSupported() вызовы в коде для проверки поддержки.

Возможности между узлами

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

Возможности TeamsJS	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
приложение	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓
authentication	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
calendar				✓				✓	✓			✓			✓
call	✓	✓		✓	✓	✓			✓	✓			✓
	✓	✓		✓	✓	✓			✓	✓			✓
		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓
	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
Значок geoLocation		✓	✓			✓	✓	✓
mail				✓				✓	✓						✓
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
значок профиля		✓		✓		✓		✓	✓
Значок поиска	✓	✓		✓	✓	✓		✓	✓
Значок secondaryBrowser											✓	✓		✓	✓

Возможности, доступные только для Teams

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

Возможности TeamsJS	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
значок appInitialization	✓				✓					✓			✓
Значок расположения	✓	✓			✓	✓				✓			✓
Меню					✓					✓			✓
people	✓	✓			✓	✓				✓			✓
Значок параметров	✓				✓					✓			✓
деление	✓	✓			✓	✓				✓			✓
этапПросмотр	✓	✓			✓	✓
Значок tasks	✓				✓					✓			✓
teamsCore	✓	✓			✓	✓				✓			✓
Значок видео										✓			✓
значок webStorage					✓					✓			✓

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

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

Далее в этой статье вы найдете дополнительные сведения о каждой возможности клиентской библиотеки Teams JavaScript.

app

Ссылка | Известные проблемы

Пространство имен для взаимодействия с инициализацией и жизненным циклом приложения.

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
приложение	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

appInitialization

Ссылка | Известные проблемы

Устарело. Пространство имен для инициализации приложения. Для новых приложений используйте app.initialize() из возможности приложения .

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
значок appInitialization	✓				✓					✓			✓

appInstallDialog

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
appInstallDialog	✓	✓	✓		✓	✓	✓			✓			✓

authentication

Ссылка | Известные проблемы

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

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
authentication	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓

barCode

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS

calendar

Ссылка | Известные проблемы

Пространство имен, предоставляющее функциональные возможности, связанные с календарем.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
calendar				✓				✓	✓			✓			✓

call

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
call	✓	✓		✓	✓	✓			✓	✓			✓

chat

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓	✓		✓	✓	✓			✓	✓			✓

clipboard

Reference

Предварительный просмотр. Эта возможность позволяет пользователям копировать и вставлять данные в системный буфер обмена.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
		✓	✓	✓		✓	✓	✓	✓		✓			✓	✓

dialog

Ссылка | Известные проблемы

Предварительный просмотр. Эта группа возможностей позволяет приложениям отображать модальные диалоги (называемые модулями задач в TeamsJS версии 1.x). Существует два основных типа диалогов: диалоги на основе URL-адресов и диалоговые окна адаптивной карточки. Оба типа диалоговых окон отображаются поверх приложения, что предотвращает взаимодействие с приложением во время их отображения.

• Диалоговые окна на основе URL-адресов позволяют указать URL-адрес, из которого содержимое отображается в диалоговом окне. Для диалоговых окон URL-адресов используйте функции и интерфейсы в пространстве имен URL-адреса.
• Диалоговые окна на основе адаптивных карточек позволяют предоставить JSON с описанием адаптивной карточки, которая отображается в диалоговом окне. Для диалоговых окон адаптивной карточки используйте функции и интерфейсы в пространстве имен adaptiveCard.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
dialog.adaptiveCard		✓	✓			✓	✓	✓		✓			✓
dialog.adaptiveCard.bot		✓				✓		✓		✓			✓
индикатор dialog.update	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
индикатор dialog.url	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓			✓
dialog.url.bot	✓	✓		✓	✓	✓		✓	✓	✓			✓

dialog.adaptiveCard

Ссылка | Известные проблемы

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

dialog.adaptiveCard.bot

Ссылка | Известные проблемы

Предварительный просмотр. Возможность взаимодействия с диалогами адаптивных карточек, которые должны взаимодействовать с Bot Framework.

dialog.update

Ссылка | Известные проблемы

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

dialog.url

Ссылка | Известные проблемы

Предварительный просмотр. Возможность взаимодействия с диалогами на основе HTML.

dialog.url.bot

Ссылка | Известные проблемы

Предварительный просмотр. Возможность взаимодействия с диалогами на основе HTML, которые должны взаимодействовать с Bot Framework.

geoLocation

Ссылка | Известные проблемы

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

Возможности, требующие предоставления пользователем разрешений устройства (например , geoLocation), частично поддерживаются для приложений, работающих за пределами Teams. Пользователи могут настраивать разрешения приложения из заголовка приложения при запуске в Outlook и приложении Microsoft 365 или из параметров приложения на мобильных устройствах. Рекомендуется изменить код, чтобы проверка поддержки Outlook и Microsoft 365:

• Вызовите isSupported возможность перед ее использованием.
• Перехват и обработка ошибок при вызове API TeamsJS и HTML5

Если API не поддерживает или создает ошибку, добавьте логику для сбоя или предоставьте обходной путь. Например:

• Перенаправление пользователя на веб-сайт приложения
• Указание пользователю использовать приложение в Teams для завершения потока
• Уведомление пользователя о том, что функциональность еще недоступна

Совет

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
		✓	✓			✓	✓	✓
Эмблема geoLocation.map		✓				✓

geoLocation.map

Ссылка | Известные проблемы

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

location

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓	✓			✓	✓				✓			✓

mail

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
mail;				✓				✓	✓						✓

media

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
мультимедиа

meeting

Ссылка | Известные проблемы

Пространство имен, предоставляющее функции приложения для собраний.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
встреча

Примечание.

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

• meeting.requestStartLiveStreaming
• meeting.requestStopLiveStreaming
• meeting.getLiveStreamState
• meeting.registerLiveStreamChangedHandler

menus

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
Меню					✓					✓			✓

pages

Ссылка | Известные проблемы

Часть библиотеки TeamsJS, связанная с навигацией.

До версии TeamsJS 2.0 все сценарии глубокого связывания обрабатывались с помощью shareDeepLink (для создания ссылки на определенную часть приложения) и executeDeepLink (для перехода по глубокой ссылке из приложения или внутри приложения). TeamsJS версии 2.0 представляет новый API для navigateToAppперехода по страницам (и вложенным страницам) в приложении в согласованном режиме между узлами приложений (приложение Microsoft 365 и Outlook, в дополнение к Teams). Для новых приложений следуйте обновленным рекомендациям в зависимости от сценария навигации:

• Подробные ссылки на приложение. Используйте функцию pages.shareDeepLink (в версиях TeamsJS ниже 2.0 называемую также shareDeepLink) для создания и вывода ссылки, которую пользователь может скопировать и поделиться ею. Если этот параметр выбран, пользователю будет предложено установить приложение, если оно еще не установлено для узла приложения.

• Навигация в приложении. Используйте новое pages.currentApp пространство имен для навигации по приложению в приложении размещения. В частности, функция navigateTo(NavigateWithinAppParams) , разрешающая переход к определенной вкладке в текущем приложении, и функция navigateToDefaultPage() для перехода к первой вкладке, определенной в манифесте приложения. Дополнительные сведения см. в разделе Навигация в приложении вкладки.

  Эти API эквивалентны переходу по глубокой ссылке (как когда-то использовался устаревший executeDeepLink ), не требуя от приложения создания URL-адреса или управления различными форматами глубоких ссылок для разных узлов приложений.

• Глубокие ссылки из приложения. Для получения подробных ссылок из приложения на различные области его текущего узла используйте типизированные API, предоставляемые библиотекой TeamsJS. Например, используйте calendar возможность, чтобы открыть диалоговое окно планирования или элемент календаря из приложения.

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

  Для любых других внешних сценариев глубокой компоновки можно использовать функции, app.openLinkаналогичные устаревшим (начиная с TeamsJS версии 2.0) API executeDeepLink.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
pages	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓
pages.appButton	✓	✓	✓		✓	✓	✓
pages.backStack	✓	✓			✓	✓				✓	✓	✓	✓		✓
pages.currentApp		✓	✓	✓		✓	✓	✓	✓		✓	✓		✓	✓
pages.config	✓	✓			✓	✓		✓		✓		✓	✓		✓
pages.tabs	✓	✓			✓	✓

Примечание.

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

• pages.getConfig
• pages.setCurrentFrame
• pages.initializeWithFrameContext
• pages.tabs.navigateToTab
• pages.tabs.getMruTabInstances
• pages.tabs.getTabInstances

pages.appButton

Ссылка | Известные проблемы

Предоставляет API-интерфейсы для взаимодействия с частью пакета SDK с кнопкой приложения.

pages.backStack

Ссылка | Известные проблемы

Предоставляет API-интерфейсы для обработки журнала навигации пользователя.

pages.config

Ссылка | Известные проблемы

Предоставляет API-интерфейсы для взаимодействия с частью пакета SDK для конкретной конфигурации. Этот объект можно использовать только в кадре конфигурации.

pages.currentApp

Ссылка | Известные проблемы

Предоставляет функции для навигации без указания идентификатора приложения.

pages.tabs

Ссылка | Известные проблемы

Предоставляет API-интерфейсы для запросов и перехода между контекстными вкладками приложения. В отличие от личных вкладок, контекстные вкладки — это страницы, связанные с определенным контекстом, например каналом или чатом.

people

Ссылка | Известные проблемы

Пространство имен, предоставляющее функциональные возможности для API выбора Люди.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
people	✓	✓			✓	✓				✓			✓

profile

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
		✓		✓		✓		✓	✓

Примечание.

Метод profile.showProfile не поддерживается в мобильном клиенте Teams.

search

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓	✓		✓	✓	✓		✓	✓

secondaryBrowser

Ссылка | Известные проблемы

Предварительный просмотр. Пространство имен, поддерживающее интерфейс браузера ведущем приложении. Например, открытие URL-адреса в ведущем приложении в браузере.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
Значок secondaryBrowser											✓	✓		✓	✓

settings

Ссылка | Известные проблемы

Устарело. Предоставляет функциональные возможности, связанные с параметрами. Используйте эквивалентные API на страницах для новых приложений.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓				✓					✓			✓

sharing

Ссылка | Известные проблемы

Пространство имен для открытия диалогового окна общего доступа для веб-содержимого. Дополнительные сведения см. в статье Отправка в Teams из личного приложения или вкладки.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
предоставляет общий доступ к	✓	✓			✓	✓				✓			✓

Примечание.

Метод sharing.shareWebContent не поддерживается в мобильном клиенте Teams.

stageView

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓	✓			✓	✓

tasks

Ссылка | Известные проблемы

Более ранняя версия возможности предоставления модальных диалогов (называемых модулями задач в TeamsJS версии 1.x) поддерживает версии, предшествующие TeamsJS версии 2.8.0. Для новых приложений используйте возможность диалогового окна .

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
	✓				✓					✓			✓

Примечание.

Метод task.getDefaultSizeIfNotProvided не поддерживается в мобильном клиенте Teams.

teamsCore

Ссылка | Известные проблемы

Пространство имен, содержащее набор API, которые поддерживают функции Teams.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
teamsCore	✓	✓			✓	✓				✓			✓

video

Ссылка | Известные проблемы

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

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
										✓			✓

Примечание.

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

• video.notifySelectedVideoEffectChanged
• video.registerForVideoEffect

webStorage

Ссылка | Известные проблемы

Предварительный просмотр. Содержит функциональные возможности, позволяющие веб-приложениям хранить данные в кэше webview.

	Web				Версия для настольного компьютера					Мобильная версия
					Windows					Android			iOS
значок webStorage					✓					✓			✓

Примечание.

Метод webStorage.isWebStorageClearedOnUserLogOut не поддерживается в мобильном клиенте Teams.

См. также

• Расширение приложений Teams в Microsoft 365
• Расширение личной вкладки Teams в приложении Microsoft 365
• Справочник по API TeamsJS