Set up a Panaudia account

The first thing to do is sign up:

Register

Then you need to set up a few things before creating your first Space:

Create an Organisation

Organisations allow you to share Panaudia Projects with colleagues and centrally manage billing.

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

Spaces are created with the Spaces API.

POST https://panaudia.com/shapes/v1/projects/{project-id}/shapes

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, 1000 or 2500.
  • size - The size across the virtual Space in meters.

For convenience in development you can also create Spaces using the Quick Start tab on the Project page in the web console.

Create Tickets

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

You can create Tickets using the 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.

You can also create and sign Tickets yourself or using Quick Start tab of the Space in the web console.

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.