Platform-specific information

Details for behavior and API usage unique to the Platform Toolkit package for Google Play Games Services.

Note

Refer to Get started with Platform Toolkit for Google Play Games Services for detailed setup instructions.

Account behavior

  • Depending on the Google Play Games settings on the device, an active internet connection is required the first time a user signs in.
  • A sign-out function isn't supported. Once authenticated, the user remains signed in until the application session ends.
  • A UserRefusalException is thrown if the system isn't configured correctly. Ensure that all steps in the Get started with Platform Toolkit for Google Play Games Services guide have been completed.

Save system

The maximum allowed size of a save is 3 MB. For more information, refer to the Android Developer documentation for Limits.

Note: A save might contain multiple save files.

Building for Android

When you build for Android, this package modifies the AndroidManifest.xml file to add the project ID. This modification can conflict with the Google Play Games plugin for Unity and might cause build errors.

To avoid conflicts set the project ID in one of the following places, but not both:

  • In the Platform Toolkit settings (menu: Edit > Project Settings > Platform Toolkit > Play Games Services > Games Services Project ID).
  • If using the Google Play Games plugin for Unity, set the project ID from the plug-in settings. For more information, refer to the Google Play Games plugin for Unity documentation.

The Play Games Services Project Settings window includes a checkbox that allows this package to modify the build files. This setting is enabled by default.

Achievements

The following considerations apply when adding achievements on Platform Toolkit with Play Games Services:

  • If an achievement type is single in the Platform Toolkit Achievement Editor, it must be set as standard in Google Play Console.
  • If an achievement type is progressive in the Platform Toolkit Achievement Editor, it must be set as incremental in Google Play Console.
  • For progressive achievements, the progress target must match between Platform Toolkit and Google Play Console.

Additional resources