Aktivieren der App-Symbol-Badging für Ihre Teams-App

Artikel
01/19/2024

Das Badging des App-Symbols hilft einem Besprechungsteilnehmer, jede App-Aktivität während einer Besprechung zu identifizieren. Teilnehmer erhalten Aktivitätsbenachrichtigungen für die Besprechungs-Apps.

Wenn während der Besprechung neue Aktivitäten auftreten, ruft die App die targetedMeetingNotification API auf und zeigt ein rotes Signal auf dem App-Symbol in der einheitlichen Besprechungsleiste (U-Bar) an. Wenn der Teilnehmer das App-Symbol auswählt, wird die App im Seitenbereich der Besprechung geöffnet, und der Badge wird entfernt.

Wenn beispielsweise während einer Zusammenarbeit in Echtzeit in einer Besprechung ein Teilnehmer einen Kommentar in einer Datei hinzufügt, die der Besprechung hinzugefügt wurde, ruft die App die targetedMeetingNotification API aus dem Seitenbereich der Besprechung des Teilnehmers auf. Die API löst einen Badge auf dem App-Symbol aus, um andere Teilnehmer auf die Kommentaraktivität aufmerksam zu machen.

Die folgende Abbildung zeigt das App-Symbol badging in der Besprechungs-U-Leiste:

Hinweis

App-Symbol badging ist für Umgebungen mit Government Community Cloud (GCC)-High und Department of Defense (DOD) nicht verfügbar.
Das Badging von App-Symbolen wird für mobile Clients nicht unterstützt.
Das Badging von App-Symbolen wird für Kanalbesprechungen nicht unterstützt.

Führen Sie die folgenden Schritte aus, um das Badging von App-Symbolen zu aktivieren:

Aktivieren der App-Manifesteinstellungen für App-Symbol-Badging
Aktivieren der App-Symbol-Badging für Ihre App

Aktivieren der App-Manifesteinstellungen für App-Symbol-Badging

Um die App-Symbol-Badging zu aktivieren, müssen Sie:

Stellen Sie sicher, dass Sie als context Eigenschaft für Ihre App konfiguriert meetingSidePanel haben.
Konfigurieren Sie die authorization Eigenschaft und die name Eigenschaften und type unter dem resourceSpecific Feld im App-Manifest wie folgt:


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

Aktivieren der App-Symbol-Badging für Ihre App

Um die App-Symbol-Badging zu aktivieren, stellen Sie sicher, dass Sie eine gezielte Besprechungsbenachrichtigung aktiviert haben.

Die Benachrichtigungs- und App-Symbol-Badging-API wurde erweitert, um die App-Symbol-Badging-Funktion auf dem App-Symbol zu unterstützen und die MRI-IDs des Benutzers der vorgesehenen Empfänger zu übergeben. Der surfaces Parameter unterstützt meetingTabIcon jetzt den Wert, der von der App verwendet wird.

Die App kann auch übergeben tabEntityId, wenn der gleichen Besprechung mehrere Instanzen der App hinzugefügt wurden. Wenn nicht tabEntityId übergeben wird, zeigt Teams den Badge auf dem ersten App-Symbol im Besprechungsfenster der Benutzer an.

Beispiel

Beispielcodereferenz

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

Beispielcodereferenz

TeamsInfo.sendMeetingNotification(context, notificationPayload, meetingId);

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

Antwortcode

Die folgende Tabelle hat die Antwortcodes:

Antwortcode	Beschreibung
202	Die Benachrichtigung wurde erfolgreich gesendet.
207	Benachrichtigungen werden nur an wenige Teilnehmer gesendet.
400	Fehler bei der Überprüfung der Nutzlast der Besprechungsbenachrichtigungsanforderung.
401	Das Bottoken ist ungültig.
403	Der Bot darf die Benachrichtigung nicht senden.
404	Der Besprechungschat wurde nicht gefunden, oder keiner der Teilnehmer wurde in der Liste gefunden.

Begrenzungen

App-Symbol badging zeigt nur eine Benachrichtigung für einen Benutzer in einer Minute pro Besprechung an.
App-Symbol badging wird maximal den ersten 50 Teilnehmern für eine bestimmte Besprechung angezeigt.

Codebeispiel

Beispielname	Beschreibung	Node.js	.NET
App-Symbol badging für Ihre Teams-App	In diesem Beispiel wird veranschaulicht, wie Sie app icon badging für Ihre Teams-App aktivieren.	View	Anzeigen

Teilen über