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

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

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

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

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

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

Примечание

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

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


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

Примечание

meetingStage в настоящее время доступна только в предварительном просмотре разработчика.

Свойство Context

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

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

Примечание

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

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

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

Примечание

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

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

Предварительная встреча

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

Добавление вкладки к собранию

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

  2. Выберите вкладку Details и выберите Plus button.

    Опыт предварительного собрания

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

    Примечание

    В настоящее время на вкладке "Собрания" сведения о собраниях и сведения о участниках не поддерживаются.

Добавление расширения обмена сообщениями на собрание

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

Добавление бота на собрание

В чате собраний @ введите ключ и выберите Get bots.

Примечание

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

В собрании

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

meetingSidePanel

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

Чтобы использовать userContext API для соответственного маршрута запросов, см. Teams SDK. Дополнительные сведения см. в Teams поток проверки подлинности для вкладок. Поток проверки подлинности для вкладок очень похож на поток проверки подлинности для веб-сайтов. Таким образом, вкладки могут напрямую использовать OAuth 2.0. Дополнительные сведения см. в платформа удостоверений Майкрософт oAuth 2.0.

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

Примечание

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

Диалоговое окно на собрании

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

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

Примечание

  • Необходимо вызвать функцию submitTask() для автоматического увольнения после действия пользователя в веб-представлении. Это требование для отправки приложения. Дополнительные сведения см. в Teams SDK task module.
  • Если вы хотите, чтобы ваше приложение поддержало анонимных пользователей, то при первоначальном запросе необходимо использовать метаданные запроса в объекте, а не from.id from from.aadObjectId метаданные запроса. from.idявляется ИД пользователя и является from.aadObjectId Azure Active Directory (AAD) пользователя. Дополнительные сведения см. в таблицах с использованием модулей задач и созданием и отправкой модуля задач.

Share to stage

Примечание

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

Необходимый контекст находится meetingStage в манифесте приложения. Обязательным условием для этого является meetingSidePanel контекст. Это позволяет использовать Share в собранииSidePanel.

Share to stage during meeting experience

Изменение манифеста, необходимое для обеспечения этой возможности, является следующим образом:

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

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

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

Пример кода

Пример имени Описание Пример
Приложение для собраний Демонстрирует, как использовать приложение Генератор маркеров собраний для запроса маркера, который создается последовательно, чтобы каждый участник имел справедливую возможность взаимодействия. Это может быть полезно в таких ситуациях, как scrum meetings, Q&A sessions и так далее. View

См. также