Partager via

Activer le badging d’icône d’application pour votre application Teams

  • Article

Le badging d’icône d’application permet à un participant à une réunion d’identifier toute activité d’application pendant une réunion. Les participants reçoivent une notification d’activité pour les applications de réunion.

En cas de nouvelle activité pendant la réunion, l’application appelle l’API targetedMeetingNotification et affiche un badge rouge sur l’icône de l’application dans la barre unifiée de la réunion (barre U). Lorsque le participant sélectionne l’icône de l’application, l’application s’ouvre dans le panneau latéral de la réunion et le badge disparaît.

Par exemple, lors d’une collaboration en temps réel dans une réunion, si un participant ajoute un commentaire dans un fichier ajouté à la réunion, l’application appelle l’API targetedMeetingNotification à partir du panneau latéral de la réunion du participant. L’API déclenche un badge sur l’icône de l’application pour informer les autres participants de l’activité de commentaire.

L’image suivante montre l’icône de l’application dans la barre U de la réunion :

Capture d’écran montrant l’icône de l’application dans la barre U dans la réunion Teams.

Remarque

Pour activer le badging d’icône d’application, procédez comme suit :

  1. Activer les paramètres du manifeste d’application pour le badging d’icône d’application
  2. Activer le badging d’icône d’application pour votre application

Activer les paramètres du manifeste d’application pour le badging d’icône d’application

Pour activer le badging d’icônes d’application, vous devez :

  • Vérifiez que vous avez configuré meetingSidePanel en tant que context propriété pour votre application.
  • Configurez la authorization propriété et les name propriétés et type sous le resourceSpecific champ dans le manifeste de l’application comme suit :

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

Activer le badging d’icône d’application pour votre application

Pour activer le badging d’icône d’application, vérifiez que vous avez activé la notification ciblée en réunion.

L’API de notification de réunion ciblée et de badging d’icône d’application est étendue pour prendre en charge la fonctionnalité de badging d’icône d’application sur l’icône de l’application et transmettre les ID d’IRM utilisateur des destinataires prévus. Le surfaces paramètre prend désormais en charge meetingTabIcon la valeur, qui est utilisée par l’application.

L’application peut également passer le tabEntityId, si plusieurs instances de l’application ont été ajoutées à la même réunion. Si n’est tabEntityId pas passé, Teams affiche le badge sur la première icône de l’application dans la fenêtre de réunion des utilisateurs.

Exemple

Exemple de référence de code

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

Code de réponse

Le tableau suivant inclut les codes de réponse :

Code de réponse Description
202 La notification est envoyée avec succès.
207 Les notifications sont envoyées uniquement à quelques participants.
400 Échec de la validation de la charge utile de la demande de notification de réunion.
401 Le jeton de bot n’est pas valide.
403 Le bot n’est pas autorisé à envoyer la notification.
404 La conversation de réunion est introuvable ou aucun des participants n’a été trouvé dans la liste.

Limitations

  • Le badging d’icône d’application n’affiche qu’une seule notification pour un utilisateur en une minute par réunion.

  • Le badging d’icône d’application s’affiche pour un maximum de 50 premiers participants pour une réunion particulière.

Exemple de code

Exemple de nom Description Node.js .NET
Erreur d’icône d’application pour votre application Teams Cet exemple montre comment activer le badging d’icône d’application pour votre application Teams. View View

Voir aussi