FAQ

Common

What are settings required for making Game Services to work?

Android

• Play Services Application Id

• Add SHA Fingerprint for the APK in Google Play Console

iOS

• Make sure Game Services capability is enabled when you create your app id manually in iOS developer portal

Android

What are different SHA fingerprints that needs to be used for logging in successfully on different environments and how to create them?

Each keystore is linked to a SHA fingerprint. Please check below for creating SHA fingerprints on each environment (Debug, Release and Google play)

Debug (Development Mode)

When development mode is enabled in Build Settings on Unity, it always uses defualt debug.keystore.

Command for getting SHA fingerprint

  keytool -list -v -keystore "PATH_TO_DEBUG_KEYSTORE" -alias androiddebugkey -storepass android -keypass android

Check the below table to get PATH_TO_DEBUG_KEYSTORE (debug.keystore)

Platform	Path
Windows	C:\Users\USERNAME\.android\debug.keystore (Replace with your username in the above path)
MacOSX	~/.android/debug.keystore

SHA fingerprint to consider finishing the configuration on google play console

Release (Release Mode)

Google Play Store (Alpha/Beta/Production)

Why is sign-in failing? Or

In the logs I see "APP NOT CORRECTLY CONFIGURED TO USE GOOGLE PLAY GAME SERVICES". How to solve this?

This usually happens for one of the 3 main reasons.

1. Your package name and certificate fingerprint do not match the client ID you registered in Developer Console. This means you haven't added the required SHA fingerprint correctly. You need to copy the printed SHA1 fingerprint in the logcat log and add it in the credentials section of google play console.

2. Your Play Services Application Id was incorrectly entered in Essential Kit Settings

3. In sandbox mode, the user you are trying to login is not added as a tester in your App's google play console under Play Games Services -> Setup and Management -> Testers

Nearly 99% of the sign in errors are due to not adding the correct credential for the keystore that is used in Google Play Console-> Your App -> Play Games Services -> Setup and Management -> Configuration.

For logging in successfully, you need to create the credential by setting the right SHA fingerprint on google play console. Please check setup here.

How to get SHA fingerprint from an APK?

You can use the below command for getting the SHA fingerprint quickly

keytool -printcert -jarfile PATH_TO_APK_FILE

Why am I getting "keytool command not found"?

You need to have your JAVA_HOME environment variable set on windows or java should be in the PATH on mac.

keytool is a program from java sdk and you need to have java setup correctly to get it detected. Its used for getting SHA fingerprint from keystore or an APK.

iOS

Why the sign-in dialog doesn't come up second time post user cancelling the sign-in first time?

This is an issue at iOS level which we don't have control. It's a limitation with Game Center and it won't show up the sign-in prompt once user cancels it earlier.

To resolve, user needs to manually sign-in from the settings of his device.