Get started with Platform Toolkit for Google Play Games Services

Use the following steps to set up your Unity project for Google Play Games Services with the Platform Toolkit package.

Note

At the time of release, Platform Toolkit was tested for compatibility with Android 7.1 (API 25).

1. Install the required packages

Install the following required packages:

• com.unity.platformtoolkit
• com.unity.platformtoolkit.playgamesservices

For information on installing packages with Unity, refer to Package management with the Package Manager window.

2. Install the Android platform module

The Android platform module is required to build your project for Android devices. For information on how to install the Android platform module, refer to Add modules.

3. Connect a Google Play Games project to your Unity project

1. Make sure you have a Google Play Games project created, or create a new one following the Set up Google Play Games Services guide. When creating your project, ensure you provide the following information:
   • Package name: Ensure that the package name you enter matches the one used in your Unity Project. You can find the package name in your Unity Project settings under Android > Identification > PackageName.
   • SHA1 Number: When creating credentials, you'll be prompted to provide a SHA1 number. This number is generated using your keystore. It's important to use the same keystore that your Unity project is utilizing. Using the default debugKeystore will prevent you from building. Refer to the KeystoreManager documentation for more information.
2. In the Google Play Console, navigate to Home > Your Application > Grow Users > Play Games Services > Setup and management > Configuration.
3. Copy your project ID. The project ID is located under the application name.
4. In the Unity Editor, navigate to Edit > Project Settings > Platform Toolkit > Play Game Services.
5. Add your project ID in the Game Services Project ID field.

If your application isn't published, you must complete the following steps:

1. In the Google Play Console, navigate to Home > Your Application > Grow Users > Play Games Services > Setup and management > Testers.
2. Add the email of the user that's signed-in on your testing device.

4. Add achievements

1. Set up achievements in the Google Play Console by following the Google Play Services Achievements guide. Note that you don't need to publish your application.
2. In the Unity Editor, open the Achievement Editor window by selecting Window > Platform Toolkit > Achievement Editor.
3. In the Play Games Services column of the Achievement Editor, add achievement IDs that match the IDs in the Google Play Console achievements page.

Additional resources

• Platform-specific reference