Включение badging значка приложения для приложения Teams

Статья
06/30/2023

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

Когда во время собрания происходит новое действие, приложение вызывает targetedMeetingNotification API и отображает красный значок на значке приложения на объединенной панели собрания (U-bar). Когда участник выбирает значок приложения, приложение открывается на боковой панели собрания и эмблема исчезает.

Например, во время совместной работы в режиме реального времени на собрании, если участник добавляет комментарий в файл, добавленный в собрание, приложение вызывает targetedMeetingNotification API из боковой панели собрания участника. API активирует значок на значке приложения, чтобы другие участники знали о действии комментария.

На следующем рисунке показана ошибка значка приложения на панели U-bar собрания:

Примечание.

Значок приложения недоступен для облака сообщества для государственных организаций (GCC)-High и Министерства обороны (DOD) среды.
Ошибка значков приложений не поддерживается для мобильных клиентов.
Использование значков приложений не поддерживается для собраний каналов.

Чтобы включить badging значков приложения, выполните следующие действия.

Включение параметров манифеста приложения для с ошибками значка приложения
Включение badging значка приложения для приложения

Включение параметров манифеста приложения для с ошибками значка приложения

Чтобы включить badging значков приложения, необходимо:

Убедитесь, что вы настроили meetingSidePanel в качестве context свойства для приложения.
authorization Настройте свойства и name и type в resourceSpecific поле манифеста приложения следующим образом:


"webApplicationInfo": {
    "id": "<<MICROSOFT-APP-ID>>",
    "resource": "https://RscBasedStoreApp"  },
  "authorization": {
    "permissions": {
      "resourceSpecific": [
        {
          "name": "OnlineMeetingNotification.Send.Chat",
          "type": "Application"        }
      ]
    }
  }

Включение badging значка приложения для приложения

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

API уведомления о целевом собрании и значка приложения расширен для поддержки возможности распознавания значков приложения на значке приложения и передачи идентификаторов МРТ пользователей предполагаемых получателей. Теперь surfaces параметр поддерживает meetingTabIcon значение, которое используется приложением.

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

Пример

Пример справочника по коду

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

Пример справочника по коду

TeamsInfo.sendMeetingNotification(context, notificationPayload, meetingId);

{
    "type": "targetedMeetingNotification",
    "value": {
        "recipients": [
            "<participant1 MRI>",
            "<participant2 MRI>" 
        ],
        "surfaces": [
            {
                "surface": "meetingTabIcon",
                "tabEntityId": "<tab id from tab sdk>" // optional           
            }
        ]
    }
}

Код ответа

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

Код ответа	Описание
202	Уведомление успешно отправлено.
207	Уведомления отправляются только нескольким участникам.
400	Сбой проверки полезных данных запроса уведомления о собрании.
401	Недопустимый маркер бота.
403	Бот не может отправлять уведомление.
404	Чат собрания не найден или никто из участников не найден в реестре.

Ограничения

Значок приложения отображает только одно уведомление для пользователя в минуту для каждого собрания.
Ошибка значка приложения отображается не более 50 первых участников для определенного собрания.

Пример кода

Название примера	Описание	Node.js	.NET
Ошибка значка приложения для приложения Teams	В этом примере показано, как включить неисправимые значки приложения для приложения Teams.	Просмотр	Просмотр

Поделиться через