Concepts
Basic Concepts
This section introduces the basic concepts behind Reactional's In-Game Personalization solution.
Project
A Project represents your game and serves as a container for the music content you wish to provide to your players, or more broadly, any music content you want to include in your game.
- Projects are set up and managed on the Reactional Platform.
- Projects may contain multiple Apps.
App
An App is a set of credentials (App ID and App Secret) that allows your game to access Reactional's REST API.
- You can create multiple Apps for different environments (e.g., Test and Production). Test Apps are intended for development and testing purposes and do not incur any charges, while Production Apps are meant for live environments and may incur costs based on usage.
- Apps are set up and managed at Project level on the Reactional Platform.
Client
A Client is an instance of your game that connects to Reactional's REST API via the Reactional Plugins.
- Each Client has a set of credentials (Client ID and Client Secret) that are used to authenticate with the REST API.
- Clients are created using the Register a Client API.
- Clients can be given access to specific content (e.g. Reactional Tracks) by creating Entitlements for them.
Entitlement
An Entitlement is a permission granted to a Client to access specific content within your game.
- Entitlements are created for individual Clients using the Create Entitlements API.
- Creating Entitlements incurs a cost based on the amount paid by the end-user for the content.
Components
Let's take a look at the main components that make up Reactional's In-Game Personalization solution: the Reactional Platform, the REST API, and the Reactional Plugins.
Reactional Platform
The Reactional Platform is a web-based interface that allows you to manage your projects, the music content associated with your projects, and the apps that enable In-Game Personalization in the scope of your projects.
REST API
The Reactional REST API allows your game server to create new Clients and control their access to content by creating Entitlements.
Reactional Plugins
The Reactional Plugins are libraries that can be integrated into your game client to provide access to Reactional's music catalog and enable dynamic music playback.
They provide ready-to-use APIs for catalog browsing, audio preview, and retrieval and playback of purchased content.
Initializing a Reactional Plugin to enable In-Game Personalization requires Client credentials (Client ID and Client Secret). Client credentials are returned by the Register a Client API.