Play Games Services

Native API for Play Games Services.

Summary

Typedefs
`PgsAchievementsClient`	typedef `struct PgsAchievementsClient` An opaque handle to the Achievements Client.
`PgsGamesSignInClient`	typedef `struct PgsGamesSignInClient` An opaque handle to the GamesSignIn Client.
`PgsRecallClient`	typedef `struct PgsRecallClient` An opaque handle to the Recall Client.

Functions
`PgsAchievementsClient_create(jobject activity)`	`PgsAchievementsClient *` Creates a new Achievements Client instance.
`PgsAchievementsClient_destroy(PgsAchievementsClient *achievements_client)`	`void` Destroys an Achievements Client instance.
`PgsGamesSignInClient_create(jobject activity)`	`PgsGamesSignInClient *` Creates a new GamesSignIn Client instance.
`PgsGamesSignInClient_destroy(PgsGamesSignInClient *games_sign_in_client)`	`void` Destroys a GamesSignIn Client instance.
`PgsRecallClient_create(jobject activity)`	`PgsRecallClient *` Creates a new Recall Client instance.
`PgsRecallClient_destroy(PgsRecallClient *recall_client)`	`void` Destroys a Recall Client instance.
`Pgs_destroy()`	`void` Shuts down the Play Games Services native SDK.
`Pgs_initialize(JavaVM *vm, jobject context)`	`jint` Initializes the Play Games Services native SDK.

Typedefs

PgsAchievementsClient

struct PgsAchievementsClient PgsAchievementsClient

An opaque handle to the Achievements Client.

PgsGamesSignInClient

struct PgsGamesSignInClient PgsGamesSignInClient

An opaque handle to the GamesSignIn Client.

PgsRecallClient

struct PgsRecallClient PgsRecallClient

An opaque handle to the Recall Client.

Functions

PgsAchievementsClient_create

PgsAchievementsClient * PgsAchievementsClient_create(
  jobject activity
)

Creates a new Achievements Client instance.

This function creates a client handle for interacting with the achievements API.

Details

Parameters

activity

A JNI reference to a valid Android Activity.

Returns

A new PgsAchievementsClient handle, or NULL on failure. This handle must be released with PgsAchievementsClient_destroy().

PgsAchievementsClient_destroy

void PgsAchievementsClient_destroy(
  PgsAchievementsClient *achievements_client
)

Destroys an Achievements Client instance.

This function releases all resources associated with the client handle. The handle becomes invalid after this call.

Details

Parameters

achievements_client

The client handle to destroy.

PgsGamesSignInClient_create

PgsGamesSignInClient * PgsGamesSignInClient_create(
  jobject activity
)

Creates a new GamesSignIn Client instance.

This function creates a client handle for interacting with the GamesSignIn API.

Details

Parameters

activity

A JNI reference to a valid Android Activity.

Returns

A new PgsGamesSignInClient handle, or NULL on failure. This handle must be released with PgsGamesSignInClient_destroy().

PgsGamesSignInClient_destroy

void PgsGamesSignInClient_destroy(
  PgsGamesSignInClient *games_sign_in_client
)

Destroys a GamesSignIn Client instance.

This function releases all resources associated with the client handle. The handle becomes invalid after this call.

Details

Parameters

games_sign_in_client

The client handle to destroy.

PgsRecallClient_create

PgsRecallClient * PgsRecallClient_create(
  jobject activity
)

Creates a new Recall Client instance.

Details

Parameters

activity

A JNI reference to a valid Android Activity.

Returns

A new PgsRecallClient handle, or NULL on failure. This handle must be released with PgsRecallClient_destroy().

PgsRecallClient_destroy

void PgsRecallClient_destroy(
  PgsRecallClient *recall_client
)

Destroys a Recall Client instance.

Details

Parameters

recall_client

The client handle to destroy.

Pgs_destroy

void Pgs_destroy()

Shuts down the Play Games Services native SDK.

This should be called once when the application is closing to clean up all global references.

Pgs_initialize

jint Pgs_initialize(
  JavaVM *vm,
  jobject context
)

Initializes the Play Games Services native SDK.

This must be called once at application startup before any other SDK functions.

Details

Parameters

`vm`	The JavaVM pointer obtained.
`context`	An Android Activity object.

Returns

JNI_OK on success, or JNI_ERR on failure.