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

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 :

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

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           
            }
        ]
    }
}

Code de réponse

Le tableau suivant inclut les codes de réponse :

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

Voir aussi

• Onglets générer pour la réunion
• Générer une notification en réunion pour une réunion Teams
• API de notification de réunion ciblée et d’icône d’application