Skip to main content
Version: 2024.1.17 🚧

Launch the Skillz UI



Overview​

Once the Skillz SDK is added to your project, it is time to start setting up the core of your game loop, launching the Skillz UI. The standard user flow is App Launch -> Landing Page -> Launching the Skillz UI. On installation, it is very important to get players into gameplay with as little friction as possible, with the tutorial being part of the user flow for the first real match played. Once in the Skillz UI, your players will be able to choose from a variety of different interfaces. To understand more about the Skillz UI, please refer to this documentation.

The below steps will walk you through setting up some core elements of the Skillz SDK, helping you to accomplish your first steps of your Skillz integration.

Important Note for Unity Integrations​

To better understand how the Skillz SDK works with Unity please refer to our guidance on Unity Script Execution

Implement the SkillzManager or SkillzDelegate​

Control of your application is given to Skillz when you launch the Skillz UI. Because of this, you'll need to add the Skillz Manager (Unity) or implement the Skillz Delegate interface (Other), which contains callbacks that will be invoked for key events. There are three events that are essential for interacting with Skillz:

  1. When a match is starting
  2. When the user is exiting the Skillz UI (via the sidebar menu)
  3. When trying to enter the Progression Room

First, a Skillz Manager needs to be added to your start menu scene.

  1. Right click in the Hierarchy and select Create Empty. In the inspector, click Add Component then add the Skillz Manager component.

  2. Open the Skillz Manager in the Inspector.

  3. Choose a Game Scene, Start Menu Scene, and optionally a Progression Room Scene for the scene fields.

NOTE: If your project does not use multiple scenes, or scenes need to be loaded manually, the scene fields can be left blank. The logic for these events can then be included in the extra logic script (see below).

Skillz Manager

NOTE: If your project uses unsupported Unity version 2019 or lower the Skillz Manager will not display correctly. If you encounter this, please use this solution.

  1. For additional logic you may add a script to the Skillz Manager by selecting Add Component in the inspector, then selecting a custom script. The script must be on the same gameObject as the Skillz Manager.

Methods from this script can then be called by pressing the + button under the On Match Will Begin, On Skillz Will Exit, and On Progression Room Enter, then selecting public methods from the added script.

Skillz Manager

An example extra logic script:

SkillzExampleManagerLogic.cs
// ...
  public class SkillzExampleManagerLogic : MonoBehaviour
  {
    public void OnMatchWillBeginLogic(SkillzSDK.Match match)
    {
      Debug.Log("Loading Game Scene");
    }

    public void OnSkillzWillExitLogic()
    {
      Debug.Log("Loading Start Menu Scene");
    }

    public void OnProgressionRoomEnterLogic()
    {
      Debug.Log("Loading Progression Room Scene");
    }
  }
// ...

Initialize Skillz​

Once you have at least stubbed in the delegate functions, you are not able to initialize Skillz. This is usually right after your game's process has finished launching or in your game's start screen (if there is one).

You must initialize Skillz before you can launch it.

Skillz is initialized when your game starts up. Make sure you have configured your game appropriately.

Launch Skillz​

With Skillz initialized, you can now launch it to take over control of your interface. Typically, Skillz is launched from your game's start screen. Specifically, we recommend that your game's start screen has a button to launch Skillz when it is clicked. The examples below all follow that pattern.

TitleScreenController.cs
public sealed class TitleScreenController : MonoBehaviour
{
    public void PressPlayButton() {
        SkillzCrossPlatform.LaunchSkillz();
    }
}

Note: Skillz Unity Lifecycle​

The Skillz SDK does not change scenes. The Skillz Unity UI is a native iOS/Android Activity. So you'll only detect an OnApplicationPause when it loads or unloads.

Skillz Lifecycle

To prevent problems with residual game-state, our suggestion is to create a simple "Loading" scene. Whenever you invoke either of the Skillz functions SkillzCrossPlatform.LaunchSkillz(), or SkillzCrossPlatform.ReportFinalScore(score) - your code should also load your "Loading" scene via SceneManager.LoadScene. This will force your current scene to unload, so that way every match will start with totally fresh assets.

If your game is not making use of loading separate scenes - then instead of calling SceneManager.LoadScene - your code is instead responsible for cleaning up all of the variables and game-state in the current scene.

Exit Skillz​

Users can exit Skillz via a sidebar menu item. When this happens, a callback in your Skillz Manager or Skillz Delegate implementation is invoked. You'll want to handle this callback to load an appropriate game screen. This typically will be the main menu/start screen.

Set the Start Menu Scene in the Skillz Manager.

Test​

The completed Skillz Manager (Unity) or Skillz Delegate (Other) should resemble this:

Skillz Manager

SIDEkick​

If your game is made with Unity, you can simulate launching Skillz from the editor by using the Skillz SIDEkick before exporting and building for iOS or Android. If you are having issues, more insight can be gained by turning on debug logging in the Skillz settings.

You should now be able to launch the Skillz UI from your game. Please build your game and verify that Skillz can launch from a mobile device in order to get your first checkmark in the Developer Console.

Next Steps​

In this article, you learned how to launch the Skillz UI from your game. The next article will describe how to start matches.