Включение и настройка приложений для собраний

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

Предварительные требования

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

Включение приложения для собраний Teams

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

Обновление манифеста приложения

Возможности приложения для собраний объявляются в манифесте приложения с помощью массивов configurableTabs, scopes и context. Область определяет, у кого есть доступ, а контекст определяет, где доступно ваше приложение.

Примечание

  • Приложения на собраниях требуют или groupchat области team . Область team работает для вкладок в каналах или собраниях каналов.
  • Чтобы поддерживать добавление вкладок в запланированные собрания каналов, укажите область группы в разделе областей в манифесте приложения. Без области группы приложение не будет отображаться во всплывающем окне для собраний канала.
  • Приложения на собраниях могут использовать следующие контексты: meetingChatTab, meetingDetailsTab, meetingSidePanel и meetingStage.

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


"configurableTabs": [
    {
      "configurationUrl": "https://contoso.com/teamstab/configure",
      "canUpdateConfiguration": true,
      "scopes": [
        "team",
        "groupchat"
      ],
      "context":[
        "channelTab",
        "privateChatTab",
        "meetingChatTab",
        "meetingDetailsTab",
        "meetingSidePanel",
        "meetingStage"
     ]
    }
  ]

Свойство контекста

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

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

Ниже приведены значения для свойства context. Вы можете использовать некоторые или все эти значения.

Значение Описание
channelTab Вкладка в заголовке канала команды.
privateChatTab Вкладка в заголовке группового чата между группой пользователей, а не в контексте команды или собрания.
meetingChatTab Вкладка в заголовке группового чата между группой пользователей для запланированного собрания. Вы можете указать meetingChatTab или meetingDetailsTab, чтобы убедиться, что приложения работают на мобильных устройствах.
meetingDetailsTab Вкладка в заголовке представления сведений о собрании календаря. Вы можете указать meetingChatTab или meetingDetailsTab, чтобы убедиться, что приложения работают на мобильных устройствах.
meetingSidePanel Панель на собрании, открытая через единую панель (панель U-bar).
meetingStage Приложение из meetingSidePanel можно продемонстрировать на сцене собрания. Это приложение нельзя использовать в клиентах на мобильных устройствах или клиентах комнат Teams.

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

Настройка приложения для сценариев собраний

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

Перед собранием

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

Чтобы добавить вкладку для собрания:

  1. В календаре выберите собрание, для которого нужно добавить вкладку.

  2. Выберите вкладку Сведения и нажмите Plus button.

    Pre-meeting experience
  3. В появившейся коллекции вкладок выберите приложение, которое нужно добавить, и выполните необходимые действия. Приложение устанавливается как вкладка.

Чтобы добавить расширение для сообщений в собрание:

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

Чтобы добавить бота для собрания:

В чате собрания введите ключ @ и выберите Скачать ботов.

Примечание

  • В диалоговом окне на собрании отображается диалог собрания и одновременно публикуется адаптивная карточка в чате собрания, к которой пользователи могут получить доступ. Адаптивная карточка в чате собрания помогает пользователям при присутствии на собрании или если приложение Teams свернуто.
  • Удостоверение пользователя должно быть подтверждено с помощью единого входа для вкладок. После проверки подлинности приложение может получить роль пользователя с помощью API GetParticipant.
  • В зависимости от роли пользователя приложение может предоставлять возможности для определенной роли. Например, приложение для опросов позволяет создавать опрос только организаторам и докладчикам.
  • Назначения ролей можно изменить во время собрания. Дополнительные сведения см. в статье Роли в собраниях Teams.

Во время собрания

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

Боковая панель собрания

meetingSidePanel позволяет настраивать интерфейс собрания, что дает возможность организаторам и докладчикам использовать различные наборы представлений и действий. В манифесте своего приложения добавьте meetingSidePanel в массив контекста. Во время собрания и во всех сценариях приложение отображается на вкладке во время собрания шириной 320 пикселей. Дополнительные сведения см. в описании интерфейса FrameInfo (до TeamsJS версии 2.0.0 известного как FrameContext).

Контекст пользователя можно использовать для маршрутизации запросов. Дополнительные сведения см. в статье Поток проверки подлинности для вкладок в Teams. Поток проверки подлинности для вкладок аналогичен потоку проверки подлинности для веб-сайтов. Вкладки могут напрямую использовать OAuth 2.0. Дополнительные сведения см. в статье Платформа удостоверений Майкрософт и поток кода авторизации OAuth 2.0.

Расширение для сообщений работает правильно, когда пользователь находится в представлении собрания. Пользователь может публиковать карточки расширения для создания сообщения. AppName в собрании — это подсказка, которая указывает имя приложения на панели U-bar во время собрания.

Примечание

Используйте пакет SDK Teams версии 1.7.0 или более поздней, так как предыдущие версии не поддерживают боковую панель.

Уведомление на собрании

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

Уведомление на собрании не должно использовать модуль задач. Модуль задач не вызывается в чате собрания. Для отображения уведомления на собрании используется URL-адрес внешнего ресурса. Вы можете использовать метод submitTask для отправки данных в чате собрания.

В примере показано, как можно использовать диалоговое окно на собрании.

Также можно добавить отображаемое изображение Teams и карточку пользователя в уведомление собрания на основе маркера onBehalfOf, при этом MRI пользователя и отображаемое имя передаются в полезных данных. Ниже приведен пример полезных данных:

    {
       "type": "message",
       "text": "John Phillips assigned you a weekly todo",
       "summary": "Don't forget to meet with Marketing next week",
       "channelData": {
           onBehalfOf: [
             { 
               itemId: 0, 
               mentionType: 'person', 
               mri: context.activity.from.id, 
               displayname: context.activity.from.name 
             }
            ],
           "notification": {
           "alertInMeeting": true,
           "externalResourceUrl": "https://teams.microsoft.com/l/bubble/APP_ID?url=<url>&height=<height>&width=<width>&title=<title>&completionBotId=BOT_APP_ID"
            }
        },
       "replyToId": "1493070356924"
    }

В этом примере показано, как приложение Teams отображает изображение и карточку пользователя в диалоговом окне собрания.

Общая сцена собрания

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

Демонстрация всего приложения на сцене

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

Share full app

Чтобы продемонстрировать все приложение на сцене, в манифесте приложения настройте meetingStage и meetingSidePanel в качестве контекста кадров. Например:

"configurableTabs": [
   {
      "configurationUrl": "https://contoso.com/teamstab/configure",
      "canUpdateConfiguration": true,
      "scopes": [
         "groupchat"
        ],
      "context":[
         "meetingSidePanel",
         "meetingStage"
        ]
    }
]

Дополнительные сведения см. в манифесте приложения.

Демонстрация определенных частей приложения на сцене

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

Share specific parts of the app

Чтобы продемонстрировать определенные части приложения на сцене, необходимо вызвать связанные API в библиотеке клиентского пакета SDK Teams. Дополнительные сведения см. в справочнике по API.

Примечание

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

После собрания

Конфигурации после и до собраний одинаковы.

Пример кода

Название примера Описание C# Node.js
Приложение для собраний Демонстрирует, как использовать приложение генератора маркеров собраний для запроса маркера. Маркер создается последовательно, чтобы каждый участник обладал равными возможностями участия в собрании. Маркер удобен в таких сценариях, как собрания Scrum и сеансы вопросов с ответами. Просмотр Просмотр
Пример сцены собрания Пример приложения для отображения вкладки на сцене собрания для совместной работы Просмотр Просмотр
Боковая панель собрания Пример приложения для демонстрации добавления повестки дня на боковой панели во время собрания Просмотр -

Пошаговые руководства

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

Дополнительные ресурсы