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

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

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

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

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

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

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

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

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

Метод 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), он может добавлять участников и взаимодействовать с приложением.

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

{ "appSharingUrl" : "https://teams.microsoft.com/extensibility-apps/meetingapis/view", "appId": "9ec80a73-1d41-4bcb-8190-4b9eA9e29fbb" , "useMeetNow": false }

Параметры запроса для контекста приложения:

• appID: это идентификатор, который можно получить из манифеста приложения.
• appSharingUrl: URL-адрес, к которому необходимо предоставить общий доступ на этапе, должен быть допустимым доменом, определенным в манифесте приложения. Если URL-адрес не является допустимым доменом, появится диалоговое окно с ошибкой, чтобы предоставить пользователю описание ошибки.
• useMeetNow: включает логический параметр, который может иметь значение true или false.

  • True: если useMeetNow значение равно true и если текущее собрание отсутствует, будет инициировано новое собрание Meet now. При текущем собрании это значение будет игнорироваться.

  • False: значение по умолчанию равно false. Это означает, что при совместном использовании прямой ссылки на этап и отсутствии текущего useMeetNow собрания появится всплывающее окно календаря. Однако вы можете предоставить общий доступ непосредственно во время собрания.

Убедитесь, что все параметры запроса правильно закодированы URI и контекст приложения должен быть закодирован дважды в конечном URL-адресе. Ниже приведен пример:

const appContext= JSON.stringify({ 
  "appSharingUrl" : "https://teams.microsoft.com/extensibility-apps/meetingapis/view",
  "appId": "9cc80a93-1d41-4bcb-8170-4b9ec9e29fbb",
  "useMeetNow": false
});
const encodedContext = encodeURIComponent(appContext).replace(/'/g,"%27").replace(/"/g,"%22");
const encodedAppContext = encodeURIComponent(encodedContext).replace(/'/g,"%27").replace(/"/g,"%22");

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

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

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

  Пример: https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

  Прямая ссылка	Формат	Пример
  Чтобы предоставить общий доступ к приложению и открыть календарь Teams, если useMeeetNow имеет значение false, по умолчанию.	https://teams.microsoft.com/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}}&lm=deeplink%22&appContext={encoded app context}	https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Afalse%257D
  Чтобы предоставить общий доступ к приложению и инициировать мгновенное собрание, когда useMeeetNow имеет значение true.	https://teams.microsoft.com/l/meeting-share?deeplinkId={deeplinkid}&fqdn={fqdn}}&lm=deeplink%22&appContext={encoded app context}	https://teams.microsoft.com/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

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

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

  Пример: msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

  Прямая ссылка	Формат	Пример
  Чтобы предоставить общий доступ к приложению и открыть календарь Teams, если useMeeetNow имеет значение false, по умолчанию.	msteams:/l/meeting-share? deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink%22&appContext={encoded app context}	msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Afalse%257D
  Чтобы предоставить общий доступ к приложению и инициировать мгновенное собрание, когда useMeeetNow имеет значение true.	msteams:/l/meeting-share? deeplinkId={deeplinkid}&fqdn={fqdn}&lm=deeplink%22&appContext={encoded app context}	msteams:/l/meeting-share?deeplinkId={sampleid}&fqdn=teams.microsoft.com&lm=deeplink%22&appContext=%257B%2522appSharingUrl%2522%253A%2522https%253A%252F%252Fteams.microsoft.com%252Fextensibility-apps%252Fmeetingapis%252Fview%2522%252C%2522appId%2522%253A%25229cc80a93-1d41-4bcb-8170-4b9ec9e29fbb%2522%252C%2522useMeetNow%2522%253Atrue%257D

Параметры запроса:

• deepLinkId: любой идентификатор, используемый для корреляции телеметрии.
• fqdn: fqdn необязательный параметр, который можно использовать для переключения в соответствующую среду собрания для предоставления общего доступа к приложению на сцене. Он поддерживает сценарии, в которых определенный общий ресурс приложения происходит в определенной среде. Значение по умолчанию — корпоративный fqdn URL-адрес, а возможные значения — Teams.live.com для Teams для жизни, teams.microsoft.comили teams.microsoft.us.

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

Примечание.

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

Пример кода

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

См. также

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