Essential Kit Tutorials
DocumentationDownload
Latest(v3)
Latest(v3)
  • Introduction
  • Features Overview
  • Whats new in v3
    • Version 3 vs Version 2
    • Release Notes
    • Upgrade from V2
  • Plugin Overview
    • Settings
    • Folder Structure
    • Installation FAQ
    • Upgrade Guide
  • Features
    • 📒Address Book
      • Setup
      • Usage
      • Testing
      • FAQ
    • App Shortcuts
      • Setup
      • Usage
    • 🆕App Updater
      • Setup
      • Usage
    • 💲Billing Services
      • Setup
        • iOS
        • Android
      • Usage
      • Testing
        • iOS
        • Android
      • FAQ
    • ☁️Cloud Services
      • Setup
        • iOS
        • Android
      • Usage
      • Testing
      • FAQ
    • 🔗Deep Link Services
      • Setup
        • iOS
        • Android
      • Usage
      • Testing
      • FAQ
    • 🛠️Utilities (Extras)
      • Usage
    • 💯Game Services
      • Setup
        • iOS
        • Android
      • Usage
      • FAQ
    • 📸Media Services
      • Setup
      • Usage
      • FAQ
    • 📆Native UI
      • Setup
      • Usage
      • FAQ
      • Examples
        • Login Dialog
    • Network Services
      • Setup
      • Usage
      • FAQ
    • ⏰Notification Services
      • Setup
        • iOS
        • Android
      • Usage
      • Examples
        • Nudge to come-back to the game
      • FAQ
    • ⭐Rate My App
      • Setup
      • Usage
      • FAQ
    • 🤝Sharing
      • Setup
      • Usage
        • Message Composer
        • Mail Composer
        • Social Share Composer
        • Share Sheet
      • FAQ
      • Examples
        • Add Attachment Example
    • Task Services
      • Setup
      • Usage
    • 🌏Web View
      • Setup
      • Usage
      • FAQ
      • Examples
        • Loading Pdf File
  • Notes
    • Resolving Android Gradle Build Errors
    • Google Play Services Authentication
    • Target API Level vs Min API Level
    • Handling Refunds for In-App Purchases (Billing Services)
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. Features
  2. Game Services
  3. Setup

Android

PreviousiOSNextUsage

Last updated 26 days 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
FAQ
Essential Kit Settings
NumberOfStepsToUnlock
Essential Kit Settings
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