public interface

Snapshot

implements Parcelable Freezable<T>
com.google.android.gms.games.snapshot.Snapshot
Known Indirect Subclasses

Class Overview

Data interface for a representation of a saved game. This includes both the metadata and the actual game content.

Summary

[Expand]
Inherited Constants
From interface android.os.Parcelable
Public Methods
abstract Contents getContents()
This method is deprecated. use getSnapshotContents() instead.
abstract SnapshotMetadata getMetadata()
Retrieves the metadata for this snapshot.
abstract SnapshotContents getSnapshotContents()
Retrieve the SnapshotContents associated with this snapshot.
abstract boolean modifyBytes(int dstOffset, byte[] content, int srcOffset, int count)
This method is deprecated. See modifyBytes(int, byte[], int, int).
abstract byte[] readFully()
This method is deprecated. See readFully().
abstract boolean writeBytes(byte[] content)
This method is deprecated. See writeBytes(byte[]).
[Expand]
Inherited Methods
From interface android.os.Parcelable
From interface com.google.android.gms.common.data.Freezable

Public Methods

public abstract Contents getContents ()

This method is deprecated.
use getSnapshotContents() instead.

public abstract SnapshotMetadata getMetadata ()

Retrieves the metadata for this snapshot.

Returns

public abstract SnapshotContents getSnapshotContents ()

Retrieve the SnapshotContents associated with this snapshot. This object can be used to update the data of a snapshot. Note that this will return null if this snapshot was not obtained via open(GoogleApiClient, SnapshotMetadata).

Returns

public abstract boolean modifyBytes (int dstOffset, byte[] content, int srcOffset, int count)

This method is deprecated.
See modifyBytes(int, byte[], int, int).

Write the specified data into the snapshot. The contents of the snapshot will be replaced with the data provided in content. The data will be persisted on disk, but is not uploaded to the server until the snapshot is committed via commitAndClose(GoogleApiClient, Snapshot, SnapshotMetadataChange).

Note that this form of the API does not necessarily overwrite the entire contents of the file. If you are writing less data than was previously stored in the snapshot, the excess data will remain. Use writeBytes(byte[]) to fully overwrite the file.

If the snapshot was not opened via open(GoogleApiClient, SnapshotMetadata), or if the contents have already been committed via commitAndClose(GoogleApiClient, Snapshot, SnapshotMetadataChange), this method will throw an exception.

Parameters
dstOffset Position in the snapshot file to start writing data to. 0 indicates the head of the file.
content The data to write.
srcOffset Position in content to start writing from.
count Number of bytes from content to write to this snapshot.
Returns
  • Whether or not the data was successfully written to disk.

public abstract byte[] readFully ()

This method is deprecated.
See readFully().

Read the contents of a snapshot.

If this snapshot was not opened via open(GoogleApiClient, SnapshotMetadata), or if the contents have already been committed via commitAndClose(GoogleApiClient, Snapshot, SnapshotMetadataChange) this method will throw an exception.

Returns
  • The bytes of the snapshot contents.

public abstract boolean writeBytes (byte[] content)

This method is deprecated.
See writeBytes(byte[]).

Write the specified data into the snapshot. The contents of the snapshot will be replaced with the data provided in content. The data will be persisted on disk, but is not uploaded to the server until the snapshot is committed via commitAndClose(GoogleApiClient, Snapshot, SnapshotMetadataChange).

Note that this form of the API will fully overwrite the contents of the file. No previous data will be retained. Use modifyBytes(int, byte[], int, int) to overwrite parts of the file.

If the snapshot was not opened via open(GoogleApiClient, SnapshotMetadata), or if the contents have already been committed via commitAndClose(GoogleApiClient, Snapshot, SnapshotMetadataChange), this method will throw an exception.

Parameters
content The data to write.
Returns
  • Whether or not the data was successfully written to disk.