PushNotificationChannelManager Classe

Definição

Namespace:

Windows.Networking.PushNotifications

Cria objetos que você usa para recuperar canais de notificação por push do WNS (Serviços de Notificação por Push do Windows). Esses canais são associados a um aplicativo ou bloco secundário.

public ref class PushNotificationChannelManager abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class PushNotificationChannelManager final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class PushNotificationChannelManager

Public Class PushNotificationChannelManager

Herança

Object Platform::Object IInspectable PushNotificationChannelManager

Atributos

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	internetClient

Exemplos

O exemplo a seguir mostra o uso do método CreatePushNotificationChannelForApplicationAsync para recuperar um canal de notificação por push para o aplicativo de chamada.

var pushNotifications = Windows.Networking.PushNotifications;
var channel;

function openNotificationsChannel() {
    var channelOperation = pushNotifications.PushNotificationChannelManager.createPushNotificationChannelForApplicationAsync();
    return channelOperation.then(function (newChannel) {
        channel = newChannel;
    }
);

O exemplo a seguir mostra o uso do método CreatePushNotificationChannelForSecondaryTileAsync para recuperar um canal de notificação por push para um bloco secundário.

var pushNotifications = Windows.Networking.PushNotifications;
var channel;

pushNotifications.PushNotificationChannelManager.createPushNotificationChannelForSecondaryTileAsync(myTileId).then(function (channel) {
    // Your code here.
})

Comentários

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	GetForUser
1703	15063	GetDefault
2004	19041	ChannelsRevoked

Métodos

CreatePushNotificationChannelForApplicationAsync()	Cria um objeto associado ao aplicativo de chamada, por meio do qual você recupera um canal de notificação por push do WNS (Serviços de Notificação por Push do Windows).
CreatePushNotificationChannelForApplicationAsync(String)	Cria um objeto, associado a um aplicativo especificado, por meio do qual você recupera um canal de notificação por push do WNS (Serviços de Notificação por Push do Windows). O aplicativo especificado deve estar no mesmo pacote que o aplicativo de chamada. Essa sobrecarga só deve ser chamada de um pacote de vários aplicativos, a maioria dos aplicativos deve usar o método sem parâmetro.
CreatePushNotificationChannelForSecondaryTileAsync(String)	Cria um objeto, associado a um bloco secundário, por meio do qual você recupera um canal de notificação por push do WNS (Serviços de Notificação por Push do Windows). O bloco pode ser um bloco secundário do aplicativo de chamada ou de qualquer outro aplicativo no mesmo pacote.
GetDefault()	Obtém o gerenciador do usuário ativo.
GetForUser(User)	Obtém as notificações por push para o usuário especificado.

Eventos

ChannelsRevoked

Gerado quando o canal de push é revogado, para que você possa solicitar imediatamente um novo canal. Isso minimiza qualquer tempo de inatividade resultante do uso de um canal WNS revogado. O tipo de argumentos de evento é PushNotificationChannelsRevokedEventArgs.

Confira também

• PushNotificationChannel
• Visão geral dos Serviços de Notificação por Push do Windows (WNS)
• Exemplo de notificações por push e periódicas (arquivadas)
• Guia de início rápido: enviando uma notificação por push
• Como solicitar, criar e salvar um canal de notificação
• Cabeçalhos de solicitação e resposta de serviço de notificação por push