Общий доступ на собрании

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

На следующем рисунке показана кнопка "Поделиться в собрании" в веб-приложении:

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

msteams:/l/meeting-share?deeplinkId={GUID}&fqdn={string}&lm=deeplink&appContext={json encoded app context}

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

• Чтобы участники собрания взаимодействовали со сторонними веб-приложениями или документами, они должны иметь расширение для собрания приложения или документа, установленное в клиенте Teams. Если у них нет расширения для собраний, Teams предлагает участникам установить расширение для собрания.
• Чтобы предоставить общий доступ ко всему приложению на стадии, необходимо настроить meetingStage контексты и meetingSidePanel в качестве контекстов кадра в манифесте приложения. В противном случае участники собрания могут не иметь возможности просматривать содержимое на сцене.

Включение общего доступа в собрании

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

Метод 1

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

Вы можете проверить веб-страницу, чтобы найти все HTML-элементы с именем класса типа teams-share-in-meeting-button и динамически создавать общий доступ в кнопках собрания на странице.

1. Добавьте сценарий launcher.js на веб-страницу.

   <script async defer src="https://teams.microsoft.com/share/launcher.js"></script>
   

2. Добавьте html-элемент на веб-страницу teams-share-in-meeting-button с атрибутом в атрибуте class , идентификатором приложения (из манифеста data-app-id ) в атрибуте и ссылкой для совместного использования в атрибуте data-href . Можно также включить атрибуты data-entity-name и data-entity-description .

   <div
     class="teams-share-in-meeting-button"
     data-href="https://<link-to-be-shared>"
     data-app-id="<app-id>"
     data-entity-name="<app-name>"
     data-entity-description="<app-content-description>"
     >
   </div>
   

3. Ниже приведены дополнительные атрибуты для настройки кнопки "Поделиться в собрании".

   • data-button-type: задает цвет фона кнопки (primaryShareInMeeting или secondaryShareInMeeting).
   • data-button-size: задает размер кнопки в пикселях.
   • data-target: указывает, открывается ли ссылка в том же окне, в новой вкладке или в новом окне.
   • data-locale: указывает нужный язык пользователя.

Метод 2

Этот метод можно использовать, чтобы контролировать, какая кнопка будет отображаться динамически или при выполнении скрипта. Скрипт выполняется только при window.shareToMicrosoftTeams.renderButtons() вызове. Через API можно передать определенные html-элементы renderButtons({elements: [], shareInMeetingElements: [shareInMeetingButton]) . Вы можете настроить стили, размер и языки кнопок.

async shareToMicrosoftTeams.renderButtons(options) API отображает все кнопки общего доступа с именем класса teams-share-button или teams-share-in-meeting-button на странице. options (optional) Если объект предоставляется со списком элементов, как показано в следующем коде, эти элементы отрисовываются в кнопках Поделиться или Поделиться в собраниях.

options (optional): { elements?: HTMLElement[], shareInMeetingElements?: HTMLElement[] }

1. Добавьте сценарий launcher.js на веб-страницу.

   <script async defer src="https://teams.microsoft.com/share/launcher.js" onload="onLoadComplete()"></script>
   

2. Создайте элемент HTML и укажите необходимые атрибуты. После полной загрузки скрипта средства запуска убедитесь, что логика отрисовки выполнена.

   async function onLoadComplete() {
      const shareInMeetingButton = document.createElement("div");
      shareInMeetingButton.setAttribute("data-app-id", "<app-id>");
      shareInMeetingButton.textContent = "Share Test App"
      shareInMeetingButton.setAttribute("data-href", "<app-content-url>");
      shareInMeetingButton.setAttribute("data-button-type", "secondaryShareInMeeting");
      shareInMeetingButton.setAttribute("data-locale", "fr-CA");
      await window.shareToMicrosoftTeams.renderButtons({elements: [], shareInMeetingElements: [shareInMeetingButton]});
   }  
   

Метод 3

Этот метод можно использовать для полного контроля над тем, как вызывается скрипт и когда следует создавать кнопку с помощью window.shareToMicrosoftTeams.shareInMeetingClickHandler API. Вы можете управлять тем, как и где создаются кнопки. Необходимо только присоединить window.shareToMicrosoftTeams.shareInMeetingClickHandler API к атрибуту onclick кнопки. Его можно присоединить к ссылке, кнопке, раскрывающимся меню и т. д. Вы можете полностью контролировать, как выглядит пользовательский интерфейс.

async shareInMeetingClickHandler(content: IShareInMeetingContent) API создает обработчик обратного вызова для кнопки "Поделиться в собрании", которую можно выполнить, нажав кнопку или меню.

1. Добавьте сценарий launcher.js на веб-страницу.

   <script async defer src="https://teams.microsoft.com/share/launcher.js" onload="onLoadComplete()"></script>
   

2. Создайте элемент HTML и добавьте в shareToMicrosoftTeams.shareInMeetingClickHandler его onClick атрибут . После полной загрузки скрипта средства запуска убедитесь, что логика onclick создана.

   async function onLoadComplete() {
      var customShareInMeetingButton = document.createElement("a");
      customShareInMeetingButton.onclick = window.shareToMicrosoftTeams.shareInMeetingClickHandler({
      url: "<app-content-url>",
      appId: "<app-id>",
      entityName: "<app-entity-name>",
      entityDescription: "<app-content-description>",
      });
   }
   

Ниже приведены определения launcher.js.

Свойство	Атрибут HTML	Тип	Обязательный	По умолчанию	Описание
url	data-href	String	Да	Н/Д	URL-адрес содержимого приложения для совместного использования.
appId	data-app-id	String	Да	Н/Д	Идентификатор приложения для совместного использования.
entityName	data-entity-name	String	Нет	Н/Д	Имя сущности приложения.
entityDescription	data-entity-description	String	Нет	Н/Д	Описание содержимого приложения для совместного использования.
языковые стандарты	data-locale	String	Нет	en-US	Предпочитаемый пользователем язык.
target	data-target	String	Нет	сам	Указывает, открывается ли ссылка в том же окне, в новой вкладке или в новом окне.
buttonType	data-button-type	String	Нет	primaryShareInMeeting	Задает цвет фона кнопки: primaryShareInMeeting или secondaryShareInMeeting.
buttonSize	data-button-size	String	Нет	Н/Д	Размер кнопки в пикселях.

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

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

Если установлено расширение для собраний:

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

   

2. Выберите Начать общий доступ.

   

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

   

Если расширение для собраний не установлено:

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

   

2. Чтобы установить приложение расширения для собраний, нажмите кнопку Добавить.

   

3. Выберите Начать общий доступ.

   

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

   

Создание глубокой ссылки для предоставления общего доступа к содержимому на этапе собраний

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

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

После того как пользователь инициирует мгновенное собрание (Meet now), он может добавлять участников и взаимодействовать с приложением.

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

Примечание.

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

Пример кода

Название примера	Описание	.NET	Node.js	Манифест
Представление этапа собрания	Это приложение помогает включить и настроить приложения для собраний Teams. В нем также показано использование функции общего доступа в собрании.	Просмотр	Просмотр	Просмотр

См. также

• Приложения для собраний и звонков Teams
• Поделиться в Teams из веб-приложений
• Поделиться в Teams из личного приложения или вкладки
• Создание прямых ссылок
• Адаптивные карточки