Создание приложений для этапа собрания Teams

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

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

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

В следующей таблице перечислены сценарии использования функций "Общий доступ к экрану" и "Общий доступ к сценарию".

Общий доступ к сцене

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

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

Манифест приложения

Чтобы предоставить общий доступ к приложению этапу собрания, необходимо настроить разрешения контекста и разрешения на согласие для конкретных ресурсов (RSC) в манифесте приложения:

1. Обновите context свойство в манифесте приложения следующим образом:

   "context": [
     "meetingSidePanel",
     "meetingStage"
   ]
   

2. Получите разрешения RSC, настроив authorization свойство и name и type в resourceSpecific поле следующим образом:

   "authorization": {
     "permissions": {
       "resourceSpecific": [
         {
           "name": "MeetingStage.Write.Chat",
           "type": "Delegated"
         }
       ]
     }
   }
   

API-интерфейсы расширенного общего доступа для промежуточного использования

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

1. Для приложения для мозгового штурма или доски пользователь может поделиться определенной доской на собрании, а не ко всему приложению со всеми досками.

2. Для медицинского приложения, врач может захотеть поделиться только рентгеновским снимка на экране с пациентом, а не делиться всем приложением со всеми записями пациентов или результатами и т. д.

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

Чтобы помочь пользователям в таких сценариях, API-интерфейсы в клиентской библиотеке JavaScript Microsoft Teams (TeamsJS) позволяют программно вызывать общий ресурс для этапа для определенных частей приложения с помощью кнопки на боковой панели собрания.

Используйте следующие API для предоставления общего доступа к определенной части приложения:

• Предоставление общего доступа к содержимому приложения на этапе. Предоставление доступа к определенным частям приложения на стадии собрания с боковой панели собрания в собрании. Библиотека TeamsJS

• Получение состояния общего доступа к содержимому приложения. Получение сведений о состоянии общего доступа приложения на этапе собрания. Библиотека TeamsJS

• Получение возможностей совместного доступа к содержимому приложения. Получение возможностей приложения для общего доступа к этапу собрания. Библиотека TeamsJS

const appContentUrl = "https://www.bing.com/";

microsoftTeams.meeting.shareAppContentToStage((err, result) => {
    if (result) {
        // handle success
    }
    if (err) {
        // handle error
    }
}, appContentUrl);

microsoftTeams.meeting.getAppContentStageSharingState((err, result) => {
    if (result.isAppSharing) {
        // Indicates if app is sharing content on the meeting stage.
    }
});

{
  "isAppSharing": true
}

microsoftTeams.meeting.getAppContentStageSharingCapabilities((err, result) => {
    if (result.doesAppHaveSharePermission) {
        // Indicates if the meeting participant has permission to share content to the meeting stage.
    }
});

{
   "doesAppHaveSharePermission":true
} 

Демонстрация содержимого с экрана для собраний

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

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

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

• Общий доступ ко всему приложению. Когда вы предоставляете общий доступ к вкладке на стадии собрания в Собрании Teams, contentUrl связанная с вкладкой отображает новое окно для приложения и экранных общих папок, которое открывается всем остальным участникам собрания. Свойство page.frameContext в объекте getContext имеет значение meetingStage , чтобы сообщить приложению о том, что оно отображается на большой поверхности, что позволяет приложению соответствующим образом обновить свое содержимое.

  Примечание.

  Приложения, которые указывают MeetingStage в свойстве page.frameContextgetContext объекта в манифесте и объявляют MeetingStage.Write.Chat разрешения, поддерживают совместную инфраструктуру Share to Stage. Кнопка "Поделиться" инициирует существующий протокол совместной работы, а не протокол общего доступа к экрану.

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

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

   // Share the content to meeting stage view.
    const shareSpecificAppContent = (partName) => {
        var appContentUrl = "";
        microsoftTeams.app.getContext().then((context) => {
            appContentUrl = partName == 'todo' ? `${window.location.origin}/todoView?meetingId=${context.meeting.id}` : partName == 'doing' ? `${window.location.origin}/doingView?meetingId=${context.meeting.id}` : `${window.location.origin}/doneView?meetingId=${context.meeting.id}`;
            microsoftTeams.meeting.shareAppContentToStage((err, result) => {
                if (result) {
                    // handle success
                    console.log(result);
                }

                if (err) {
                    // handle error
                    alert(JSON.stringify(err))
                }
            }, appContentUrl);
        });
    };

  // Share the content in view-only screen sharing mode.
      const shareSpecificAppContentScreenShare = (partName) => {
          var appContentUrl = "";
          microsoftTeams.app.getContext().then((context) => {
              appContentUrl = partName == 'todo' ? `${window.location.origin}/todoView?meetingId=${context.meeting.id}` : partName == 'doing' ? `${window.location.origin}/doingView?meetingId=${context.meeting.id}` : `${window.location.origin}/doneView?meetingId=${context.meeting.id}`;
              microsoftTeams.meeting.shareAppContentToStage((err, result) => {
                  if (result) {
                      // handle success
                      console.log(result);
                  }

                  if (err) {
                      // handle error
                      alert(JSON.stringify(err))
                  }
              }, appContentUrl,
                  // Optional shareOptions with sharingProtocol set to ScreenShare
                  {
                      sharingProtocol: microsoftTeams.meeting.SharingProtocol.ScreenShare
                  });
          });
      };

Дополнительные сведения о параметрах см. в статье shareAppContentToStage.

Сценарии

Преимущества

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

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

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

Приложение для подписи на собрании можно использовать для:

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

Участники могут просматривать и подписывать документы, такие как соглашения о покупке и заказы на покупку.

Во время собрания могут быть задействованы следующие роли участников:

• Создатель документа. Эта роль может добавлять собственные документы для проверки и подписания.
• Подписыватель: эта роль может подписывать проверенные документы.
• Читатель. Эта роль может просматривать документы, добавленные на собрание.

Пример кода

Пошаговые инструкции

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

См. также

• Приложения для собраний Teams
• Включение проверки подлинности с помощью стороннего поставщика OAuth
• Согласие на делегированные разрешения для конкретного ресурса
• Создание прямых ссылок
• API приложений для собраний
• Настраиваемые сцены режима "Вместе"
• Пакет SDK Live Share