Partilhar via

Migração da funcionalidade de notificações push

Este tópico contém orientações de migração na área de recursos de notificações por push.

Importante

Atualmente, apenas notificações por push brutas e notificações por push de aplicativos são suportadas. Não há suporte para notificações push de emblema e notificações push de mosaico.

Resumo das diferenças de API e/ou recursos

As notificações push podem ser divididas nestes quatro estágios separados.

Etapa UWP (Plataforma Universal do Windows) SDK de aplicativos do Windows
Identidade Centro de Parceiros (MSA) Registro de Aplicativo do Azure (AAD)
Pedido de canal Assíncrono Assíncrono
ID de Registo da Aplicação Azure
Lógica de repetição incorporada (até 5 tentativas)
Ativação Em processo, PushTrigger*, ativação COM* Em processo, ativação COM, ShellExecute
Enviar notificações push Utiliza o endpoint 'login.live.com' para receber um token de acesso Usa o endpoint https://login.microsoftonline.com/{tenantID}/oauth2/token para pedido de token

* Suportado para Windows 10, versão 2004 (10.0; Build 19041), e mais tarde.

Configuração de identidade

No SDK do Aplicativo Windows, o recurso de notificações por push usa a identidade do Registro de Aplicativo do Azure (AAD), que remove o requisito de ter um PFN (Nome da Família de Pacotes) do Partner Center para usar notificações por push.

  • Para uma aplicação UWP , inscreva-se e registe a aplicação no Centro de Parceiros da Loja do Windows .
  • Para um aplicativo SDK de Aplicativo Windows, crie uma conta do Azure e crie umRegistro de Aplicativo do Azure (AAD).

Solicitações de canal

As solicitações de canal são tratadas de forma assíncrona e exigem o GUID do Azure AppID e o tenantID do Azure (recebe o AppID do Azure e o ID do inquilino de um registo de aplicação AAD). Você usa o Azure AppID para sua identidade no lugar do PFN (Nome da Família do Pacote) que um aplicativo UWP usa. Caso a solicitação encontre um erro recorrente, a plataforma de notificação tentará várias tentativas.

Um aplicativo SDK de Aplicativo Windows pode verificar o status de uma solicitação de canal.

Ativação

Consulte as etapas de registro e ativação do SDK do Aplicativo Windows em Configurar seu aplicativo para receber notificações por push.

Enviar notificações push

Uma aplicação Windows App SDK deve solicitar o token de acesso do endpoint AAD, em vez do endpoint MSA.

Solicitação de token de acesso

Para uma aplicação UWP:

POST /accesstoken.srf HTTP/1.1
Host: login.live.com
Content-Type: application/x-www-form-urlencoded
Cookie: MSCC=73.140.231.96-US
Content-Length: 112

grant_type=client_credentials&client_id=<AppID_Here>&client_secret=<Client_Secret_Here>&scope=notify.windows.com

Para uma aplicação SDK do Windows App (solicitação de token de acesso AAD):

POST /{tenantID}/oauth2/v2.0/token Http/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 160

grant_type=client_credentials&client_id=<Azure_App_Registration_AppId_Here>&client_secret=<Azure_App_Registration_Secret_Here>&resource=https://wns.windows.com/

HTTP Post para WNS

Quando se trata de enviar uma solicitação HTTP POST para o WNS, não há alterações da UWP. O token de acesso continua a ser enviado no cabeçalho de autorização.

POST /?token=[ChannelURI] HTTP/1.1
Host: dm3p.notify.windows.com
Content-Type: application/octet-stream
X-WNS-Type: wns/raw
Authorization: Bearer [your access token]
Content-Length: 46

{ Sync: "Hello from the Contoso App Service" }

Ver também

  • Last updated on