Zoom Meeting SDK Sample React

Use of this sample app is subject to our Terms of Use.

NOTE: This Sample App has been updated to use SDK App type credentials instead of JWT App type credentials.

This repo is a React app generated via Create React App that uses the Zoom Meeting SDK to start and join Zoom meetings and webinars.

Installation

To get started, clone the repo:

$ git clone https://github.com/zoom/meetingsdk-sample-react.git

Setup

1. Once cloned, navigate to the meetingsdk-sample-react directory:

   $ cd meetingsdk-sample-react

2. Then install the dependencies:

   $ npm install

3. Open the meetingsdk-sample-react directory in your code editor.

4. Open the src/App.js file, and enter values for the variables:

   NEW: To use the Component View, replace App.js with App-New.js. (The leaveUrl is not needed). Also, uncomment the Component View CSS tags and comment out the Client View CSS in public/index.html.

   Variable	Description
   signatureEndpoint	Required, the endpoint url that returns a signature. Get a signature endpoint here.
   sdkKey	Required, your Zoom SDK App Key. You can get yours here.
   meetingNumber	Required, the Zoom Meeting or webinar number.
   role	Required, 0 to specify participant, 1 to specify host.
   leaveUrl	Required, the url the user is taken to once the meeting is over.
   userName	Required, a name for the user joining / starting the meeting / webinar.
   userEmail	Required for Webinar, optional for Meeting, required for meeting and webinar if registration is required. The email of the user starting or joining the meeting / webinar.
   passWord	Optional, meeting password. Leave as empty string if the meeting does not require a password.
   registrantToken	Required if your meeting or webinar requires registration.

   Example:

   signatureEndpoint = 'http://localhost:4000'
   sdkKey = 'abc123'
   meetingNumber = '123456789'
   role = 0
   leaveUrl = 'http://localhost:3000'
   userName = 'React'
   userEmail = ''
   passWord = ''
   registrantToken = ''
   

5. Save App.js.

6. Run the app:

   $ npm start

Usage

1. Navigate to http://localhost:3000 and click "Join Meeting".

   Client View

   

   Component View

   

   Learn more about Gallery View requirements and see more product screenshots.

Deployment

The React Sample App can be easily deployed to GitHub Pages, or another static web hosting service, like an AWS S3 bucket.

GitHub Pages

1. Create a repo on GitHub.

2. Add the remote to your project:

   $ git remote add origin GITHUB_URL/GITHUB_USERNAME/GITHUB_REPO_NAME.git

3. Open the package.json file and on line 5 replace the homepage value "" with your GitHub repo name with a slash in front like this: "/GITHUB_REPO_NAME".

4. Build your project:

   $ npm run build

5. Rename the build folder to docs

6. Git add, commit, and push your project:

   $ git add -A

   $ git commit -m "deploying to github"

   $ git push origin master

7. On GitHub, in your repo, navigate to the "settings" page, scroll down to the "GitHub Pages" section, and choose the "master branch/docs folder" for the source.

8. Now your project will be deployed to https://GITHUB_USERNAME.github.io/GITHUB_REPO_NAME.

Other Static Web Hosting

1. Build your project:

   $ npm run build

2. Deploy the complied /build directory to a static web hosting service, like an AWS S3 bucket.

Advanced Deployment

For more advanced instructions on deployment, see the React Deployment docs.

Need help?

If you're looking for help, try Developer Support or our Developer Forum. Priority support is also available with Premier Developer Support plans.