PushNotificationChannelManager クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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 PushNotificationChannelManagerPublic Class 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 です。 |