次の方法で共有


Windows.ApplicationModel.Background 名前空間

アプリが中断された場合でも、アプリでバックグラウンド タスクをスケジュールしてアプリ コードを実行できるようにします。

バックグラウンド タスクは、ユーザーの操作を必要としない小さな作業項目、またはトースト アクションの処理を目的としています。 バックグラウンド タスクに適したシナリオとしては、メールのダウンロード、受信チャット メッセージのトースト通知の表示、システム条件の変更への対応などがあります。

バックグラウンド タスクの実装に関するガイダンスについては、「 バックグラウンド タスクでアプリをサポートする (JavaScript と HTML を使用する)」 または「 バックグラウンド タスクでアプリをサポート する」を参照してください。 バックグラウンド タスクを実装する方法を示すコード例については、「 バックグラウンド タスクのサンプル」を参照してください。

クラス

ActivitySensorTrigger

ActivitySensor が入力を受信したときにアクティブ化されるトリガーを表します。 これは、アプリケーションがアクティビティ センサーに応答する必要がある場合に使用されます。

AlarmApplicationManager

アラームを設定するためのアクセス許可をユーザーに要求し、アプリがアラームを設定するためのユーザーアクセス許可の状態を取得します。

AppBroadcastTrigger

アプリケーションがゲームプレイブロードキャストを開始したときにバックグラウンド タスクの実行をトリガーするイベントを表します。

AppBroadcastTriggerProviderInfo

ロゴ、表示名、ビデオの特性など、ゲームプレイをブロードキャストしているアプリケーションに関する情報を提供します。

ApplicationTrigger

これにより、アプリケーション内からバックグラウンド タスクをプログラムでトリガーできます。

ApplicationTriggerDetails

ApplicationTrigger の詳細。

AppointmentStoreNotificationTrigger

予定ストアへの変更を処理するためのバックグラウンド タスクを起動するトリガーを表します。

BackgroundExecutionManager

バックグラウンド タスクを実行するためのアクセス許可を管理します。

BackgroundTaskBuilder

システムに登録するバックグラウンド タスクを表します。

BackgroundTaskCompletedEventArgs

完了通知が送信された時点でのタスクの完了情報を表します。

BackgroundTaskDeferral

IBackgroundTaskInstance.GetDeferral メソッドによって返されるバックグラウンド タスクの遅延を表します。

BackgroundTaskProgressEventArgs

進行状況更新通知が送信された時点のタスクの進行状況情報を表します。

BackgroundTaskRegistration

システムに登録されているバックグラウンド タスクを表します。

BackgroundTaskRegistrationGroup

バックグラウンド タスクの登録を個別に維持できるように、グループ化セマンティクスを提供します。

BackgroundWorkCost

バックグラウンド タスクのリソースの可用性に関するヒントを取得します。 バックグラウンド タスクでは、このヒントを使用して、アクティブ化時に実行する作業量を決定できます。

BluetoothLEAdvertisementPublisherTrigger

バックグラウンドで Bluetooth LE アドバタイズをアドバタイズするために登録されるトリガーを表します。

BluetoothLEAdvertisementWatcherTrigger

バックグラウンドで Bluetooth LE アドバタイズをスキャンするために登録されているトリガーを表します。

CachedFileUpdaterTrigger

キャッシュされたファイル アップデーター コントラクトを有効にするバックグラウンド タスクを起動するトリガーを表します。

CachedFileUpdaterTriggerDetails

トリガーを呼び出したキャッシュされたファイル操作の詳細を提供します。

ChatMessageNotificationTrigger

テキスト メッセージの通知がある場合にアクティブ化されるトリガーを表します。

ChatMessageReceivedNotificationTrigger

コンテンツに従ってフィルター処理する必要がある受信メッセージを処理するバックグラウンド タスクを起動するトリガーを表します。 メッセージのフィルター処理の詳細については、「 Windows.ApplicationModel.CommunicationBlocking」を参照してください。

CommunicationBlockingAppSetAsActiveTrigger

優先ブロック アプリとして選択されている場合に通信ブロック アプリケーションをアクティブ化するトリガーを表します。

ユーザーは、一度に複数の通信ブロック アプリケーションをインストールできます。 このトリガーは、アクティブな通信ブロック アプリケーションとして選択されたことをアプリケーションに通知するために使用されます。 通信ブロック API の詳細については、「 Windows.ApplicationModel.CommunicationBlocking」を参照してください。

ContactStoreNotificationTrigger

連絡先ストアへの変更を処理するためのバックグラウンド タスクを起動するトリガーを表します。

ContentPrefetchTrigger

Web リソースをプリフェッチするときにカスタム ハンドラーを実行する機能を提供します。

ConversationalAgentTrigger

Windows プラットフォーム エージェント アクティブ化ランタイム (AAR) を介してデジタル アシスタント通信を処理するためのバックグラウンド タスクを起動するトリガーを表します。

CustomSystemEventTrigger

このクラスを使用すると、カスタム システム トリガーを指定して登録し、システムによってトリガーされたときに応答することができます。

DeviceConnectionChangeTrigger

デバイスの接続状態が変更されたときにバックグラウンド タスクを起動するトリガーを表します。

DeviceManufacturerNotificationTrigger

デバイスの製造元の操作を有効にするためにバックグラウンド タスクを起動するトリガーを表します。

DeviceServicingTrigger

デバイスの実行時間の長い更新 (ファームウェアまたは設定) を開始するためにアプリケーションがトリガーできるイベントを表します。

Windows 8.1を使用すると、USB、HID、Bluetooth 経由で通信する周辺機器用の UWP アプリを開発できます。 たとえば、ユーザーが PC 上のコンテンツをデバイスとの間で同期したり、設定やファームウェアの更新など、デバイス自体に対して実行時間の長い更新を実行したりする必要がある場合があります。 Windows 8.1には、デバイスをバックグラウンドで同期および更新できる 2 つのバックグラウンド タスクと対応する API (DeviceServicingTrigger と DeviceUseTrigger) が用意されています。 このトピックでは、DeviceServicingTrigger の API リファレンス情報を提供します。デバイス アプリのコンテキストでこのトリガーを使用する方法については、「UWP デバイス アプリの デバイス同期と更新」を参照してください。

DeviceServicingTrigger バックグラウンド タスクを使用すると、周辺機器と対話する UWP アプリで、アプリの中断中に長時間実行されるデバイスの更新 (設定の転送やファームウェアの更新など) を実行できます。 バックグラウンドでデバイスを更新するには、バックグラウンド タスクが使用されるたびにユーザーの承認が必要です。 DeviceUseTrigger バックグラウンド タスクとは異なり、DeviceServicingTrigger バックグラウンド タスクでは、デバイスの再起動と切断が可能で、最大 30 分のバックグラウンド アクティビティが許可されます。

重要

このトリガーは、単一プロセスのバックグラウンド タスクでは使用できません。

DeviceUseTrigger

Windows ランタイム アプリがトリガーして、デバイスまたはセンサーで実行時間の長い操作を開始できるイベントを表します。

DeviceUseTrigger を使用すると、フォアグラウンド アプリが中断されている場合でも、Windows ランタイムアプリからバックグラウンドでセンサーと周辺機器にアクセスできます。 たとえば、アプリが実行されている場所によっては、バックグラウンド タスクを使ってデバイスまたはモニターのセンサーとデータを同期することができます。

このクラスは、UWP アプリと 8.x アプリWindows Phone使用できます。 ただし、 DeviceUseTrigger バックグラウンド タスクは異なる API をサポートしており、実行場所 (PC または電話) に応じて異なるポリシーが適用されます。 これらの違いの詳細については、「 バックグラウンド タスクからセンサーとデバイスにアクセスする」を参照してください。

重要

このトリガーは、単一プロセスのバックグラウンド タスクでは使用できません。

PC で DeviceUseTrigger を使用する方法を示すサンプルについては、 カスタム USB デバイスのサンプルを参照してください。 電話のサンプルについては、 バックグラウンド センサーのサンプルを参照してください。

DeviceWatcherTrigger

デバイスの一覧に変更が発生したときにバックグラウンド タスクを実行するイベントを表します。 GetBackgroundTrigger によって返されます。

EmailStoreNotificationTrigger

電子メール ストアへの変更の通知を有効にするトリガーを表します。

GattCharacteristicNotificationTrigger

Bluetooth LE GATT 特性の受信変更通知を受信したときにバックグラウンド タスクを起動するトリガーを表します。

GattServiceProviderTrigger

バックグラウンドで永続化できる汎用属性 (GATT) サービスを構築します。

GattServiceProviderTriggerResult

このクラスには、 GattServiceProviderTrigger.CreateAsync()によって作成されたトリガーが含まれています。

GeovisitTrigger

訪問関連のバックグラウンド タスクをトリガーするイベントを表します。

LocationTrigger

バックグラウンド タスクをトリガーする場所イベントを表します。 これはジオフェンシングに使用されます。

MaintenanceTrigger

メンテナンス トリガーを表します。

MediaProcessingTrigger

メディア処理を実行するためのバックグラウンド タスクを起動するトリガーを表します。

MobileBroadbandDeviceServiceNotificationTrigger

ネットワークが SIM ツール コマンドを送信するときにアクティブになるトリガーを表します。 この通知を受け取ったアプリは、SIM ツール コマンドを処理します。

この機能は、モバイル ネットワーク オペレーターによる特権アクセス権を持つモバイル オペレーター アプリと UWP アプリでのみ使用できます。 詳細については、「 モバイル ブロードバンド」を参照してください。

MobileBroadbandPcoDataChangeTrigger

バックグラウンド タスクの実行をトリガーする携帯ネットワーク プロトコル構成オプション変更イベントを表します。

MobileBroadbandPinLockStateChangeTrigger

SIM PIN ロック状態がいつ変更されたかを示すトリガーを表します。

この機能は、モバイル ネットワーク オペレーターによる特権アクセス権を持つモバイル オペレーター アプリと UWP アプリでのみ使用できます。 詳細については、「 モバイル ブロードバンド」を参照してください。

MobileBroadbandRadioStateChangeTrigger

モバイル ブロードバンド無線の状態が変更されたタイミングを示すトリガーを表します。 たとえば、モバイル デバイスが機内モードに切り替わると、このトリガーがアクティブになります。

この機能は、モバイル ネットワーク オペレーターによる特権アクセス権を持つモバイル オペレーター アプリと UWP アプリでのみ使用できます。 詳細については、「 モバイル ブロードバンド」を参照してください。

MobileBroadbandRegistrationStateChangeTrigger

モバイル ブロードバンド登録の状態が変更されたタイミングを示すトリガーを表します。 たとえば、モバイル デバイスがローミングに切り替わると、このトリガーがアクティブになります。

この機能は、モバイル ネットワーク オペレーターによる特権アクセス権を持つモバイル オペレーター アプリと UWP アプリでのみ使用できます。 詳細については、「 モバイル ブロードバンド」を参照してください。

NetworkOperatorDataUsageTrigger

ローカル データ カウンターがモバイル ブロードバンド インターフェイスでの使用量 (送受信バイト数) が実用的なしきい値によって変更されたと推定したときにバックグラウンド タスクを起動するトリガーを表します。

注意

この機能は、モバイル ネットワーク オペレーターによる特権アクセス権を持つモバイル オペレーター アプリと UWP アプリでのみ使用できます。

この API を使用してアプリを Microsoft Store に発行する場合は、特別な承認が必要です。 詳細については、「アプリ機能宣言」トピックの「制限付き機能」セクションと「モバイル ブロードバンド」を参照してください。

NetworkOperatorHotspotAuthenticationTrigger

モバイル ネットワーク オペレーターのホットスポット認証トリガーを表します。

注意

アプリは、このオブジェクトをインスタンス化し、ホットスポット認証を処理するためにこのアプリを参照する WLAN プロファイルがプロビジョニングされた後にのみホットスポット認証イベントに登録できます。 詳細については、「 Windows 8 Integration for Wireless Hotspot Operators」を参照してください。

NetworkOperatorNotificationTrigger

モバイル ネットワーク オペレーター通知トリガーを表します。

PaymentAppCanMakePaymentTrigger

このクラスは、PaymentAppCanMakePayment トリガーを表します。

PhoneTrigger

バックグラウンド タスクをトリガーする電話イベントを表します。

PushNotificationTrigger

生の通知の受信に応答して、アプリでバックグラウンド作業項目を呼び出すオブジェクトを表します。

RcsEndUserMessageAvailableTrigger

新しいリッチ コミュニケーション サービス (RCS) メッセージが使用可能になったときにバックグラウンド タスクを起動するトリガーを表します。

RfcommConnectionTrigger

RFCOMM 受信または送信接続が確立されたときにバックグラウンド タスクを起動するトリガーを表します。

SecondaryAuthenticationFactorAuthenticationTrigger

コンパニオン デバイスに代わってバックグラウンド タスクを起動するトリガーを表します。

SensorDataThresholdTrigger

センサーのしきい値制限を超えたときに応答するトリガーを表します。

SmartCardTrigger

スマート カードによってトリガーされるイベントを表します。

SmsMessageReceivedTrigger

SMS メッセージが到着したときに発生するトリガーを表します。

SocketActivityTrigger

ソケット アクティビティを処理するためのバックグラウンド タスクを起動するトリガーを表します。

StorageLibraryChangeTrackerTrigger

バックグラウンド タスクの実行をトリガーする StorageFolder 内のファイル変更を表します。

StorageLibraryContentChangedTrigger

指定したライブラリでファイルが変更されたときに起動するトリガーを作成します。

SystemCondition

バックグラウンド タスクを実行するために有効にする必要があるシステム条件を表します。

SystemTrigger

バックグラウンド タスクの実行をトリガーするシステム イベントを表します。

TetheringEntitlementCheckTrigger

バックグラウンド タスクの実行をトリガーするテザリング イベントを表します。

TimeTrigger

バックグラウンド タスクの実行をトリガーする時間イベントを表します。

ToastNotificationActionTrigger

ユーザーが対話型トースト通知に対してアクションを実行したときにバックグラウンド タスクを実行するイベントを表します。

ToastNotificationHistoryChangedTrigger

アプリのトースト通知の履歴がクリアされたとき、1 つ以上のトースト通知がアプリの通知履歴に追加または削除されたとき、またはアプリの 1 つ以上のトースト通知の有効期限が切れ、通知履歴から削除されたときにバックグラウンド タスクを実行するイベントを表します。

UserNotificationChangedTrigger

UserNotification が追加または削除されたときに発生するトリガーを表します。

WiFiOnDemandHotspotConnectTrigger

ユーザーが特定のオンデマンド ホットスポット ネットワークに接続する場合にバックグラウンド タスクを実行するイベントを表します。

バックグラウンド タスク コードでは、 IBackgroundTaskInstance.TriggerDetails プロパティの値を WiFiOnDemandHotspotConnectTriggerDetails にキャストする必要があります。

注意

UWP アプリでこの API を使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの Wi-Fi ホットスポット シナリオを構築するアプリ開発者のみが利用できるようになります。

WiFiOnDemandHotspotUpdateMetadataTrigger

新しい Wi-Fi ネットワークに接続するかのように、ユーザーがオペレーティング システム (OS) Wi-Fi ネットワーク リストを開いたときにバックグラウンド タスクが実行されるイベントを表します。

注意

UWP アプリでこの API を使用し、アプリを Microsoft Store に発行する場合は、カスタム機能 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (オンデマンド ネットワーク機能) を使用するための特別な承認を要求する必要があります。 詳細については、「 カスタム機能」を参照してください。

オンデマンド ネットワーク機能は、テザリング対応ハードウェア デバイスと Windows PC の間でエンド ツー エンドの Wi-Fi ホットスポット シナリオを構築するアプリ開発者のみが利用できるようになります。

インターフェイス

IBackgroundCondition

システム条件オブジェクトの種類を適用するために使用されます。

IBackgroundTask

バックグラウンド タスクの作業を実行するメソッドを提供します。

IBackgroundTaskInstance

バックグラウンド タスク インスタンスへのアクセスを提供します。

IBackgroundTaskInstance2

バックグラウンド タスク インスタンスへのアクセスを提供します。 IBackgroundTaskInstance インターフェイスから継承し、GetThrottleCount メソッドを追加します。

IBackgroundTaskInstance4

ユーザーに関する情報を含むバックグラウンド タスク インスタンスへのアクセスを提供します。

IBackgroundTaskRegistration

登録済みのバックグラウンド タスクへのアクセスを提供します。

IBackgroundTaskRegistration2

登録済みのバックグラウンド タスクへのアクセスを提供します。 IBackgroundTaskRegistration インターフェイスから継承し、Trigger プロパティを追加します。

IBackgroundTaskRegistration3

関連するバックグラウンド タスクのグループの一部として登録されているバックグラウンド タスクを表します。

IBackgroundTrigger

トリガー イベントの基本インターフェイスを表します。

列挙型

AlarmAccessStatus

ユーザーがアプリにアラームを設定するためのアクセス許可を与えられたかどうかを示します。

ApplicationTriggerResult

バックグラウンド タスクをトリガーする要求の結果。 RequestAsync メソッドは、この列挙型の値を返します。

BackgroundAccessRequestKind

アプリが要求できるバックグラウンド アクティビティのレベルを指定します。

BackgroundAccessStatus

この列挙体は、バックグラウンド アクティビティを実行するアプリの機能を指定します。

アプリはバックグラウンド タスクを登録する前に BackgroundExecutionManager.RequestAccessAsync を正常に呼び出す必要があります。

BackgroundTaskCancellationReason

バックグラウンド タスクを取り消す理由を指定します。

BackgroundTaskThrottleCounter

GetThrottleCount 要求でチェックするスロットル数の種類を示します。

BackgroundWorkCostValue

バックグラウンド作業の現在のコストを示します。 実行できる作業量に関するバックグラウンド タスクのヒントとして使用されます。

CustomSystemEventTriggerRecurrence

CustomSystemEventTrigger をアクティブ化できるタイミングを指定します。

DeviceTriggerResult

デバイスのバックグラウンド タスク操作が許可または拒否されたかどうかを示し、拒否された場合は理由を指定します。

EnergyUseLevel

アプリが中断された場合でも、アプリでバックグラウンド タスクをスケジュールしてアプリ コードを実行できるようにします。

バックグラウンド タスクは、ユーザーの操作を必要としない小さな作業項目、またはトースト アクションの処理を目的としています。 バックグラウンド タスクに適したシナリオとしては、メールのダウンロード、受信チャット メッセージのトースト通知の表示、システム条件の変更への対応などがあります。

バックグラウンド タスクの実装に関するガイダンスについては、「 バックグラウンド タスクでアプリをサポートする (JavaScript と HTML を使用する)」 または「 バックグラウンド タスクでアプリをサポート する」を参照してください。 バックグラウンド タスクを実装する方法を示すコード例については、「 バックグラウンド タスクのサンプル」を参照してください。

LocationTriggerType

場所のバックグラウンド タスク トリガーの場所イベントの種類を示します。

MediaProcessingTriggerResult

MediaProcessingTrigger.RequestAsync を呼び出した結果を指定します。

SystemConditionType

バックグラウンド タスクを実行するために有効にする必要があるシステム条件を指定します。 システム条件を持つバックグラウンド タスクがトリガーされた場合、条件が満たされるまでタスクは実行されません。

SystemTriggerType

バックグラウンド タスクのトリガーに使用できるシステム イベントを指定します。

代理人

BackgroundTaskCanceledEventHandler

バックグラウンド タスクの取り消しを処理するメソッドを表します。

BackgroundTaskCompletedEventHandler

バックグラウンド タスクの完了イベントを処理するメソッドを表します。

BackgroundTaskProgressEventHandler

バックグラウンド タスクの進行状況更新イベントを処理するメソッドを表します。

こちらもご覧ください