Ativar a configuração incorreta do ícone de aplicação para a sua aplicação Teams

Artigo
06/24/2024

A má configuração do ícone da aplicação ajuda um participante da reunião a identificar qualquer atividade de aplicação durante uma reunião. Os participantes recebem uma notificação de atividade para as aplicações de reunião.

Quando há uma nova atividade durante a reunião, a aplicação chama a targetedMeetingNotification API e apresenta um distintivo vermelho no ícone da aplicação na barra unificada da reunião (barra U). Quando o participante seleciona o ícone da aplicação, a aplicação é aberta no painel lateral da reunião e o distintivo desaparece.

Por exemplo, durante uma colaboração em tempo real numa reunião, se um participante adicionar um comentário num ficheiro adicionado à reunião, a aplicação chama a targetedMeetingNotification API a partir do painel do lado da reunião do participante. A API aciona um distintivo no ícone da aplicação para que outros participantes estejam cientes da atividade do comentário.

A imagem seguinte mostra-lhe o ícone da aplicação a desativar na barra U da reunião:

Observação

O ícone de aplicação não está disponível para ambientes de Cloud da Comunidade Governamental (GCC)- Alto e Departamento de Defesa (DOD ).
A má gestão do ícone de aplicação não é suportada para clientes móveis.
A eliminação de erros no ícone da aplicação não é suportada para reuniões de canal.

Para ativar a badging do ícone da aplicação, siga estes passos:

Ativar definições de manifesto de aplicação para a aplicação ícone de badging
Ativar a badging do ícone da aplicação para a sua aplicação

Ativar definições de manifesto de aplicação para a aplicação ícone de badging

Para ativar a badging do ícone da aplicação, tem de:

Certifique-se de que configurou meetingSidePanel como uma context propriedade para a sua aplicação.
Configure a authorization propriedade e as name propriedades e type no resourceSpecific campo no manifesto da aplicação da seguinte forma:


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

Ativar a badging do ícone da aplicação para a sua aplicação

Para ativar a eliminação de erros do ícone da aplicação, certifique-se de que ativou a notificação direcionada na reunião.

A API de notificação de reunião e aplicação direcionadas são expandidas para suportar a capacidade de desativação do ícone de aplicação no ícone da aplicação e transmitir os IDs de RESSONÂNCIA DO utilizador dos destinatários pretendidos. O surfaces parâmetro suporta agora o meetingTabIcon valor, que é utilizado pela aplicação.

A aplicação também pode transmitir o tabEntityId, se existirem várias instâncias da aplicação adicionadas à mesma reunião. Se o tabEntityId não for aprovado, o Teams apresenta o distintivo no primeiro ícone da aplicação na janela de reunião dos utilizadores.

Exemplo

Referência de código de exemplo

TeamsInfo.SendMeetingNotificationAsync(context, notificationPayload, meetingId);

Referência de código de exemplo

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 da resposta

A tabela a seguir inclui os códigos de resposta:

Código da resposta	Descrição
202	A notificação é enviada com êxito.
207	As notificações são enviadas apenas para alguns participantes.
400	Falha na validação do payload do pedido de notificação de reunião.
401	O token do bot é inválido.
403	O bot não tem permissão para enviar a notificação.
404	A conversa da reunião não foi encontrada ou nenhum dos participantes foi encontrado na lista.

Limitações

O ícone de aplicação a desativar apresenta apenas uma notificação para um utilizador num minuto por reunião.
O ícone de aplicação é apresentado como um máximo de 50 primeiros participantes para uma determinada reunião.

Exemplo de código

Nome do exemplo	Descrição	Node.js	.NET
Ícone de aplicação a desativar para a sua aplicação Teams	Este exemplo demonstra como ativar o ícone de aplicação para a sua aplicação Teams.	View	Exibir

Partilhar via