Skip to main content

Unity Playground Setup

After you import the Inworld Playground project into Unity, the first step is to play through the Setup scene.

The setup process involves cloning the Playground workspace into your account on Inworld Studio and then linking that workspace with your Unity project.

You can get started by running any scene in the Assets/Inworld/Inworld.Playground/Scenes folder. Regardless of which scene you pick, you are rerouted to the Setup scene to perform the initial setup process.

Editor Scenes

Welcome Page

When you play the Setup scene you are greeted with a welcome screen.

Here you can enter your name so that Inworld characters know how to refer to you when speaking.

Welcome Page

The Playground Setup scene is made up of a number of pages, each with different instructions to follow.

At any time you can move sequentially back and forth between pages using the Back and Next buttons. The Next button may become locked until an input field is properly filled out.

Control Buttons

⚠️ Note: If you have already run through the Setup process previously you then automatically jump to the Settings Page after completing the Welcome Page. To modify the setup properties, you can press the Back button to return to the previous pages.

1. Cloneable Workspace Page

The first step in the setup process is to clone the Playground workspace into your Inworld Studio account. The easiest way to do this is to click the URL button to follow the link which will take you to Inworld Studio.

Once you have created an account and logged in you will be faced with an Import workspace panel with a button to confirm the importing of the Inworld Playground workspace.

Cloneable Workspace Page

Once you click Confirm impor the workspace will be added to your account and appear in your Workspaces. This may take a few seconds to complete, afterwards you will see the Workspace is imported text appear and a pop-up letting you know that the Workspace ID has been copied to your clipboard. This ID is important for the next step.

Inworld Studio Import Complete

At this point you can return to Unity and click Next.

2. Workspace ID Page

The next step is to enter your workspace ID, copied from the previous step.

Copy and paste your clipboard into the input field on the current page. It should look similar to the image below. Note that it is optional to include the "workspaces/" portion of the ID.

Workspace ID Page

⚠️ Note: If the Workspace ID was not copied to your clipboard in the previous step, it can be found on the Integrations page of the freshly cloned inworld-playground-v2 workspace in your Inworld Studio account.

Once the workspace ID has been input you can press the Next button to move on to the next step.

3. API Key Page

The final step is to enter a base64 authorization signature into the input field on this page. Follow the link button in Unity, it will take you to the Integrations page in Inworld Studio. From there you can generate a new API Key by pressing the Generate New Key button under the API Keys section.

API Key Page

Then click the Base64 button next to your API Key to copy the base64 authorization signature to your clipboard.

Finally, paste this signature into Unity and press Next to complete the cloneable workspace setup.

Game Data

Upon completing the cloneable workspace setup, a new Inworld Game Data object has been created.

This object stores the workspace ID, API key and secret for the cloned Inworld Playground workspace in your account.

Game Data Inspector

The default location is within Assets/Inworld/UserData/Playground. The file is named PlaygroundData.asset.

Playground Game Data in default location

Now that this Game Data object is generated, you can run any scene in the Playground project.

⚠️ Do Not Share Data Object ⚠️

It is important that you do not share this Inworld Game Data object, as it contains an API key/secret for the cloned Playground workspace in your account.

This means anyone with access to this data will be able to make requests to your personal Inworld Playground workspace.

:::

Settings

Once you complete the cloneable workspace setup, you gain access to the Settings page where you can modify various settings to test out different features in the Playground demo.

Settings

When you finish modifying your settings, press Connect to connect with Inworld's servers.

Upon successful connection, the Play button becomes active. Pressing Play brings you into the Playground Lobby.

For more detailed information about modifying settings, see below:

Player Name

The Player Name is the name of the player that was entered during the setup process. Inworld characters refer to you by this name.

You can change this name by restarting the setup process or (if you are in the Setup scene) by pressing the Back button until you return to the Welcome Page.

Settings Name Section

Workspace ID

The Workspace ID is the ID of the cloned Playground workspace from your account.

This was entered during the setup process. To modify this ID press the Back button until you return to the Workspace ID Page.

Note that you can only modify this value from the Setup scene.

Settings Workspace ID Section

Microphone Input Device

The Microphone Input Device section allows you to select which audio input device you would like to use for the Playground demo.

Settings Microphone Input Section

⚠️ Note: A working microphone is required to play the Playground demo.

Settings Inworld Icon The inworld icon will fill purple from the left to visualize the audio input. This can be used to determine if your microphone is working within the application.

Settings Microphone Icon The microphone icon is a mute button which can be used to enable/disable audio listening within the Settings menu (this does not affect the microphone outside the Settings menu).

Settings Refresh Icon The refresh icon is a recalibration button that can be used to calibrate the microphone to the current background noise of your environment (used to determine if the player is speaking).

Microphone Mode

There are three different microphone/interaction modes to choose from.

Settings Microphone Mode Toggles

Each mode affects how you can interact with Inworld characters in the Playground in different ways:

  • Interactive: The default mode. Microphone is always on, you can speak at any time.
  • Push-to-talk: You must press and hold the push-to-talk key (V by default) to speak to a character.
  • Turn-by-turn: You cannot interrupt characters. If a character is speaking you will be ignored until they finish.

AEC

The AEC toggle allows you to enable/disable acoustic echo cancellation in the Playground demo.

Settings AEC Toggle

Acoustic echo cancellation helps to reduce audio feedback from speakers affecting the characters in game.

Connection

The Connect button allows you to Connect/Disconnect from the server.

Settings Connection Button Idle Settings Connection Button Connected

Before playing the first time you must connect to the server, otherwise the Play button will be disabled.