public final class

MilestoneEntity

extends Object
implements Parcelable Milestone
java.lang.Object
   ↳ com.google.android.gms.games.quest.MilestoneEntity

Class Overview

Data object representing the data for a milestone. This is immutable, and therefore safe to cache or store. Note, however, that the data it represents may grow stale.

This class exists solely to support parceling these objects and should not be used directly.

Summary

[Expand]
Inherited Constants
From interface android.os.Parcelable
From interface com.google.android.gms.games.quest.Milestone
Fields
public static final Creator<MilestoneEntity> CREATOR
Public Methods
boolean equals(Object obj)
Milestone freeze()
Freeze a volatile representation into an immutable representation.
byte[] getCompletionRewardData()
Retrieves the completion reward data for this milestone.
long getCurrentProgress()
Retrieves the current progress of getTargetProgress() required to complete the milestone.
String getEventId()
Retrieve the ID of the associated event.
String getMilestoneId()
Retrieves the ID of this milestone.
int getState()
Retrieves the state of the milestone - one of STATE_COMPLETED_NOT_CLAIMED, STATE_CLAIMED, STATE_NOT_COMPLETED, or STATE_NOT_STARTED.
long getTargetProgress()
Retrieves the number of increments of the event associated with the milestone getEventId() required to complete the milestone.
int hashCode()
boolean isDataValid()
Check to see if this object is valid for use.
String toString()
void writeToParcel(Parcel out, int flags)
[Expand]
Inherited Methods
From class java.lang.Object
From interface android.os.Parcelable
From interface com.google.android.gms.games.quest.Milestone
From interface com.google.android.gms.common.data.Freezable

Fields

public static final Creator<MilestoneEntity> CREATOR

Public Methods

public boolean equals (Object obj)

Parameters
obj Object
Returns
boolean

public Milestone freeze ()

Freeze a volatile representation into an immutable representation. Objects returned from this call are safe to cache.

Note that the output of freeze may not be identical to the parent object, but should be equal. In other words:

 
 Freezable f1 = new Freezable();
 Freezable f2 = f1.freeze();
 f1 == f2 may not be true.
 f1.equals(f2) will be true.
 
 

Returns
Milestone A concrete implementation of the data object.

public byte[] getCompletionRewardData ()

Retrieves the completion reward data for this milestone.

Returns
byte[] The completion reward data.

public long getCurrentProgress ()

Retrieves the current progress of getTargetProgress() required to complete the milestone.

 When the milestone state is STATE_CLAIMED or STATE_COMPLETED_NOT_CLAIMED
 the value of getTargetProgress() is returned.
 
 When the milestone state is STATE_NOT_COMPLETED the return value is the number of
 increments to the event getEventId() associated with the milestone that have
 occurred since the quest was accepted.
 
 When the milestone state is STATE_NOT_STARTED the return value is 0.

Returns
long An indicator of progress through the milestone.

public String getEventId ()

Retrieve the ID of the associated event. Increments to this event will increase the user's progress toward this milestone when the milestone is in the STATE_NOT_COMPLETED state.

Returns
String The ID of the Event associated with this milestone.

public String getMilestoneId ()

Retrieves the ID of this milestone.

Returns
String The milestone ID.

public int getState ()

Retrieves the state of the milestone - one of STATE_COMPLETED_NOT_CLAIMED, STATE_CLAIMED, STATE_NOT_COMPLETED, or STATE_NOT_STARTED.

Returns
int The state of this milestone.

public long getTargetProgress ()

Retrieves the number of increments of the event associated with the milestone getEventId() required to complete the milestone.

Returns
long The number of increments required to complete the milestone.

public int hashCode ()

Returns
int

public boolean isDataValid ()

Check to see if this object is valid for use. If the object is still volatile, this method will indicate whether or not the object can be safely used. The output of a call to freeze() will always be valid.

Returns
boolean whether or not the object is valid for use.

public String toString ()

Returns
String

public void writeToParcel (Parcel out, int flags)

Parameters
out Parcel
flags int