# Unity using Google Play Games Services Plugin

## 💖 Health Check / Goal Project

* Windows 10
* Unity 2020.3.14f1 (07, August 2021)
  * Module: Android Build Support
  * Module: iOS Build Support (only to avoid a bug using the GPGS Plugin)
  * 2D Template
* Play Games Plugin for Unity 0.12.10
* 2D Mobile Android App
* Minimum SDK: Android 30

## Set up a Unity Project

### Set up Android

#### `Build Settings`

* Check `Build App Bundle (Google Play)`
* Click `Switch Platform`

#### `Project Settings` > `Player`

{% hint style="warning" %}
**API Level 30 is manadatory** due to newest google restrictions
{% endhint %}

{% hint style="danger" %}
**Windows** To update to API Level 30, ensure to run Unity Hub as administrator. 
{% endhint %}

* **`Other Settings`**
  * `Identification` 
    * `Override Default Package Name` > Check it
    * `Override Default Package Name` > Set your `<your.package.name>`
    * `Version` > Set your app version `0.1.1`
    * `Bundle Version Code`> 1
    * `Minimum API Level` > Android 11.0 (API Level 30)&#x20;
  * `Configuration`
    * `Scripting Backend` > Select `IL2CPP`
    * `Target Architectures` > Check `ARM64`

{% hint style="info" %}
`If you use Google Managed Keys, there is no need to handle any Upload or App Signing Key.`
{% endhint %}

* Create your first `<myappbundle>.aab` bundle
  * `Build Settings` > `Build`

### USB Debugging: Setup

[Setup USB Debugging with your OS (e.g. Android)](https://docs.unity3d.com/Manual/UnityRemote5.html)

### Install Unity Play Games Services Plugin

Install the latest [Play Games Plugin For Unity](https://github.com/playgameservices/play-games-plugin-for-unity/tree/master/current-build) in your Unity project.

## Google Play Console App: Set up app

### Create the App

* Go to [`Google Play Console`](https://play.google.com/) > Create App > Enter your `<appName>`
  * &#x20;Select your default language
  * Choose app type (probably Game)
  * Choose `free app` or `paid app`
  * Check both Checkboxes

### Upload your .aab

* `Testing` > `Internal Testing`&#x20;
  * `Testers` > Add your `google mail` as a test account
  * `Create new release`
    * `App Integrity` > `Continue`

{% hint style="info" %}
This create the App Signing Key managed by google.

Accessible unter `Setup` > `Integrity`
{% endhint %}

* `Testing` > `Internal Testing`&#x20;
  * App Bundles
    * Upload your .aab bundle created by Unity

{% hint style="info" %}
This first upload creates the upload key managed by google.
{% endhint %}

* `Testing` > `Internal Testing`&#x20;
  * `Save` > `Review Release` > `Start Rollout to Interal Testing`
  * `Testers` > `Copy Link`
    * `Open Link (Google Play Store and install the app)`

{% hint style="info" %}
Ensure that you removed previous versions of this app on your mobile device.
{% endhint %}

{% hint style="info" %}
From here on, you set up an empty Android app and made it avaiable for internal testing. No Google Play Services used yet.
{% endhint %}

## Google Play Services Plugin: Setup

* Install the [GPGS Plugin for Unity](https://github.com/playgameservices/play-games-plugin-for-unity/tree/master/current-build).
  * Simply download the `.package` file and double click it while unity project is open
* Apply Google Play Services Resource
  * `Go to Google Play Console` > `Your App` > `Play Games Services` > `Configuration` > `Credentials` > `Get resources` (on the right hand side)&#x20;
    * Copy its content
  * `Unity` > `Window` > `Google Play Games` > `Setup` > `Android Setup ...`
    * insert copied `resource content`
    * Click `Setup`

The resource file should look similar to the following:

```markup
<?xml version="1.0" encoding="utf-8"?>
<!--Google Play game services IDs. Save this file as res/values/games-ids.xml in your project.-->
<resources>
  <!--app_id-->
  <string name="app_id" translatable="false">1234567890123</string>
  <!--package_name-->
  <string name="package_name" translatable="false">your.package.name</string>
</resources>
```

{% hint style="info" %}
As long as you don't use any services such as achievements or leaderboard, no constant file will be created.
{% endhint %}

### Implement the code

```csharp
using UnityEngine;
using System;
using GooglePlayGames;
using GooglePlayGames.BasicApi;


public class PlayGames : MonoBehaviour
{
    public int playerScore;
    public static PlayGamesPlatform platform;

    void Start()
    {
        if (platform == null)
            {
                PlayGamesClientConfiguration config = new PlayGamesClientConfiguration.Builder().Build();
                PlayGamesPlatform.InitializeInstance(config);
                PlayGamesPlatform.DebugLogEnabled = true;
                platform = PlayGamesPlatform.Activate();
            }

            PlayGamesPlatform.Instance.Authenticate(SignInInteractivity.CanPromptOnce, (result) =>
            {
                Debug.LogError($"[CanPromptOnce]: {JsonConvert.SerializeObject(result)}");
            });

            Social.Active.localUser.Authenticate(success =>
            {
                if (success)
                {
                    Debug.Log("Logged in successfully");
                }
                else
                {
                    Debug.Log("Login Failed");
                }
            });
    }
}
```

## `Allow Unity with Java Access`

Currently there is a bug with building the app. It demands access to JAVA which it should have.&#x20;

### Reload the JDK and SDK in Unity

To fix it, deselect the JDK and the SDK in `Unity` > `Preferences` , unselected them and then select them in order again. It will recompile and the build will run in most cases. In my case it didn't, hence I did the second solution.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://justinmind-apps.gitbook.io/unity-using-gpgs-plugin/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.