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)

When development mode is OFF its considered to be in release mode. And unity uses the keystore you set in the player settings.

Command for getting SHA fingerprint

keytool -list -v -keystore "PATH_TO_KEYSTORE" -alias ALIAS_NAME -storepass STORE_PASSWORD -keypass KEY_PASSWORD

PATH_TO_KEYSTORE : This is the path of the keystore you created for your app.

Use your release keystore along with providing. ALIAS_NAME, STORE_PASS and KEY_PASS

Google Play Store (Alpha/Beta/Production)

Once you upload your apk to play console, you are given an option to let google sign your apk. This is usually called google play signing and its recommended to enable it. Once your app is ready for testing through testing tracks(Alpha/Beta) or production, you need to add the SHA fingerprint once your app signs with google play signing. You can fetch this fingerprint by following below steps

1. Navigate to Google Play Console and select your app
2. Select Setup and click on App Signing. Under App signing key certificate copy the value of SHA-1 certificate fingerprint

3. Use this fingerprint value in the credentials section to create a new oauth client id.

Google play app signing SHA fingerprint

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.