PLAY SDK requires the following software:

• Unity 2020 LTS or later. Installation instructions.

  • It is always recommended to use a late version of Unity for bug fixes and up-to-date compatibility.

Prerequisites

Setup your bundle identifier in the project setting:

1. Open project settings Unity window: Edit->Project Settings...

2. Select Player and open the Other Settings section

3. For iOS tab change the Bundle Identifier

Android

Choose Minimum API Level 23 in Project Settings->Player->Other Settings

For Android you can also change the Scripting Backend from Mono to IL2CPP. Since Unity Android Mono backend does not support arm64 which is required on . But to keep the development iterations faster, you can also keep Mono and only later jump to IL2CPP.

For Android, Target API Level should be 33 or higher for Google Play Store compliance.

Integration Support

If you are unable to find a solution in our documentation you can reach out to us directly by:

• Creating a GitHub issue

• Dropping a message in our Discord dev-chat

Structure

PLAY SDK is divided into multiple modules. Every module has its own functionality. All modules depend on the RGNCore module. In the current version, the modules are distributed by using packages for Unity Package Manager.

Obligatory modules/packages

• RGNCore

• RGNSignInEmail

• RGNSignInGuest

PLAY Unity Initializer

We created an initialization script to automatically setup every module. This script can manage automatically the guest signIn and the modules initialization. To use it, simply create an empty GameObject in your starting scene and attach RGNUnityInitilizer.cs to it. With this script, you don't need to manually build the RGNCore and modules.

Access modules

To access modules you can use the "I" instance provider property:

For example:

Modules namespaces

The modules are located in the RGN.Modules.[module_name] namespaces. Here you can find a full list of modules with the namespaces:

Developers have access to two different environments:

1. Staging: Use this environment while developing and testing. This environment will use the testing blockchain backend.

2. Production: Use this environment for the releases, live versions available to users.

Example.

1. John started integrating the PLAY SDK in his application by setting the Staging environment.

2. He completed and tested feature Implementation in the Staging environment.

3. After that, he is ready to update the version in Stores, So he set Production and created new builds for store submission. He did a smoke test and updated in Stores.

Environment Setup

After setting up the above configuration data, you can switch Staging/Production environment from the Unity menu:

ReadyGamesNetwork->Set Staging

ReadyGamesNetwork->Set Production

1. Go on the developer dashboard and select your project.

1. Click on Download unity packages to download your project credentials.

1. Import this file by using Unity Assets->Import Package->Custom Package... menu. After importing you should see the ReadyGamesNetwork folder in your Assets folder with all necessary settings:

Package Dependencies

In case you use an older version of Unity you need to add the Newtonsoft Json package. You can install it by pasting following into your manifest.json file:

In the new Unity versions the Newtonsoft Json is build in to Unity. No need to install the package.

Dependencies Installation:

1. Git package repository link. The easiest way to add the READYgg SDK into your project is to use PLAY package distribution. You need simply put the package git repository links into manifest.json file. See instructions below.

Troubleshooting : if you have error messages in Unity saying that it cannot find the git repository, make sure you have Git installed on your machine. Unity Hub needs it to import packages from Github.