Your GameOn Console
Thank you for your visit. This page is only available in English at this time.

GameOn Tutorial - Setup

Return to Tutorial Overview

The focus of this tutorial is GameOn integration into an Android game. We use the Kotlin language in our code, but all concepts apply equally to Java. We will stick to standard Android framework classes such as Activities and AsyncTasks.

Because our focus is the integration of GameOn into a game, we use a very simple quiz game. The code for this game is provided in whole without integration, and then we go through each integration point. The entire game is provided for download. The tar-ball is a git repository. There is a separate branch for each step in this tutorial. This approach allows us to see how each API integration impacts the app as a whole.

Before starting the GameOn integration, we need to complete the following prerequistes.


  1. Android Studio (with all of its dependencies such as Java) setup.
  2. A test device or emulator to run the app.
  3. A registered account with GameOn, with the accompanying API key. If you haven't already registered, go here to set up your account.
  4. After you register with GameOn, you'll need to create a game. This will give you an admin API key. We need this in our app later.
  5. For our sample game, we use one long-lived tournament to collect scores. Using the admin console, create a new tournament and have it expire after a few weeks or months. After creating the tournament, you can copy the tournament id from the URL in the GameOn console. It will be a standard GUID, for example 2c8aff46-d8d7-4668-8ee7-36db59d76789.
  6. To avoid implementing all of the HTTP client boilerplate by hand, we use the openapi-codegen tool with the GameOn Player API model to generate the client code.
  7. Download the game source code.

Next - Game Walkthrough