public abstract class

Task

extends Object
implements Parcelable
java.lang.Object
   ↳ com.google.android.gms.gcm.Task
Known Direct Subclasses

Class Overview

Encapsulates the parameters of a task that you will schedule on the GcmNetworkManager.

Construct instances of either PeriodicTask or OneoffTask with the desired parameters/behaviour and schedule them using schedule(Task).

Summary

Nested Classes
class Task.Builder Builder object to construct these tasks before sending them to the network manager. 
Constants
int EXTRAS_LIMIT_BYTES The maximum size allowed for extras bundle in bytes.
int NETWORK_STATE_ANY Specify using setRequiredNetwork(int) that your task will execute regardless of whether a network is available.
int NETWORK_STATE_CONNECTED Specify using setRequiredNetwork(int) that your task will only execute if some sort of data connection is available - either metered or unmetered.
int NETWORK_STATE_UNMETERED Specify using setRequiredNetwork(int) that your task will only execute if there is an unmetered network connection available.
long UNINITIALIZED
[Expand]
Inherited Constants
From interface android.os.Parcelable
Public Methods
int describeContents()
Bundle getExtras()
int getRequiredNetwork()
If the specified network is unavailable, your task will not be run until it is.
boolean getRequiresCharging()
If the device is not charging and this is set to true, your task will not be run until it is.
String getServiceName()
String getTag()
boolean isPersisted()
boolean isUpdateCurrent()
void writeToParcel(Parcel parcel, int i)
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable

Constants

public static final int EXTRAS_LIMIT_BYTES

The maximum size allowed for extras bundle in bytes.

Constant Value: 10240 (0x00002800)

public static final int NETWORK_STATE_ANY

Specify using setRequiredNetwork(int) that your task will execute regardless of whether a network is available.

Constant Value: 2 (0x00000002)

public static final int NETWORK_STATE_CONNECTED

Specify using setRequiredNetwork(int) that your task will only execute if some sort of data connection is available - either metered or unmetered. This is the default.

Constant Value: 0 (0x00000000)

public static final int NETWORK_STATE_UNMETERED

Specify using setRequiredNetwork(int) that your task will only execute if there is an unmetered network connection available.

Constant Value: 1 (0x00000001)

protected static final long UNINITIALIZED

Constant Value: -1 (0xffffffffffffffff)

Public Methods

public int describeContents ()

Returns
int

public Bundle getExtras ()

Returns
Bundle The extra parameters for the task set by the client.

public int getRequiredNetwork ()

If the specified network is unavailable, your task will not be run until it is.

Returns
int The network type that this task requires in order to run. See the NETWORK_TYPE_* flavours for an explanation of what this value can be.

public boolean getRequiresCharging ()

If the device is not charging and this is set to true, your task will not be run until it is.

Returns
boolean Whether or not this task depends on the device being connected to power in order to execute.

public String getServiceName ()

Returns
String The GcmTaskService component that this task will execute on.

public String getTag ()

Returns
String The String identifier for this task, that is returned to onRunTask(com.google.android.gms.gcm.TaskParams) when this task executes.

public boolean isPersisted ()

Returns
boolean Whether this task will be persisted across devices restarts or Google Play Services crashes.

public boolean isUpdateCurrent ()

Returns
boolean Whether or not this task will update a pre-existing task in the scheduler queue.

public void writeToParcel (Parcel parcel, int i)

Parameters
parcel Parcel
i int