Saved Games API Reference
This section documents all Google Play Games Services Saved Games Blueprint nodes provided by the plugin. These nodes allow you to display the native Saved Games UI, save and load game data, manage conflicts, and retrieve saved game metadata using Google Play cloud storage.
Before using any Saved Games API functions, the player must be successfully signed in to Google Play Games Services. In addition, Saved Games must be enabled in the Google Play Games Services project configuration. If these requirements are not met, Saved Games operations will fail.
Saved Games UI
| Node | Parameters | Callbacks / Return | Description |
|---|---|---|---|
| Show Saved Games UI | Title (string), MaxSavedGames (int32), bAllowAdd (bool), bAllowDelete (bool) |
On Opened: Called when the Saved Games UI is opened. On Save Selected (SlotName): Called when an existing save slot is selected. On Save Added: Called when a new save slot is created by the user. On Canceled: Called when the UI is closed without selection. On Failure (Error, Error Message): Called if the UI fails to open. |
Displays the native Google Play Games UI for managing cloud saved games. |
Save Game
| Node | Parameters | Callbacks / Return | Description |
|---|---|---|---|
| Save Game | SlotName (string), SaveGameObject (USaveGame), Description (string), PlayedTimeMillis (int64), ProgressValue (int64), ConflictPolicy (EGooglePlaySavedGameConflictPolicy) |
On Success (Metadata): Returns FGooglePlaySavedGameMetadata.On Failure (Error, Error Message): Called if saving fails. On Conflict (Conflict): Returns FGooglePlaySavedGameConflict when a conflict occurs. |
Saves game data to Google Play Games cloud storage using the specified slot name. |
Load Game
| Node | Parameters | Callbacks / Return | Description |
|---|---|---|---|
| Load Game | SlotName (string), ConflictPolicy (EGooglePlaySavedGameConflictPolicy) |
On Success (SaveGameObject): Returns a loaded USaveGame object.On Failure (Error, Error Message): Called if loading fails. On Conflict (Conflict): Returns FGooglePlaySavedGameConflict when a conflict occurs. |
Loads saved game data from Google Play Games cloud storage. |
Delete Saved Game
| Node | Parameters | Callbacks / Return | Description |
|---|---|---|---|
| Delete Saved Game | SlotName (string) |
On Success: Called when the saved game is successfully deleted. On Failure (Error, Error Message): Called if deletion fails. |
Deletes the specified saved game from Google Play Games cloud storage. |
Resolve Saved Game Conflict
| Node | Parameters | Callbacks / Return | Description |
|---|---|---|---|
| Resolve Saved Game Conflict | SlotName (string), ConflictID (string), ResolveStrategy (EGooglePlaySavedGameResolveStrategy), CustomSaveGame (USaveGame), Description (string), PlayedTimeMillis (int64), ProgressValue (int64) |
On Success (SaveGameObject): Returns a resolved USaveGame object.On Failure (Error, Error Message): Called if conflict resolution fails. |
Resolves a saved game conflict between local and remote versions using the specified strategy. |
Saved Games Metadata
| Node | Parameters | Callbacks / Return | Description |
|---|---|---|---|
| Get All Saved Games | – | On Success (SavedGames): Returns an array of FGooglePlaySavedGameMetadata.On Failure (Error, Error Message): Called if loading metadata fails. |
Loads metadata for all saved games associated with the current player. |