Getting Set Up

Add a Billing Account

You can have more than one Billing Account and use different ones for different Projects.

There are no ongoing subscription fees for using Panaudia, you just pay for the Spaces you create as, and when, you create them. We charge a flat fee based on the capacity of the Space and the amount of time it's active. You can see the current prices here

Create a Project

Projects are a way to group your Spaces together and make it easier to organise them.

Create an API Key for the Project

You will need an API key to use the Spaces API to creates Spaces.

Create a Space

You can create a Space in our web app or using our Spaces API

When you create a Space you will need to specify a few details:

  • name - A short human-readable name for the Space.
  • description - An optional longer description of the Space.
  • start_time - When you would like the Space to start.
  • duration_minutes - How long the Space goes on for.
  • region - Which of our available regions you would like to create the Space in. Pick the one nearest your users.
  • capacity - The maximum number of people the Space can hold. The options are 10, 25, 50, 100, 250, 500.
  • size - The size across the virtual Space in meters.

Create Tickets

Access to Spaces is secured using Tickets in the form of JSON Web Tokens.

You can create Tickets for a Space in our web app or using our Spaces API: 

POST https://panaudia.com/shapes/v1/spaces/{space-id}/tickets

Tickets are then used to connect to a Space with the JavaScript SDK.

Tickets can contain additional configuration to modify the audio mixing and customise the user's appearance and behaviour.

Connect to the Space

Connect users of your web application to a Space is with the JavaScript SDK.

Pass the Ticket to the connect function along with the parent id of where the audio player should be inserted in the dom and the position and rotation of the user in the Space: 

connect(ticket, parentId, position, rotation);

Then call move as the user moves around the Space to get a continually updated binaural audio mix back of all the other users in the Space:

move(position, rotation);

It is also possible to connect to a Space without using the JavaScript SDK and just use our WebRTC API from any environment that supports WebRTC.