This sample project consists of an Android app and a Node.js server. Together, they facilitate interview practice through one-on-one video conferencing. This project leverages Dolby.io Interactivity APIs and SDK to provide conferencing, and uses its REST APIs to authenticate and monitor the state of the app.
You will need Android Studio (preferably 4.0 or higher, although 3.6 is the absolute minimum). If you don't have an emulator installed, set that up (instructions here). You should also have the necessary SDK Platforms - the Android 11.0, API 30 SDK should be fine for testing purposes (from Android Studio, go to Tools > SDK Manager to download).
For the server, all you need are recent versions of Node.js and npm (refer to the package-lock file for more information).
Next, clone this repository into a directory of your choice.
git clone github.com/dolbyio-samples/comms-app-android-video-chat-user-matchingThen, in Android Studio, choose to import a project and navigate to where you cloned the project. Choose the android/ directory to open. To be able to fully use the app, you need to have a server running. See the localhost instructions below for a quick way to do some testing, or the more detailed guide below to deploy the server on Heroku. Either way, you'll need to change the URL variable the StringConstants file in the app code before running.
After you have a server running, select your Android emulator from the drop-down menu at the top of Android Studio and press the green play button to build and install the app. Alternatively, you can connect a physical device via USB and install the app that way. See this link for information on how to install the app onto your device.
Option 1 - Localhost
Navigate into the server directory and run npm install to install all the necessary packages and dependencies.
Next, create a .env file in the server directory that defines two variables: APP_KEY and APP_SECRET, and set them equal to your Dolby.io Interactivity key and secret respectively.
Still in the server directory, run
node ./server.jsto start listening on port 3000. Finally, in the StringConstants class in Android Studio, uncomment the variable labeled for local testing and insert your IP address where indicated. You're ready to run the app!
Option 2 - Heroku
If you want a more permanent way to host a server for access tokens and calls to the Monitor API, you can use Heroku. Full details on how to deploy a Node.js server can be found here.
After making a Heroku account, install the Heroku CLI. For Macs, use
brew install heroku/brew/heroku
For Windows, visit the Heroku website to find an installer. Run
heroku login
and enter your Heroku information. For easy deployment, Heroku expects your code to be inside a git repository. While you can create a git subtree for the server folder inside this project directory, for simplicity just copy the server directory to a different location and initialize it as a new git repository.
From inside the root project directory:
cp -r server/ ~/your/path/here
Then inside that directory:
git init
Add a .gitignore file with the typical structure for a Node project:
/node_modules
npm-debug.log
.DS_Store
/*.env
And add all the server files:
git add .
Next, create a Procfile, which defines to Heroku which command starts your code. The Procfile should not have a file extension, and should contain the following:
web: npm start
Run
heroku create
This creates a Heroku project that is a remote for your local repository. Push your files to the remote with
git push heroku main
You should see output confirming successful deployment.
On the Heroku website, your app should now show up on your dashboard. In the Settings tab of your app, add two config vars: APP_KEY and APP_SECRET, with the values of your Interactivity key and secret respectively.
Your server is now deployed! Uncomment the URL variable labeled for Heroku in the StringConstants file of the app and enter your Heroku app URL instead of the placeholder text. To find out the URL of your app, you can type
heroku open
in the directory where your server code lives and copy the resulting URL.
Happy mock interviewing!