Windows.ApplicationModel.Background 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリが中断された場合でも、アプリでバックグラウンド タスクをスケジュールしてアプリ コードを実行できるようにします。
バックグラウンド タスクは、ユーザーの操作を必要としない小さな作業項目、またはトースト アクションの処理を目的としています。 バックグラウンド タスクに適したシナリオとしては、メールのダウンロード、受信チャット メッセージのトースト通知の表示、システム条件の変更への対応などがあります。
バックグラウンド タスクの実装に関するガイダンスについては、「 バックグラウンド タスクでアプリをサポートする (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 |
この列挙体は、バックグラウンド アクティビティを実行するアプリの機能を指定します。
|
| BackgroundTaskCancellationReason |
バックグラウンド タスクを取り消す理由を指定します。 |
| BackgroundTaskThrottleCounter |
GetThrottleCount 要求でチェックするスロットル数の種類を示します。 |
| BackgroundWorkCostValue |
バックグラウンド作業の現在のコストを示します。 実行できる作業量に関するバックグラウンド タスクのヒントとして使用されます。 |
| CustomSystemEventTriggerRecurrence |
CustomSystemEventTrigger をアクティブ化できるタイミングを指定します。 |
| DeviceTriggerResult |
デバイスのバックグラウンド タスク操作が許可または拒否されたかどうかを示し、拒否された場合は理由を指定します。 |
| EnergyUseLevel |
アプリが中断された場合でも、アプリでバックグラウンド タスクをスケジュールしてアプリ コードを実行できるようにします。 バックグラウンド タスクは、ユーザーの操作を必要としない小さな作業項目、またはトースト アクションの処理を目的としています。 バックグラウンド タスクに適したシナリオとしては、メールのダウンロード、受信チャット メッセージのトースト通知の表示、システム条件の変更への対応などがあります。 バックグラウンド タスクの実装に関するガイダンスについては、「 バックグラウンド タスクでアプリをサポートする (JavaScript と HTML を使用する)」 または「 バックグラウンド タスクでアプリをサポート する」を参照してください。 バックグラウンド タスクを実装する方法を示すコード例については、「 バックグラウンド タスクのサンプル」を参照してください。 |
| LocationTriggerType |
場所のバックグラウンド タスク トリガーの場所イベントの種類を示します。 |
| MediaProcessingTriggerResult |
MediaProcessingTrigger.RequestAsync を呼び出した結果を指定します。 |
| SystemConditionType |
バックグラウンド タスクを実行するために有効にする必要があるシステム条件を指定します。 システム条件を持つバックグラウンド タスクがトリガーされた場合、条件が満たされるまでタスクは実行されません。 |
| SystemTriggerType |
バックグラウンド タスクのトリガーに使用できるシステム イベントを指定します。 |
代理人
| BackgroundTaskCanceledEventHandler |
バックグラウンド タスクの取り消しを処理するメソッドを表します。 |
| BackgroundTaskCompletedEventHandler |
バックグラウンド タスクの完了イベントを処理するメソッドを表します。 |
| BackgroundTaskProgressEventHandler |
バックグラウンド タスクの進行状況更新イベントを処理するメソッドを表します。 |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示