/meetingsdk-javascript-sample

Use the Zoom Meeting SDK in a JavaScript App

Primary LanguageJavaScript

Zoom Meeting SDK Sample JavaScript

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

This repo is an HTML / CSS / JavaScript website that uses the Zoom Meeting SDK to start and join Zoom meetings and webinars.

Zoom Meeting SDK Client View

Installation

To get started, clone the repo:

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

Setup

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

    $ cd meetingsdk-sample-javascript

  2. Open the meetingsdk-sample-javascript directory in your code editor.

  3. Open the client-view.js file, and enter values for the variables:

    NEW: To use the Component View, replace client-view.js with component-view.js. (The leaveUrl is not needed) Also, uncomment the Component View CSS and JavaScript tags and comment out the Client View CSS and JavaScript tags in index.html.

    Variable Description
    authEndpoint Required, your Meeting SDK auth endpoint that secuerly generates a Meeting SDK JWT. Get a Meeting SDK auth endpoint here.
    sdkKey Required, your Zoom Meeting SDK Key or Client ID for Meeting SDK app type's created after February 11, 2023. You can get yours here.
    meetingNumber Required, the Zoom Meeting or webinar number.
    passWord Optional, meeting password. Leave as empty string if the meeting does not require a password.
    role Required, 0 to specify participant, 1 to specify host.
    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.
    registrantToken Required if your meeting or webinar requires registration.
    zakToken Required to start meetings or webinars on external Zoom user's behalf, the authorized Zoom user's ZAK token.
    leaveUrl Required for Client View, the url the user is taken to once the meeting is over.

    Example:

    var authEndpoint = 'http://localhost:4000'
    var sdkKey = 'abc123'
    var meetingNumber = '123456789'
    var passWord = ''
    var role = 0
    var userName = 'JavaScript'
    var userEmail = ''
    var registrantToken = ''
    var leaveUrl = 'https://zoom.us'
  4. Save client-view.js. (Or component-view.js if using Component View.)

Usage

  1. Navigate to index.html in your browser (or serve over localhost) and click "Join Meeting".

    Client View

    Zoom Meeting SDK Client View

    Component View

    Zoom Meeting SDK Component View

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

Deployment

The JavaScript 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. Git add, commit, and push your project:

    $ git add -A

    $ git commit -m "deploying to github"

    $ git push origin master

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

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

Other Static Web Hosting

  1. Deploy the directory to a static web hosting service, like an AWS S3 bucket.

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.