Instance Property
インスタンスプロパティ
shouldDefer
A Boolean value indicating whether your app should stop performing background activity and resume at a more optimal time.
あなたのアプリがバックグラウンド活動の実行を停止して最適な時に再開すべきかどうかを指し示しているブール値。
Declaration
宣言
var shouldDefer: Bool
{ get }
Discussion
議論
Your app can check the shouldDefer
property while executing scheduled background activity. If this property contains a value of true
, system conditions have changed since the time the activity started and deferral is recommended. For example, perhaps the user unplugged the Mac and it’s now running on battery power. In this case, your app should finish what it’s currently doing, save its state, and invoke its completion handler with a value of NSBackgroundActivityScheduler.Result.deferred
. The system will invoke your activity again at a more optimal time, and your app can restore its previous state and resume where it left off. See Detect Whether to Defer Activity and Configure Scheduler Properties.
あなたのアプリは、shouldDefer
プロパティを調べることが、予定に組まれたバックグラウンド活動を実行している間に行えます。このプロパティがtrue
の値を含むならば、その活動が開始した時からシステム条件が変わってしまっていて、延期が推奨されます。例えば、ことによるとユーザがMacのコードを抜いた、それでそれは今ではバッテリー電源で動作しているかもしれません。この場合、あなたのアプリはそれが現在行っている何かを終了して、それの状態を保存して、そしてそれの完了ハンドラをNSBackgroundActivityScheduler.Result.deferred
の値で呼び出すべきです。システムは、あなたの活動を再び最良の機会で発動するでしょう、そしてあなたのアプリは、それの以前の状態を復元してそれがそのままにしたところで再開します。活動を延期するかどうかを突き止めるとスケジューラプロパティを構成設定するを見てください。
See Also
参照
Background Scheduler Attributes
バックグラウンドスケジューラ属性
var identifier: String
A unique reverse DNS notation string, such as com.example.MyApp.updatecheck
, that identifies the activity.
特有な逆DNS表記法文字列、例えばcom.example.MyApp.updatecheck
など、それはその活動を識別するものです。
var repeats: Bool
A Boolean value indicating whether the activity should be rescheduled after it completes.
それが完了した後に活動が再度予定に組まれるべきかどうかを指し示すブール値。
var interval: TimeInterval
An integer providing a suggested interval between scheduling and invoking the activity.
予定に組むこととその活動の発動の間の提案される間隔を提供している整数。
var qualityOfService: QualityOfService
A value of type NSQualityOfService
, which controls how aggressively the system schedules the activity.
型NSQualityOfService
の値、それはどのくらい積極的にシステムがその活動を予定に組むかを制御します。
Related Documentation
関連文書
enum NSBackgroundActivityScheduler.Result
These constants indicate whether background activity has been completed successfully or whether additional processing should be deferred until a more optimal time.
これらの定数は、バックグラウンド活動がうまく完了されたかどうかまたは追加的処理が最適な時間まで延期されるべきかどうかを指し示します。