Поделиться в Teams из веб-приложений

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

На следующем рисунке отображается диалоговое окно, которое появляется, когда пользователь выбирает Общий доступ в Teams:

По умолчанию общий доступ к Teams поддерживает маркировку пользователей с @username помощью и @everyone, а пользователи с тегами получают уведомления в Microsoft Teams при совместном использовании содержимого в Teams.

Кроме того, можно добавить распаковку ссылок для ссылок, к которым предоставлен общий доступ с помощью команды Общий доступ к Teams, размещенных в веб-приложении, личном приложении или вкладке. Дополнительные сведения см. в разделе Распаковка ссылок.

На следующем рисунке показан процесс распаковки ссылок через общий доступ к Teams:

В этом разделе описано, как создать и внедрить общий доступ к Teams для веб-сайта, создать предварительную версию веб-сайта и расширить общий доступ к Teams для образования.

В следующем видео приведены основные шаги по внедрению share в Teams:

Внедрение общего доступа в Teams

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

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

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

Предоставление общего доступа к содержимому на собраниях

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

Вот как отображается общее веб-содержимое на этапе собрания:

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

1. Приложение Microsoft Teams с вкладкой, поддерживающей боковую панель собраний и api share to Stage.

2. Приложение для собраний должно поддерживать API-интерфейсы "Общий доступ к этапу" с двумя основными требованиями для отображения содержимого на этапе собрания:

   • Манифест приложения, поддерживающий и meetingSidePanel настроенные meetingStage в качестве контекстов кадра. Если настройка не настроена, участники собрания могут не иметь возможности просматривать содержимое на сцене.
   • Приложение, поддерживающее MeetingStage.Write.Chat разрешения для управления этапом. Это требование к разрешению на чтение.

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

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

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

2. Добавьте html-элемент на веб-страницу с teams-share-button параметром в атрибуте class и ссылкой для совместного использования в атрибуте data-href . Чтобы пользователи могли делиться содержимым на собраниях из Раздела в Teams, добавьте allow-share-in-meeting атрибут и присвойте ему значение true.

       <div
       class="teams-share-button"
       data-href="https://<link-to-be-shared>"
       data-allow-share-in-meeting="true"
       data-app-id="<app-id>"
       >
       </div>
   

   После настройки откроется диалоговое окно Общий доступ к Teams с параметром "Показать сейчас ". Теперь функция Present позволяет пользователям делиться содержимым текущего собрания. Для пользователя, который предоставил общий доступ к содержимому на этапе собрания, боковая панель автоматически открывается при начале собрания и заполняет общее содержимое на боковой панели собрания.

   

Ниже приведено несколько сценариев, в которых содержимое предоставляется собранию с помощью общего доступа к Teams:

Создание предварительной версии веб-сайта

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

Чтобы отобразить предварительную версию, выполните следующие действия:

• Необходимо включить либо Эскиз, либо Заголовок и Описание. Для достижения наилучших результатов включите все три параметра.
• Общий URL-адрес не требует проверки подлинности. Если требуется проверка подлинности, вы можете предоставить к ней общий доступ, но предварительная версия не создается.

В следующей таблице описаны необходимые теги:

Можно использовать либо версии HTML по умолчанию, либо версию Open Graph.

Предоставление общего доступа в Teams для образовательных учреждений

Для преподавателей, использующих кнопку Поделиться в Teams, есть дополнительный параметр Create an Assignment , позволяющий быстро создать задание в выбранной команде на основе общей ссылки.

Вы можете настроить значения по умолчанию для следующих полей в форме «Отправить в Teams»:

• Прокомментируйте это: msgText
• Инструкции к заданию: assignInstr
• Название задания: assignTitle

На следующем изображении показан общий доступ к Teams для образования:

Пример

Значения формы по умолчанию приведены в следующем примере:

<span
    class="teams-share-button"
    data-href="https://www.microsoft.com/education/products/teams"
    data-msg-text="Default Message"
    data-assign-title="Default Assignment Title"
    data-assign-instr="Default Assignment Instructions"
></span>

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

Пример кода

Дополнительные ресурсы

• Интеграция веб-приложений
• Поделиться в Teams из личного приложения или вкладки
• Общий доступ на собрании