Join a Meeting
Meetings are joined in the Web SDK using the ZoomMtg.init()
method to launch the SDK, then the ZoomMtg.join()
to join the user into the meeting. The join method receives an encrypted signature, your API Key, a meeting ID, and any user settings.
Before joining, remember to prepare required files and setup a signature function.
Create a meeting
For testing, create a meeting in your Zoom client or at https://zoom.us/meeting/schedule to retrieve a Meeting ID and passcode. Advanced applications can also use the Meetings API to create and retrieve meetings. If you already have a meeting ID to join, continue on.
Create meetConfig object
To receive user input and meeting settings, create a client-side meetConfig
object to pass data to a server-side generateSignature
function and the meeting join methods.
Example meetConfig object:
const meetConfig = {
apiKey: '3239845720934223459'
meetingNumber: '123456789',
leaveUrl: 'https://yoursite.com/meetingEnd',
userName: 'Firstname Lastname',
userEmail: 'firstname.lastname@yoursite.com',
passWord: 'password', // if required
role: 0 // 1 for host; 0 for attendee
};
Please note that when using PMIs for the meetingNumber property, WebSDK attendees are not allowed to join meetings before the host.
Launch & Join Meeting
Pass your meetConfig
object to a getSignature function. Make a request to your signature endpoint, then pass that response to call the init method.
In the ZoomMtg.init()
method, set any meeting settings (ex: leaveUrl, isSupportAV).
Call the ZoomMtg.join()
method as a success param of ZoomMtg.init(). The join()
method will handle your signature (as a text string).
index.js
import { ZoomMtg } from '@zoomus/websdk'
ZoomMtg.preLoadWasm();
ZoomMtg.prepareJssdk();
getSignature(meetConfig) {
fetch(`${YOUR_SIGNATURE_ENDPOINT}`, {
method: 'POST',
body: JSON.stringify({ meetingData: meetConfig })
})
.then(result => result.text())
.then(response => {
ZoomMtg.init({
leaveUrl: meetConfig.leaveUrl,
isSupportAV: true,
success: function() {
ZoomMtg.join({
signature: response,
apiKey: meetConfig.apiKey,
meetingNumber: meetConfig.meetingNumber,
userName: meetConfig.userName,
// password optional; set by Host
passWord: meetConfig.passWord
error(res) {
console.log(res)
}
})
}
})
}
}
Set this function to launch within your application, for example, on a “Join Meeting” button.
Joining meetings with reCAPTCHA
As of version 1.7.9, meeting participants might see a reCAPTCHA check to join meetings. To ensure this check is working, run your application on port 80 or 443.
On successful join methods, participants might see a pop up modal with a reCAPTCHA check. After participants successfully complete reCAPTCHA, they will enter the meeting.