Создание приложений для этапа собрания 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, вы можете настроить текст на кнопке. Ниже приведены рекомендации по настройке.

• Используйте команду "Общий доступ", а не "Показать" или "Общий доступ к экрану", если ваш интерфейс предлагает простой общий доступ к содержимому приложения на этапе. Это задает правильное ожидание для пользователей, так как поделиться последовательно означает поделиться на этапе собраний Teams.
• Используйте более конкретный текст, чтобы предоставить осмысленный контекст сценария. Например, вы можете использовать текст, например Смотреть вместе или Играть вместе , если ваше приложение предлагает видео или случайные игры.

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

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.

Сценарии

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

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

Действие "Остановить общий доступ"

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

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

Следующий код является примером stopSharingAppContentToStage API:

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

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

В следующей таблице содержится параметр запроса:

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

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

Кнопка "Скрыть собственный общий доступ"

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

Имя supportsCustomShareToStage свойства в манифесте приложения указывает, включило ли приложение поддержку предоставления общего доступа к содержимому приложения на этапе.

Следующий код является примером supportsCustomShareToStage свойства в манифесте приложения:

{
  "supportsCustomShareToStage": true // hides the native share button
} 

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

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

Получение содержимого приложения на боковой панели собрания

sharing.history.getContent API позволяет получить содержимое, к которым предоставлен общий доступ на собрании, и отобразить его на боковой панели собрания.

Когда собрание начинается, приложение, в котором предоставляется общий доступ к содержимому, автоматически открывает боковую панель собрания для пользователя, который предоставил общий доступ к содержимому. Вы можете вызвать sharing.history.getContent API, чтобы получить список общего содержимого и отобразить его на боковой панели, что делает его доступным. Для предстоящего повторяющегося собрания, где приложение уже добавлено, разработчики могут вызвать API, чтобы получить последнее содержимое, которое будет отображаться на боковой панели приложения.

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

// Define an async function
async function fetchContentDetails() {
    // Fetches a list of content details that was shared in the meeting
    const contentDetails = await microsoftTeams.sharing.history.getContent();

    // Above content details can be used to hydrate the meeting side panel 
    // to share to meeting stage

}

Параметры полезных данных ответа

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

Коды ответа

В следующей таблице приведены коды ответов:

Дополнительные сведения см. в разделе sharing.history.getContent.

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

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

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

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

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

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

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

Пример кода

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

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

См. также

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