Общий доступ на собрании
Общий доступ на собрании позволяет пользователям предоставлять общий доступ к документам или сторонним веб-приложениям на этапе собрания. Участники собрания могут сотрудничать и взаимодействовать со сторонними веб-приложениями или совместно редактировать документы.
На следующем рисунке показана кнопка "Поделиться в собрании" в веб-приложении:
Во время собрания, когда пользователь нажимает кнопку Поделиться в собрании в стороннем веб-приложении или документе, он запускает прямую ссылку на этап собрания и открывает приложение в виде веб-представления на этапе собрания. Чтобы участники собрания взаимодействовали со сторонним веб-приложением или документом, они должны иметь расширение для собрания приложения или документа, установленное в клиенте Teams. Если у них нет расширения для собраний, Teams предлагает участникам установить расширение для собрания.
При нажатии кнопки Поделиться на собрании открывается прямая ссылка на этап собрания. Ниже приведен формат глубокой ссылки:
msteams:/l/meeting-share?deeplinkId={GUID}&fqdn={string}&lm=deeplink&appContext={json encoded app context}
Дополнительные сведения см. в статье Создание глубокой ссылки для предоставления общего доступа к содержимому на этапе собраний.
Включение общего доступа в собрании
Ниже приведены три различных метода включения общего доступа в собрании. Вы можете использовать один из методов в зависимости от того, сколько элементов управления на кнопках "Поделиться в собрании ", отображаемых на веб-странице:
Этот метод является самым простым способом отображения общего доступа в кнопках собрания с минимальными настройками. Вы можете настроить стили, размер и языки кнопок.
Вы можете отсканировать веб-страницу, чтобы найти любые HTML-элементы с именем класса типа teams-share-in-meeting-button
и динамически создавать общий доступ в кнопках собрания на странице.
Добавьте сценарий
launcher.js
на веб-страницу.<script async defer src="https://teams.microsoft.com/share/launcher.js"></script>
Добавьте 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>
Ниже приведены дополнительные атрибуты для настройки кнопки "Поделиться в собрании".
-
data-button-type
: задает цвет фона кнопки (primaryShareInMeeting
илиsecondaryShareInMeeting
). -
data-button-size
: задает размер кнопки в пикселях. -
data-target
: указывает, открывается ли ссылка в том же окне, в новой вкладке или в новом окне. -
data-locale
: указывает нужный язык пользователя.
-
Ниже приведены определения 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 | Нет | Н/Д | Размер кнопки в пикселях. |
Взаимодействие с конечными пользователями в сторонних приложениях
После включения общего доступа к собранию в сторонних приложениях вы можете предоставить доступ к приложениям на этапе собрания. Чтобы получить доступ, выполните следующие действия:
Если установлено расширение для собраний:
Откройте веб-приложение в браузере и выберите Поделиться на собрании.
Выберите Начать общий доступ.
Веб-приложение предоставляется на этапе собрания, и все участники могут взаимодействовать и редактировать вместе.
Если расширение для собраний не установлено:
Откройте веб-приложение в браузере и выберите Поделиться на собрании.
Чтобы установить приложение расширения для собраний, нажмите кнопку Добавить.
Выберите Начать общий доступ.
Веб-приложение предоставляется на этапе собрания, и все участники могут взаимодействовать и редактировать вместе.
Создание глубокой ссылки для предоставления общего доступа к содержимому на этапе собраний
Вы также можете создать прямую ссылку для предоставления общего доступа к приложению, чтобы выполнить этап и начать собрание или присоединиться к нему. Если пользователь, являющийся частью текущего собрания, выбирает в приложении прямую ссылку, приложение передается сцене и откроется всплывающее окно разрешения. Пользователи могут предоставить участникам доступ для совместной работы с приложением.
Если пользователь не состоит в собрании, он перенаправляется в календарь 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. В нем также показано использование функции общего доступа в собрании. | Просмотр | Просмотр | Просмотр |
См. также
Platform Docs