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

  • Artikel

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:

Screenshot: App-Symbol in der U-Leiste in einer Teams-Besprechung

Hinweis

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

  1. Aktivieren der App-Manifesteinstellungen für App-Symbol-Badging
  2. 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);

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

Siehe auch