Create Custom Video Chat with OpenTok and React Components

Published July 16, 2019 by Lauren Lee
Categories:

I’ve recently started tinkering around with TokBox’s OpenTok API and building a few starter apps with video chat.

tweet of playing with OpenTok API for the first time

And while it’s fun and sort of silly to quickly add a live-stream of my face to an app I’m working on, I soon became curious of other use cases. Or rather, what’s the benefit of building it out myself as opposed to using one of the many other video-conferencing options out there?

To explore the full functionality of the API, I thought I’d create an app for the students of the bootcamp I attended, Ada Developers Academy.

Ada is a tuition-free, year-long program for women and gender diverse folks to learn to code. I feel ridiculously fortunate to have attended and been given the tools to transition from being an English teacher to a software engineer in just a year. So I thought a great way to give back would be to create a portal for students to get in touch with tutors and get real-time, face-to-face help from industry mentors. Plus I’d be able to learn more about the OpenTok API at the same time!

While building out that portal, I soon discover what so many engineers have before: how awesome it is to have complete ownership and control over the functionality of the code within your app. I could tailor the app and my code to the needs of the students and tutors, which felt super powerful. I was specifically playing around with OpenTok’s React wrapper called, OpenTok React, which is essentially a web component for the OpenTok JS SDK. It makes it incredibly simple to integrate high-quality video and audio streaming into any React app. It provides customizable components that are flexible enough to embed within any of my React apps quite easily.

This is a tutorial on how to use that React Wrapper and break the code up into modularized and reusable React components to embed into any or all of your future React apps!

Prerequisites

How to Create a Custom Video Chat with OpenTok API and React Components

You are going to accomplish the following tasks to create your app:

  1. Create a TokBox Project
  2. Create a React App with create-react-app
  3. Build out Reusable React Components:
    • Publisher
    • Subscriber
    • ConnectionStatus
    • CheckBox
  4. Run Your Video Chat App

This tutorial will take you through the process from scratch. Although if you’d like to see the finished code, you can clone the git repository for this project.

Create a TokBox Project

Once signed in to your TokBox account, in the left hand corner of your page, select Projects and, from the dropdown, click Create New Project.

where to click new project demo

From there, select Create Custom Project and name it whatever you like. Once you’ve created the project, click View Project and save the API key up at the top.
Next, scroll down to the section titled Project Tools and click the blue button to Create Session ID.

what to click to generate a sessionID

Copy and paste that sessionID into the section below Generate Token. Feel free to prolong the expiration time beyond the default 1 hour if you’d like.
Next, click the blue Generate Token button and save the generated token.

Create a React App with create-react-app

Before we dive in, be sure to verify that you have an updated version of Node installed on your machine (5.2 at the minimum) by running node -v in your terminal.

Next, in the directory you’d like this project to live run the command:

I’ve called my project react-components-tokbox, but you can name it whatever you like.

Move into your project and install the two dependencies that we’ll use for this project:

The opentok-react library is a React wrapper that is comprised of a few components that we’ll use today:
* OTSession Component
* OTPublisher Component
* OTStreams Component
* OTSubscriber Component
* createSession Helper
* preloadScript Higher-Order Component

Run npm start to ensure that everything installed correctly. localhost:3000 should automatically open up and be running the boilerplate React starter code.

Config Setup

Move into the src folder and create a config.js file:

Open up that new file and add the credentials you generated just now when you created a TokBox project:

Now, open up the src/index.js file and import the congfig.js file:

Now, to actually use those credentials, be sure to pass them to the <App /> component:

In the src/App.js file, let’s import some of the components from the React wrapper:

Build out Reusable React Components

Create a new components folder within src. In that folder, create your components:

Now again in your src/App.js file, import three of those components:

Let’s change the <App /> component in that file to be class-based as opposed to functional.

Within the constructor, add in some state and two sessionEvents to detect connectivity status:

Outside of the constructor, create a function onError():

Within the render() function, add in the <OTSession /> component that passes the credentials from the src/index.js file:

Now, within the <OTSession /> let’s preemptively handle errors and call the components, <ConnectionStatus />, <Publisher />, and <Subscriber />:

Build Out the ConnectionStatus Component

In the src/components/ConnectionStatus.js file, let’s think about the best way to display the Connection Status to the user:

Now back in the src/App.js file, pass the state to the <ConnectionStatus /> component:

Build Out the Publisher Component

Now, at the top of your src/components/Publisher.js file, import the files and the OTPublisher from opentok-react:

Below that, let’s create a class-based component Publisher:

Let’s fill in those functions with some state:

And within the <OTPublisher /> let’s pass in publishAudio, publishVideo, and videoSource to the properties prop and the function onError() to the onError prop:

Build Out the Subscriber Component

Now, in the src/components/Subscriber.js file, let’s import the files and components and create a class-based component Subscriber with subscribeToAudio and subscribeToVideo as properties within the <OTSubscriber />:

Build Out the CheckBox Component

We’ll use the <CheckBox /> component within both the <Publisher /> and <Subscriber /> components:

Let’s now use both the <CheckBox /> component in the src/components/Publisher.js file:

And also in the src/components/Subscriber.js file:

And lastly, let’s add in some simple CSS for the app in the src/App.css file:

Run Your Video Chat App

You now have created all 4 React components:
– Publisher
– Subscriber
– ConnectionStatus
– CheckBox

You can test out your app but running npm start from the root of your project in your terminal.

view after running npm start

Congrats! These components are modularized and reusable for any future React app.

You can now easily and quickly plug them into your app to enable video chat capability. How neat is that?! I’m for one, pretty obsessed 😆 and have begun searching for any and all opportunities in my day-to-day life in which to add video chat!

🌟Let’s Collaborate!🌟

If you have a creative, new, silly, or innovative idea for how to use video chat, please share!

I’d be SUPER excited to collaborate and create new apps together.

Leave a Reply

Your email address will not be published.