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 MilestoneEntityCreator CREATOR
Public Methods
int describeContents()
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.common.data.Freezable
From interface com.google.android.gms.games.quest.Milestone

Fields

public static final MilestoneEntityCreator CREATOR

Public Methods

public int describeContents ()

public boolean equals (Object obj)

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
  • A concrete implementation of the data object.

public byte[] getCompletionRewardData ()

Retrieves the completion reward data for this milestone.

Returns
  • 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
  • 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
  • The ID of the Event associated with this milestone.

public String getMilestoneId ()

Retrieves the ID of this milestone.

Returns
  • 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
  • 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
  • The number of increments required to complete the milestone.

public int hashCode ()

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
  • whether or not the object is valid for use.

public String toString ()

public void writeToParcel (Parcel out, int flags)