Language

StandbyBucket Enum

Definition

Identifies the app standby category used to limit background work according to app usage.

public enum StandbyBucket
type StandbyBucket = 
Inheritance
StandbyBucket

Fields

Name Value Description
Active 10

The app was used very recently, currently in use or likely to be used very soon. Standby bucket values that are ≤ STANDBY_BUCKET_ACTIVE will not be throttled by the system while they are in this bucket. Buckets > STANDBY_BUCKET_ACTIVE will most likely be restricted in some way. For instance, jobs and alarms may be deferred.

Android reference for android.app.usage.UsageStatsManager.STANDBY_BUCKET_ACTIVE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

WorkingSet 20

The app was used recently and/or likely to be used in the next few hours. Restrictions will apply to these apps, such as deferral of jobs and alarms.

Android reference for android.app.usage.UsageStatsManager.STANDBY_BUCKET_WORKING_SET.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Frequent 30

The app was used in the last few days and/or likely to be used in the next few days. Restrictions will apply to these apps, such as deferral of jobs and alarms. The delays may be greater than for apps in higher buckets (lower bucket value). Bucket values > STANDBY_BUCKET_FREQUENT may additionally have network access limited.

Android reference for android.app.usage.UsageStatsManager.STANDBY_BUCKET_FREQUENT.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Rare 40

The app has not be used for several days and/or is unlikely to be used for several days. Apps in this bucket will have more restrictions, including network restrictions, except during certain short periods (at a minimum, once a day) when they are allowed to execute jobs, access the network, etc.

Android reference for android.app.usage.UsageStatsManager.STANDBY_BUCKET_RARE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Restricted 45

The app is in the most restricted standby category, with limits on network access and jobs. This category is not enabled on Android 11.

Remarks

Higher bucket values impose greater restrictions on background jobs and alarms. Categories above Frequent can also restrict background network access. The system can change an app's bucket as its usage changes.

Applies to