Приложения в собраниях TeamsApps in Teams meetings

Собрания являются ключевыми для продуктивности в Teams.Meetings are key to productivity in Teams. Они обеспечивают совместную работу, партнерство, информирование о связи и совместную работу на активном форуме.They enable collaboration, partnership, informed communication, and shared feedback in an inclusive and active forum. Разработчик может создавать настраиваемые приложения вкладок, Botи расширений сообщений , чтобы улучшить и расширить возможности для собраний в Teams.As a developer, you can create configurable tab, bot, and message extension applications to enhance and enrich a Teams meeting experience. Пользователи собраний могут получать доступ к приложениям с помощью коллекции вкладок, позволяя выполнять соответствующие сценарии, такие как предварительная настройка доски Канбан, запуск диалогового окна для проведения собрания или создание опроса после собрания.Meeting users can access apps, via the tab gallery, to enable relevant scenarios such as pre-staging a Kanban board, launching an in-meeting actionable dialog, or creating a post-meeting poll. Ваше приложение для собраний может обеспечить взаимодействие с пользователем для каждого этапа жизненного цикла собрания на основе состояния участника.Your meeting app can deliver a user experience for each stage of the meeting lifecycle based upon attendee status.

Центр расширяемости приложений собраний Teams в трех концепциях:Teams’ meeting app extensibility centers on three concepts:

Жизненный цикл собраний — до, во время и после кадра времени собрания.Meeting lifecycle — before, during, and after meeting time frame.
Роль участника ✔ — организатор собрания, докладчика или участник.Participant role — meeting organizer, presenter, or attendee.
Тип пользователя — пользователь в группах "гость", "гость", "федеративный" или "Аноним".User type — in-tenant, guest, federated, or anonymous Teams user.

Сценарии жизненного цикла собранийMeeting lifecycle scenarios

ВкладкиTabs

Важно!

Как и во всех приложениях с вкладками, ваше приложение должно выполнять процесс проверки подлинности единого входа Teams для вкладок.As with all tab applications, Your app will need to follow the Teams SSO authentication flow for tabs.

Примечание

Мобильные клиенты поддерживают вкладки только на поверхностях предварительных и посылаемых собраний.Mobile clients support Tabs only in Pre and Post Meeting Surfaces. Скоро будет доступен интерфейс для собраний (диалоговое окно и панель на собрании) на мобильном устройстве.The In-meeting experiences (in-meeting dialog and panel) on mobile will be available soon

Взаимодействие с приложением перед собраниемPre-meeting app experience

Подготовка к собранию:Pre-meeting experience:

работа перед собранием

Вкладка перед собранием:Pre-meeting tab:

представление вкладки перед собранием

✔ С разрешениями пользователи могут добавлять приложения к собранию через коллекцию вкладок двумя способами:✔ Permissioned users can add apps to a meeting via the tab gallery in two ways:

  ● с помощью вкладки " сведения " формы планирования Teams.  ● Via the Details tab on the Teams scheduling form.

  ● с помощью вкладки " чат для собраний" в существующем собрании.  ● Via the meeting Chat tab in an existing meeting.

Вкладки ✔ доступны на страницах сведений о собраниях и беседах с помощью кнопки со значком плюс (➕). |✔ Tab apps are accessible in meetings Details and Chats pages using a plus icon (➕) button.|

Макет вкладки ✔ должен находиться в организованном состоянии, если имеется более десяти опросов или опросов.✔ Tab layout should be in an organized state if there are more than ten polls or surveys.

Взаимодействие с приложением для собранийIn-meeting app experience

✔ Приложения собраний будут размещаться в верхней верхней панели окна Chat и на вкладке "в собрании". Когда пользователи добавляют вкладку на собрание с помощью коллекции вкладок, будут отображаться приложения, находящиеся во время проведения собрания .✔ Meeting apps will be hosted in the top upper bar of the chat window and as in-meeting tab experience via the in-meeting tab. When users add a tab to a meeting through the tab gallery, apps that are during meeting experiences will be surfaced.

✔ С разрешениями пользователи могут добавлять приложения во время собрания.✔ Permissioned users can add apps while in the meeting.

✔ При загрузке в контексте собрания приложения смогут использовать клиентский пакет SDK Teams для доступа к серверам, а также meetingId userMri frameContext для надлежащего отображения интерфейса.✔ When loaded in the context of a meeting, apps will be able to leverage the Teams Client SDK to access the meetingId, userMri, and frameContext to appropriately render the experience.

✔ Экспорта результатов опроса или опросов следует уведомить пользователей о том, что "результаты успешно скачаны".✔ Exporting a result of a survey or polls should notify the users stating, ‘results successfully downloaded’.

✔ Для отображения приложения в собрании Teams в двух областях:✔ For an app to be visible in a Teams meeting in two areas:

  ● боковой панели.  ● Side panel.

Примечание

Если манифест приложения указывает, что вкладка оптимизирована для боковой панели, здесь будет отображаться эта вкладка.If your app manifest specifies that your tab is optimized for side panel, that is where it will be displayed. Она также может быть частью интерфейса подающего лоток, в соответствии с указанными рекомендациями по проектированию.It can also be part of a share-tray experience, subject to specified design guidelines.

  ● диалоговое окно собраний.  ● In-meeting dialog. Используйте диалоговое окно "в собрании" для демонстрации действий, выполняемых участниками собрания.Use the in-meeting dialog to showcase actionable content for meeting participants. Ознакомьтесь с разделом Создание приложений для собраний Teams.See Create Apps for Teams meetings.

Возможности для собраний:In-meeting experience:

взаимодействие с собраниями

Представление на собрании — диалоговое окно

Диалоговое окно с действиями в собрании для пользователей:In-meeting actionable dialog for users:

Представление диалоговых окон

Взаимодействие с приложениями после собранийPost-meeting app experience

Взаимодействие после собрания:Post-meeting experience:

представление "опубликовать собрание"

✔ Сценарий, выполняемый после собрания, аналогичен текущему поэтапному собранию с дополнительным преимуществом использования вкладок, имеющихся на поверхности.✔ The post-meeting app scenario is similar to the current post-meeting experience with the added benefit of having tabs that exist within the surface.

✔ С разрешениями пользователи могут добавлять приложения из коллекции вкладок на собрание с помощью вкладки " сведения " в форме "Планирование команд" и на вкладке Чат Meeting ( чат ) в существующем собрании.✔ Permissioned users can add apps from the tab gallery to a meeting via the Details tab on the Teams scheduling form and the meeting Chat tab in an existing meeting.

Макет вкладки ✔ должен находиться в организованном состоянии, если имеется более десяти опросов или опросов.✔ Tab layout should be in an organized state if there are more than ten polls or surveys.

БотыBots

В этой статье представлены сведения о реализации боты в документации по собраниям Teams .For bot implementation, please see our Bots in Teams meetings documentation.

Расширения для сообщенийMessaging Extensions

Для реализации расширения для обмена сообщениями ознакомьтесь с нашими расширениями обмена сообщениями в документации по собраниям Teams .For messaging extension implementation, please see our Messaging extensions in Teams meetings documentation.

Роли участников и типы пользователей на собранииParticipant roles and user types in a meeting

Участники собрания

Роли участниковParticipant roles

Вы можете разработать приложение с проверкой подлинности, зависящей от участников.You can design your app with participant-specific authorization. Например, возможно, только организатор или докладчик могут создать опрос в собраниях.For example, perhaps only an organizer and/or presenter can create a poll in meetings. Несмотря на то, что параметры участников по умолчанию определяются ИТ ИТ администратором, организатору собрания может потребоваться изменить параметры для определенного собрания.Although default participant settings are determined by an organization's IT administrator, a meeting organizer may want to change the settings for a specific meeting. Организаторов могут вносить эти изменения на веб-странице параметров собрания.Organizers can make these changes on the Meeting options web page.

  1. Организатор.Organizer. Организатор планирует собрание, задает параметры собрания, назначает роли собраний и запускает собрание.The organizer schedules a meeting, sets the meeting options, assigns meeting roles, and starts the meeting. Только пользователи с учетной записью M365 (обладающими лицензией Teams) могут быть организаторов и управлять разрешениями участников.Only users with a M365 account (possessing a Teams license) can be organizers and control attendee permissions.
  2. Выступающий.Presenter. У докладчиков почти те же возможности, что и у организатора; Однако докладчик не может удалить организатора из сеанса или изменить параметры собрания для этого сеанса.Presenters have nearly the same capabilities as organizer; however, a presenter cannot remove an organizer from the session or modify meeting options for the session. По умолчанию участники, присоединяющиеся к собранию, имеют роль докладчика.By default, participants joining a meeting have the presenter role.
  3. Участник.Attendee. Участник — это пользователь, приглашенный на собрание, но не уполномоченный выступающий в качестве докладчика.An attendee is a user who has been invited to attend a meeting but who is not authorized to act as a presenter. Участники могут взаимодействовать с другими участниками собрания, но не могут управлять параметрами собрания или общими контентом.Attendees can interact with other meeting members but cannot manage any of the meeting settings or share content.

Просмотр ролей в собрании TeamsSee Roles in a Teams meeting

Вы можете получить доступ к странице параметры собрания следующим образом:You can access the Meeting options page as follows:

⯀ в Teams откройте раздел Календарь календаря  , выберите собрание, а затем — параметры собрания.⯀ In Teams, go to Calendar calendar logo, select a meeting, and then Meeting options.

⯀ в приглашении на собрание выберите параметры собрания.⯀ In a meeting invitation, select Meeting options.

⯀ во время собрания Установите флажок Показывать участников  Отображать значок участников в элементах управления собрания.⯀ During a meeting, select Show participants show participants icon in the meeting controls. Затем над списком участников выберите Управление разрешениями.Then, above the list of participants, choose Manage permissions.

Типы пользователей.User types

Примечание

Пользовательские типы могут присоединяться к собраниям и принимать одну из ролей участника, описанных выше.User types can join meetings and assume one of the participant roles described above. Тип пользователя не предоставляется в составе API жетпартиЦипантроле .The User type is not exposed as part of the getParticipantRole API.

  1. В клиенте.In-tenant. Эти пользователи принадлежат организации и имеют учетные данные в Azure Active Directory для клиента.These users belong to the organization and have credentials in Azure Active Directory for the tenant. Обычно они являются полноценными, сотрудниками или удаленными сотрудниками.They are usually full-time, onsite or remote employees.
  2. Гость.Guest. Гость — это участник другой организации, который был приглашен на доступ к Teams и другим ресурсам в клиенте Организации.A guest is a participant from another organization who has been invited to access Teams or other resources in your organization's tenant. Гости добавляются в Active Directory вашей организации, и им могут быть предоставлены почти все возможности Teams в качестве собственного члена группы с полным доступом к разговорам групп, собраниям и файлам.Guests are added to your organization’s Active Directory and can be given nearly all the same Teams capabilities as a native team member with full access to team chats, meetings, and files. Просмотр гостевого доступа в Microsoft TeamsSee Guest access in Microsoft Teams
  3. Федеративные и внешние.Federated/External. Федеративный пользователь — это пользователь внешней группы в другой организации, приглашенный на присоединение к собранию.A federated user is an external Teams user in another organization who has been invited to join a meeting. Так как эти пользователи имеют действительные учетные данные с федеративными партнерами, они считаются подлинными в Teams, но не имеют доступа к рабочим группам или другим общим ресурсам Организации.Since these users have valid credentials with federated partners, they are treated as authenticated by Teams but do not have access to your teams or other shared resources from your organization. Если вы хотите, чтобы внешние пользователи могли получать доступ к Teams и каналам, гостевой доступ может быть лучший вариант.If you want external users to have access to teams and channels, guest access might be a better option. Просмотр управления внешним доступом в Microsoft TeamsSee Manage external access in Microsoft Teams
  4. Анонимный доступ.Anonymous. Анонимные пользователи не имеют удостоверения Active Directory и не объединены с клиентом.Anonymous users do not have an Active Directory identity and are not federated with a tenant. Анонимный участник похож на внешнего пользователя, но его удостоверение не проецируется на собрание.The anonymous participant is like an external user, but their identity is not projected into the meeting. Анонимные пользователи не смогут получать доступ к приложениям в окне собрания.Anonymous users will not be able to access apps in a meeting window.

Дальнейшие действияNext Steps