Создание маркера собрания для участников - Teams

Приложение маркеров собрания помогает улучшить взаимодействие с собраниями в Teams, позволяя участникам собрания запрашивать маркеры и создавать маркеры. Приложение создает токены последовательно, чтобы у каждого участника была равная возможность взаимодействовать в собрании. Например, приложение полезно в сеансах Q&A и в собраниях, таких как схватка собраний.

Примечание.

Вкладки "Собрание" для приложения генератора маркеров собраний доступны только для классического клиента Teams.

Ключевые функции генератора маркеров собраний

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

Различные способы взаимодействия с пользователем

Token: запрашивает маркер для пользователя.
Готово: подтверждает создание маркера для пользователя.
Пропустить: пропускает текущего пользователя и переходит к следующему пользователю в очереди для получения маркера.

Примечание.

Пропуск доступен только для организаторов собраний.

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

Снимок экрана: окончательный экран вывода.

Предварительные требования

Осталось 19 мин

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

	Установка	Для использования...
	Microsoft Teams	Microsoft Teams позволяет взаимодействовать со всеми пользователями, с которыми вы работаете, с помощью приложений для чата, собраний и звонков в одном месте.
	Visual Studio 2022	Вы можете установить корпоративную версию в Visual Studio 2022, а также рабочие нагрузки ASP.NET и веб-разработки. Используйте последнюю версию.
	Учетная запись разработчика Microsoft 365	Доступ к учетной записи Teams с соответствующими разрешениями для установки приложения.
	Пакет SDK для .NET Core версии 3.1	Настраиваемые привязки для локальной отладки и развертываний приложений Функций Azure. Если вы не установили пакет SDK для .NET 3.1 (или более поздней версии) глобально, можно установить переносимую версию.
	Node.js и NPM	Серверной среды выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта.
	Туннель разработки	Функции приложений Teams (диалоговые боты, расширения сообщений и входящие веб-перехватчики) требуют входящих подключений. Туннель соединяет систему разработки с Teams. Туннель разработки — это мощный инструмент для безопасного открытия локального узла в Интернете и контроля доступа. Туннель разработки доступен в Visual Studio 2022 версии 17.7.0 или более поздней. или вы также можете использовать ngrok в качестве туннеля для подключения системы разработки к Teams. Он не требуется для приложений, которые содержат только вкладки. Этот пакет устанавливается в каталоге проекта (с помощью npm `devDependencies`).

Примечание.

После скачивания ngrok зарегистрируйтесь и установите authtoken.

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

Настройка локальной среды

Осталось 18 мин

Откройте Microsoft-Teams-Samples.
Выберите Код.
В раскрывающемся меню выберите Открыть с помощью GitHub Desktop.
Выберите Клонировать.

Регистрация приложения Microsoft Entra

Осталось 17 мин

Следующие действия помогут вам создать и зарегистрировать бота на портале Azure.

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

Добавление регистрации приложения

Перейдите на портал Azure.
Выберите Регистрация приложений.
Выберите + Новая регистрация.
Введите имя приложения.
Выберите Учетные записи в любом каталоге организации (любой клиент Microsoft Entra ID — Мультитенант).
Нажмите Зарегистрировать.

Ваше приложение зарегистрировано в Идентификаторе Microsoft Entra. Откроется страница обзора приложения.

Примечание.

Сохраните идентификатор приложения из идентификатора приложения (клиента) и каталога (клиента) для дальнейшего использования.

Создание туннеля

dev tunnel
ngrok

Откройте Visual Studio.
Выберите Создать новый проект.
В поле поиска введите ASP.NET. В результатах поиска выберите ASP.NET Core Web App.
Нажмите кнопку Далее.
Введите имя проекта и нажмите кнопку Далее.
Нажмите Создать.

Откроется окно обзора.
В раскрывающемся списке отладки выберите Dev Tunnels (без активного туннеля)>Создать туннель....

Открывается всплывающее окно.
Обновите следующие сведения во всплывающем окне:
1. Учетная запись. Введите учетную запись Майкрософт или GitHub.
2. Имя: введите имя туннеля.
3. Тип туннеля: в раскрывающемся списке выберите Временный.
4. Доступ: в раскрывающемся списке выберите Общедоступный.
Нажмите OK.

Появится всплывающее окно, показывающее, что туннель разработки успешно создан.
Нажмите OK.

Созданный туннель можно найти в раскрывающемся списке отладки следующим образом:
Нажмите клавишу F5 , чтобы запустить приложение в режиме отладки.
Если появится диалоговое окно Предупреждение системы безопасности , выберите Да.

Открывается всплывающее окно.
Нажмите Продолжить.

В новом окне браузера откроется домашняя страница туннеля разработки, и туннель разработки теперь активен.
Перейдите в Visual Studio и выберите Просмотреть выходные > данные.
В раскрывающемся меню консоли вывода выберите Dev Tunnels (Туннели разработки).

В консоли вывода отображается URL-адрес туннеля разработки.

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

ngrok http --host-header=localhost 3978

Совет

Если вы столкнулись с ERR_NGROK_4018, выполните действия, описанные в командной строке, чтобы зарегистрироваться и проверить подлинность ngrok. Затем выполните ngrok http --host-header=localhost 3978 команду .

В окне отображается URL-адрес HTTPS.

Снимок экрана: URL-адрес HTTPS ngrok.

Добавление веб-проверки подлинности

В левой области в разделе Управление выберите Проверка подлинности.
Выберите Добавить веб-сайт платформы>.
Введите URI перенаправления для приложения, добавив auth-end к полному доменному имени. Например, https://your-devtunnel-domain/auth-end или https://your-ngrok-domain/auth-end.
В разделе Неявное предоставление и гибридные потоки установите флажки Маркеры доступа и маркеры идентификаторов .
Нажмите Настроить.
В разделе Интернет выберите Добавить URI.
Введите https://token.botframework.com/.auth/web/redirect.
Выберите Сохранить.

Создание секрета клиента

В левой области в разделе Управление выберите Сертификаты & секреты.
В разделе Секреты клиента выберите + Новый секрет клиента.

Откроется окно Добавление секрета клиента .
Введите Описание.
Нажмите Добавить.
В разделе Значение выберите Копировать в буфер обмена , чтобы сохранить значение секрета клиента для дальнейшего использования.

Добавление разрешения API

В области слева в разделе Управление выберите Разрешения API.
Выберите + Добавить разрешение.
Выберите Microsoft Graph.
Выберите Делегированные разрешения.
Выберите следующие разрешения:
- Разрешения> OpenIdэлектронная почта, offline_access, openid, профиль.
- Пользователь>User.Read.
Выберите Добавить разрешения.
Примечание.
- Если приложению не предоставлено согласие ИТ-администратора, пользователи должны предоставить согласие при первом использовании приложения.
- Пользователям требуется согласие на разрешения API, только если приложение Microsoft Entra зарегистрировано в другом клиенте.

Добавление URI идентификатора приложения

В области слева в разделе Управление выберите Предоставить API.
Рядом с полем URI идентификатора приложения нажмите кнопку Добавить.
Обновите URI идентификатораapi://your-devtunnel-domain/botid-{AppID} приложения в формате или api://your-ngrok-domain/botid-{AppID} и нажмите кнопку Сохранить.

На следующем рисунке показано доменное имя:

Добавление области

В области слева в разделе Управление выберите Предоставить API.
Выберите + Добавить область.
Введите access_as_user в качестве имени области.
В разделе Кто может предоставить согласие? выберите Администраторы и пользователи.
Обновите значения остальных полей следующим образом:
- Введите , что Teams может получить доступ к профилю пользователя в качестве отображаемого имени согласия администратора.
- Введите Позволяет Teams вызывать веб-API приложения от имени текущего пользователя в качестве описания согласия администратора.
- Введите Teams для доступа к профилю пользователя и отправлять запросы от имени пользователя в качестве отображаемого имени согласия пользователя.
- Введите Включить Teams для вызова API этого приложения с теми же правами, что и у пользователя , в описании согласия пользователя.
Убедитесь, что параметру Состояние присвоено значение Включено.
Нажмите кнопку Добавить область.

На следующем рисунке показаны поля и значения:

Примечание.

Имя области должно совпадать с URI идентификатора приложения с /access_as_user добавлением в конце.

Добавление клиентского приложения

В области слева в разделе Управление выберите Предоставить API.

В разделе Авторизованные клиентские приложения определите приложения, которые вы хотите авторизовать для веб-приложения вашего приложения.
Выберите + Добавить клиентское приложение.
Добавьте мобильное или классическое приложение Teams и веб-приложение Teams.
1. Для мобильных или классических приложений Teams: введите идентификатор клиента как 1fec8e78-bce4-4aaf-ab1b-5451cc387264.
2. Для веб-сайта Teams: введите идентификатор клиента как 5e3ce6c0-2b1f-4285-8d4b-75ee78787346.
Установите флажок Авторизованные области .
Нажмите кнопку Добавить приложение.

На следующем рисунке отображается идентификатор клиента:

Обновление манифеста

В левой области выберите Манифест.
Задайте для accessTokenAcceptedVersion2 параметра значение и нажмите кнопку Сохранить.

Создание бота

Осталось 12 мин

Создание ресурса бота Azure

Примечание.

Если вы уже тестируете бот в Teams, выйдите из этого приложения и Teams. Чтобы увидеть это изменение, войдите еще раз.

Перейдите на домашнюю страницу.
Выберите + Создать ресурс.
В поле поиска введите Azure Bot.
Выберите ВВОД.
Выберите Azure Bot.
Нажмите Создать.
Введите имя бота в поле Дескриптор бота.
Выберите свою подписку в раскрывающемся списке.
Выберите свою группу ресурсов в раскрывающемся списке.

Если у вас нет существующей группы ресурсов, можно создать новую группу ресурсов. Чтобы создать новую группу ресурсов, выполните следующие действия.
1. Выберите Создать.
2. Введите имя ресурса и нажмите кнопку ОК.
3. Выберите расположение в раскрывающемся списке Расположение новой группы ресурсов .
В разделе Цены выберите Изменить план.
Выберите FO Free>Select.
В разделе Идентификатор приложения Майкрософт выберите Тип приложения в качестве мультитенантного.
В поле Тип создания выберите Использовать существующую регистрацию приложения.
Введите идентификатор приложения.

Примечание.

Нельзя создать несколько ботов с одним идентификатором приложения Майкрософт.
Выберите Проверить и создать.
После завершения проверки нажмите кнопку Создать.

Подготовка бота занимает несколько минут.
Выберите пункт Перейти к ресурсу.

Вы успешно создали бот Azure.

Добавление канала Teams

В левой области выберите Каналы.
В разделе Доступные каналы выберите Microsoft Teams.
Установите флажок, чтобы принять условия предоставления услуг.
Выберите Принять.
Нажмите Применить.

Добавление конечной точки обмена сообщениями

dev tunnel
ngrok

Используйте URL-адрес туннеля разработки в консоли вывода в качестве конечной точки обмена сообщениями.
В левой области в разделе Параметры выберите Конфигурация.
Обновите конечную точку обмена сообщениями в формате https://your-devtunnel-domain/api/messages.
Нажмите Применить.

Вы успешно настроили бот в службе Azure Bot.

Примечание.

Если ключ инструментирования Application Insights отображает ошибку, обновите идентификатор приложения.

Скопируйте URL-адрес HTTPS из ngrok.

Примечание.

URL-адрес HTTPS в ngrok — это полное доменное имя. — WebAppDomain это полное доменное имя, которое не включает https:// в него.
В левой области в разделе Параметры выберите Конфигурация.
Обновите конечную точку обмена сообщениями в формате https://your-ngrok-domain/api/messages.
Нажмите Применить.

Вы успешно настроили бот в службе Azure Bot.

Примечание.

Если ключ инструментирования Application Insights отображает ошибку с идентификатором приложения.

Настройка параметров приложения

Осталось 7 мин

Перейдите к файлу appsettings.json в клонированных репозиториях.
Откройте файл appsettings.json в Visual Studio Code и обновите следующие сведения:
- Задайте "MicrosoftAppId" для бота идентификатор приложения Майкрософт.
- Задайте "MicrosoftAppPassword"значение секрета клиента бота.
- Задайте "AzureAd"."TenantId" идентификатор клиента, в котором используется приложение.
Примечание.

Пример работает только в текущем клиенте.
- Задайте "AzureAd"."ApplicationId" для бота идентификатор приложения Майкрософт.
- Задайте "ContentBubbleUrl" url-адрес (https://[WebAppDomain]/contentBubble.html)iframe для пузырьков содержимого .
Примечание.

WebAppDomain — это домен ngrok, поэтому URL-адрес пузырька содержимого похож на https://ae57****.ngrok.io/contentBubble.html.

Настройка файла манифеста

Осталось 6 мин

Перейдите к файлу manifest.json в клонированного репозитория.
Откройте manifest.json файл в Visual Studio Code и внесите следующие изменения:
- Установите manifestVersion последнюю версию.
- Задайте значение $schemahttps://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json.
- Задайте значение resourceapi://[WebAppDomainName]/[MicrosoftAppId].
- Замените [companyName] на Contoso.
- Замените следующие разделы полным доменным именем:
  - websiteUrl
  - privacyUrl
  - termsOfUseUrl
- Замените все вхождения WebAppDomainName на доменное имя ngrok.
- Замените все вхождения MicrosoftAppId идентификатором приложения Microsoft бота.

Создание клиентского приложения с помощью установки npm

Осталось 5 мин

Перейдите в папку ClientApp в клонированного репозитория.
Скопируйте путь к папке ClientApp .
Откройте новое окно командной строки и измените текущий каталог на скопированный путь ClientApp .
Выполните следующую команду в командной строке, чтобы скачать пакеты и зависимости.
```
npm install
```
Выполните следующую команду в командной строке , чтобы запустить приложение.
```
npm start
```

Сборка и запуск службы

Осталось 4 мин

Для сборки и запуска службы используйте Visual Studio или командную строку.

Visual Studio
Командная строка

Откройте Visual Studio.
Перейдите в раздел Файл>Открыть>проект или решение....
Выберите Файл TokenApp.csproj в папке csharp .
Нажмите клавишу F5 , чтобы запустить проект.
Выберите Да, если появится следующий диалог:

Откроется веб-страница с сообщением Приложение готово!.

Перейдите в папку csharp в окне командной строки и введите следующую команду:

 dotnet run

Снимок экрана: командная строка — выполнение dotnet.

Включение предварительной версии для разработчиков

Осталось 3 мин

Включите отправку приложений в консоли администрирования клиента.
1. Войдите в Центр администрирования Microsoft 365 со своими учетными данными администратора.
2. В левой области выберите Показать все.
3. Выберите Teams.
4. В левой области выберите Приложения Teams.
5. Выберите Параметры политики.
6. Выберите Глобальный.
7. Включить положение в разделе Отправка пользовательских приложений.
8. Выберите Сохранить.
  
  Тестовый клиент может разрешить отправку пользовательского приложения.
  
  Примечание.
  
  Отправка пользовательского приложения занимает некоторое время, чтобы стать активным.
Перейдите в Microsoft Teams.
В правом верхнем углу интерфейса Teams выберите Параметры и другое (...) .
Выберите О приложении>Предварительная версия для разработчиков.
Выберите Переключиться на предварительную версию для разработчиков.

Добавление маркера собрания в Teams

Осталось 2 мин

В клонированного репозитория перейдите к csharp > AppManifest.
Создайте файл .zip со следующими файлами, которые находятся в папке AppManifest :
- manifest.json
- outline.png
- color.png
Создайте собрание в Teams с несколькими выступающими и участниками.
Присоединитесь к собранию.
После начала собрания выберите Приложения.
Во всплывающем окне выберите Управление приложениями.
Выберите Отправить приложение.
Выберите файл .zip, созданный в папке AppManifest , и нажмите кнопку Открыть.
Нажмите Добавить.

В разделе Управление приложениями отображается список приложений.
Перейдите на собрание Teams.
Выберите значок приложения . На странице выбора приложения приложение отображается как приложение маркера собрания.
Выберите Приложение маркера собрания.
Выберите Сохранить.

Приложение отображается в чате собрания.
Начните собрание.

Значок отображается на панели управления собранием.

Примечание.

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