PushNotificationChannelManager クラス

定義

名前空間:

Windows.Networking.PushNotifications

Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得するために使用するオブジェクトを作成します。 これらのチャネルは、アプリまたは セカンダリ タイルにバインドされます。

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

継承

Object Platform::Object IInspectable PushNotificationChannelManager

属性

ContractVersionAttribute ThreadingAttribute MarshalingBehaviorAttribute

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)
アプリの機能	internetClient

例

次の例は、 CreatePushNotificationChannelForApplicationAsync メソッドを使用して、呼び出し元アプリのプッシュ通知チャネルを取得する方法を示しています。

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

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

次の例は、 CreatePushNotificationChannelForSecondaryTileAsync メソッドを使用して、セカンダリ タイルのプッシュ通知チャネルを取得する方法を示しています。

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

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

注釈

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	GetForUser
1703	15063	GetDefault
2004	19041	ChannelsRevoked

メソッド

CreatePushNotificationChannelForApplicationAsync()	呼び出し元アプリにバインドされたオブジェクトを作成します。このオブジェクトを使用して、Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得します。
CreatePushNotificationChannelForApplicationAsync(String)	Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得する、指定したアプリにバインドされた オブジェクトを作成します。 指定したアプリは、呼び出し元アプリと同じパッケージに含まれている必要があります。 このオーバーロードはマルチアプリ パッケージからのみ呼び出す必要があります。ほとんどのアプリでは、 メソッドをパラメーターなしで使用する必要があります。
CreatePushNotificationChannelForSecondaryTileAsync(String)	セカンダリ タイルにバインドされたオブジェクトを作成します。これにより、Windows プッシュ通知サービス (WNS) からプッシュ通知チャネルを取得できます。 タイルには、呼び出し元アプリのセカンダリ タイル、または同じパッケージ内の他のアプリを指定できます。
GetDefault()	アクティブなユーザーのマネージャーを取得します。
GetForUser(User)	指定したユーザーのプッシュ通知を取得します。

イベント

ChannelsRevoked

プッシュ チャネルが取り消されたときに発生し、新しいチャネルをすぐに要求できるようにします。 これにより、取り消された WNS チャネルの使用によるダウンタイムが最小限に抑えられます。 イベント引数の型は PushNotificationChannelsRevokedEventArgs です。

こちらもご覧ください

• PushNotificationChannel
• Windows プッシュ通知サービス (WNS) の概要
• プッシュ通知と定期的な通知のサンプル (アーカイブ済み)
• クイック スタート: プッシュ通知の送信
• 通知チャネルを要求、作成、保存する方法
• プッシュ通知サービスの要求ヘッダーと応答ヘッダー