PushNotificationChannelManager Classe

  • Referência

Definição

Namespace:
Windows.Networking.PushNotifications
Editar

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)]
class PushNotificationChannelManager final
/// [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)]
public static class PushNotificationChannelManager
[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.

Aplica-se a

Confira também