Essential Kit Tutorials
DocumentationDownload
Version 2
Version 2
  • Introduction
  • Features
  • Version 2 vs Version 1
  • Release Notes
    • ✅Version 2.7.4
    • Version 2.7.3
    • Version 2.7.2
    • Version 2.7.1
    • Version 2.7.0
    • Older Versions
      • Version 2.6.1
      • Version 2.6.0
      • Version 2.5.1
      • Version 2.5.0
      • Version 2.4.1
      • Version 2.4.0
      • Version 2.3.1
      • Version 2.3.0
      • Version 2.2.1
      • Version 2.2.0
      • Version 2.1.1
      • Version 2.1.0
      • Version 2.0.4
      • Version 2.0.3
      • Version 2.0.2
      • Version 2.0.1
      • Version 2.0.0
  • Plugin Overview
    • Settings
    • Folder Structure
    • Installation FAQ
    • Localisation
  • Address Book
    • Overview
    • Use Cases
    • Setup
    • Usage
    • Testing
    • FAQ
  • Billing Services
    • Overview
    • Use Cases
    • Setup
      • iOS
      • Android
    • Usage
    • Testing
      • iOS
      • Android
    • FAQ
  • Cloud Services
    • Overview
    • Use Cases
    • Setup
      • iOS
      • Android
    • Usage
    • Testing
    • FAQ
  • Deep Link Services
    • Overview
    • Use Cases
    • Setup
      • iOS
      • Android
    • Usage
    • Testing
    • FAQ
  • Extras (Utilities)
    • Overview
    • Usage
  • Game Services
    • Overview
    • Use Cases
    • Setup
      • iOS
      • Android
    • Usage
    • FAQ
  • Media Services
    • Overview
    • Use Cases
    • Setup
    • Usage
    • FAQ
  • Native UI
    • Overview
    • Use Cases
    • Setup
    • Usage
    • FAQ
  • Network Services
    • Overview
    • Use Cases
    • Setup
    • Usage
    • FAQ
  • Notification Services
    • Overview
    • Use Cases
    • Setup
      • iOS
      • Android
    • Usage
    • FAQ
  • Rate My App
    • Overview
    • Use Cases
    • Setup
    • Usage
    • FAQ
  • Sharing
    • Overview
    • Use Cases
    • Setup
    • Usage
      • Message Composer
      • Mail Composer
      • Social Share Composer
      • Share Sheet
    • FAQ
  • Web View
    • Overview
    • Use Cases
    • Setup
    • Usage
    • FAQ
  • Notes
    • Resolving Android Gradle Build Errors
    • Google Play Services Authentication
Powered by GitBook
On this page
  • Configuring Leaderboards
  • Configuring Achievements
  • Configuring Credentials (SHA fingerprint authentication)
  • Adding a SHA fingerprint?
  • Authenticate APK's built in different environments

Was this helpful?

Edit on GitHub
  1. Game Services
  2. Setup

Android

PreviousiOSNextUsage

Last updated 4 years ago

Was this helpful?

Plugin uses Google Play Services to provide the functionalities of Game Services.

Google Play games services save you from having to implement popular game features yourself. Using the google game play services you can help players to challenge themselves and measure themselves against others, and receive rewards. Players who take advantage of Google Play games services features are more likely to engage with and make purchases from your game.

Configuring Leaderboards

For creating a new Leaderboard

  1. Navigate to and select your app

  2. Select Grow -> Play Games Services -> Setup and Management -> Leaderboards tab on the left and click on Create Leaderboard

  3. Input your leaderboard metadata. For more information, see .

    • Name

    • Format

    • Icon

    • Sort Order

    • Tamper protection (optional)

    • Limits (Optional)

    • Order

  4. Click Save

Configuring Achievements

For creating a new Achievement

  1. Select Grow -> Play Games Services -> Setup and Management -> Achievements tab on the left and click on Create Achievement

    • Name

    • Description

    • Icon

    • Initial state (Revealed/Hidden)

    • Points

    • List Order

  2. Click Save

Configuring Credentials (SHA fingerprint authentication)

For using google play services, the player needs to login. For logging in successfully, the apk from which the player is logging in needs to be authenticated by google servers.

One way google servers authenticate is by checking if the request is from an apk/aab which has a valid SHA fingerprint added in the google play console.

For your apk to login successfully, you need to add a SHA fingerprint to google play console. This makes google servers aware that your apk requests are valid.

Adding a SHA fingerprint?

  1. Select Grow -> Play Games Services -> Setup and Management -> Configuration tab on the left and click on Add Credential

  2. If you are accessing login from your Android apk, select Android else Game Server for type

  3. Under Authorization section

    1. Click on Create OAuth Client button

    2. Open Create OAuth Client Id

    3. Enter your package name

    4. Click Save

    5. Come back to Authorization section (step 4) and select the created OAuth client

  4. Click on Save

Authenticate APK's built in different environments

There are usually 3 environments when creating the apk/aab and each environment uses a different keystore leading to a unique SHA

  • Debug - Uses default android debug keystore when development build is on

  • Release - Uses release key store when release build is on

  • Play Store - Uses google play signing keystore for all the apks downloaded from play store( including tracks - Alpha/Beta)

If you want to login successfully in the apk's built in those above environments, you need to add credential in Google play console by repeating the process mentioned above(Adding a SHA fingerprint) for each SHA fingerprint.

For authenticating successfully, SHA fingerprint of the built APK needs to be added in the Google play console -> Play Games Services -> Setup and Management -> Configuration -> Credentials section.

99% of the errors related to sign in failure are because of not adding the SHA of your apk thus letting the google servers to block the login.

Once after saving the created leaderboard, you can see the leaderboard id in the leaderboards section and this will be the platform Id for Android platform on for each leaderboard you configure.

Navigate to and select your app

Input your leaderboard metadata. For more information, see .

Incremental Achievements (If enabled will be the value thats set here. Else it will be 1)

Once after saving the created leaderboard, you can see the achievement id in the achievements section and this will be the platform Id for Android platform on for Achievements for each achievement you configure.

Navigate to and select your app

Fill in the SHA fingerprint (For creating one, check )

Google Play Console
Leaderboard properties
Google Play Console
Google Play Console
Leaderboard properties
Essential Kit Settings
NumberOfStepsToUnlock
Essential Kit Settings
FAQ
The Id from this page will be the Platform Id in Essential Kit Settings for Android
The Id from this page will be the Platform Id in Essential Kit Settings for Android