This project demonstrates what an events experience is like, built using React.

• Requires a PubNub account to work.

The app currently supports

• Chrome 100+
• Edge 100+
• Safari 111+
• Firefox 16.3+

You can deploy the Dolby.io Virtual Events app without needing to clone and build the app using the Deploy to Netlify button. You will need:

• A Netlify account to which you're logged into
• Your Dolby.io App key and secret
• [Optional] Publisher and Subcriber tokens, along with the secret key for PubNub. This is only needed if you would like to experience chat and promoting viewers to host.

Refer to this guide on how to obtain your Dolby.io tokens and this guide from PubNub on how to obtain your PubNub tokens.

The following steps will quickly get you started testing the Dolby.io Communications APIs capabilities.

To build this app, you will need a Dolby.io account (see the How to get a Dolby.io account section).

You will also need to install the following:

• Node v18.0.0 or higher
• NPM v8.11 or higher
• Yarn v1.22.19

As you browse through the source code and documents, you might come across some of these terms:

• A host is a participant with additional permissions to manage the conference and other participants.
• A viewer is a participant who can only receive video and audio stream from the conference.
• A proxy-app-server is an intermediary API server that communicates with the Dolby.io Communications Platform in order to provide functionality such as RTS/RTMP/HLS streaming or consuming web-hook data. You can see our sample implementation here.

To set up your Dolby.io account, go to Dolby.io and register for an account. After confirming your email address, you will be logged in.

If you did not receive a verification email, check your Spam or Junk email folders.

To set up your app for events, you will need to:

1. Go to the Dashboard, and click add new app if you do not have an existing app.
2. To enable events streaming, your app should be opted into the open beta program. You can find this at the bottom of the Communications APIs sidebar navigation when you click on your app.

To run the application locally, clone the repository and then perform the following steps.

note : This guide is written with Yarn in mind. We have not validated this project with other package managers.

Open a terminal window in the root directory of your project folder. Install the project's dependencies using the following command.

yarn

The code in this repository is organised in the following way

• The /events/src/ directory contains all the front-end code for the events app. Within this directory:

  • hooks/ contains wrapper functions around our SDK for re-usable functionality.
  • components/ contains UI components that encapsulate and provide functionality.
  • utils/ provides some generic helper functions.
  • context/ contains the React Context for the side drawer and the main component window.

• The /backend/ contains the code for the proxy server.

This project is built with the Comms UI Kit for React library for simplicity and re-use of standard Communications API-based components.

Create a new file called .env in the events folder and copy the contents of .env.example into it.

You will need to provide the values for KEY and SECRET from your Dolby.io app. To obtain your key and secret from the Dolby.io dashboard:

1. Go to the Dashboard and click on the API Keys next to your application.
2. On the next screen, copy the App key and App secret and paste them in your .env file against the marked variables.

To enable chat and the ability to promote a viewer to host, you will need to provide your PUBNUB_PUBLISH_KEY, PUBNUB_SUBSCRIBE_KEY, and PUBNUB_SECRET_KEY as well. To setup PubNub, please go through the enabling chat guide in our customization guide.

The secrets will not be exposed on the frontend.

To run the application locally, execute the command below inside the /events directory.

yarn dev

Once the dev server starts, open http://localhost:3000 in the browser. The application will launch at this address and will look like the screenshot below.

Follow our customization guide to better understand how you can extend the app to make it your own.

Want to experience the app without building it? Try our Virtual Events Demo app.

Looking for more sample apps and projects? Head to the Dolby.io Project Gallery.