次の方法で共有


PushNotificationChannelManager クラス

定義

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)]
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
継承
Object Platform::Object IInspectable PushNotificationChannelManager
属性

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 です

適用対象

こちらもご覧ください