Skip to content
Francisco Dias edited this page Aug 5, 2026 · 7 revisions

GooglePlayServices

Extension's Features

  • Sign in with Google Play Games Services and check/request authentication state
  • Read the current player's profile, stats, and friends list (with consent handling)
  • Show the Player Search and Player Profile Compare system UIs
  • Unlock/reveal/increment achievements and show the Achievements system UI
  • Submit and load leaderboard scores, and show the Leaderboards system UI
  • Save and load player progress with the Saved Games service, including conflict resolution
  • Convert a Play Games image URI into a local file path for use with sprite_add

Introduction

This extension wraps Google Play Games Services v2 for Android. Every play_services_* function returns a PlayServicesError synchronously - Ok means the call was accepted and, if it takes a callback, that callback will fire once with the real result; any other value means the call was rejected before ever reaching Google Play (not authenticated, no activity, or an invalid argument) and the callback is never touched.

Every callback fires exactly once, callback.call(status, data...): status is always a PlayServicesResult carrying just success/error, and the real payload rides as further, separate positional arguments - never bundled into a single per-function result struct. Check status.success before reading anything else.

Most functions require the player to be signed in first - call play_services_sign_in (or rely on the automatic sign-in attempt made at game start) before calling anything else. A handful of functions launch a native system UI (achievements, leaderboards, saved games picker, player search, player profile compare) instead of returning data directly.

Guides

Guides for the GooglePlayServices extension.

Modules

The following are the available modules for the GooglePlayServices extension:



Clone this wiki locally