Habilitación de la activación del icono de aplicación para la aplicación de Teams

Artículo
01/19/2024

El icono de aplicación badging ayuda a un participante de la reunión a identificar cualquier actividad de la aplicación durante una reunión. Los participantes reciben una notificación de actividad para las aplicaciones de reunión.

Cuando hay nueva actividad durante la reunión, la aplicación llama a la targetedMeetingNotification API y muestra un distintivo rojo en el icono de la aplicación en la barra unificada de reunión (barra U). Cuando el participante selecciona el icono de aplicación, la aplicación se abre en el panel lateral de la reunión y el distintivo desaparece.

Por ejemplo, durante una colaboración en tiempo real en una reunión, si un participante agrega un comentario en un archivo agregado a la reunión, la aplicación llama a la targetedMeetingNotification API desde el panel lateral de la reunión del participante. La API desencadena un distintivo en el icono de la aplicación para que otros participantes conozcan la actividad de comentario.

En la imagen siguiente se muestra el icono de la aplicación que aparece en la barra U de la reunión:

Nota:

El icono de la aplicación no está disponible para los entornos de nube de la comunidad gubernamental (GCC)-Alto y Departamento de Defensa (DOD ).
No se admite el error de icono de aplicación para clientes móviles.
No se admite el error de icono de aplicación para las reuniones de canal.

Para habilitar la activación del icono de aplicación, siga estos pasos:

Habilitación de la configuración del manifiesto de la aplicación para la activación incorrecta del icono de aplicación
Habilitación de la badging de icono de aplicación para la aplicación

Habilitación de la configuración del manifiesto de la aplicación para la activación incorrecta del icono de aplicación

Para habilitar la activación del icono de aplicación, debe hacer lo siguiente:

Asegúrese de que ha configurado meetingSidePanel como una context propiedad para la aplicación.
Configure la authorization propiedad y las name propiedades y type en el resourceSpecific campo del manifiesto de la aplicación de la siguiente manera:


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

Habilitación de la badging de icono de aplicación para la aplicación

Para habilitar la activación del icono de aplicación, asegúrese de que ha habilitado la notificación de destino en la reunión.

La API de badging de notificación de reunión dirigida e icono de aplicación se extiende para admitir la funcionalidad de error de icono de aplicación en el icono de la aplicación y pasar los identificadores de MRI de usuario de los destinatarios previstos. El surfaces parámetro ahora admite meetingTabIcon el valor , que usa la aplicación.

La aplicación también puede pasar , tabEntityIdsi hay varias instancias de la aplicación agregadas a la misma reunión. tabEntityId Si no se pasa, Teams muestra el distintivo en el primer icono de aplicación de la ventana de reunión de usuarios.

Ejemplo

Referencia de código de ejemplo

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

Referencia de código de ejemplo

TeamsInfo.sendMeetingNotification(context, notificationPayload, meetingId);

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

Código de respuesta

En la tabla siguiente se incluyen los códigos de respuesta:

Código de respuesta	Descripción
202	La notificación se envía correctamente.
207	Las notificaciones se envían solo a algunos participantes.
400	Error en la validación de la carga de la solicitud de notificación de reunión.
401	El token de bot no es válido.
403	El bot no puede enviar la notificación.
404	No se encontró el chat de reunión o no se encontró ninguno de los participantes en la lista.

Limitaciones

El icono de aplicación que está mal muestra solo una notificación para un usuario en un minuto por reunión.
El icono de la aplicación se muestra a un máximo de 50 primeros participantes para una reunión determinada.

Ejemplo de código

Ejemplo de nombre	Descripción	Node.js	.NET
Icono de aplicación incorrecto para la aplicación de Teams	En este ejemplo se muestra cómo habilitar el icono de aplicación para la aplicación de Teams.	View	Ver

Share via