-
Notifications
You must be signed in to change notification settings - Fork 100
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
6573e86
commit 387fb01
Showing
2 changed files
with
110 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,20 +1,109 @@ | ||
# @zoomus/websdk | ||
zoom webclient WebSDK Local NPM repository | ||
# Zoom Web SDK | ||
|
||
The Zoom Web SDK NPM package is for implementing the Zoom Web SDK with a frontend framework like React or Angular that uses webpack / babel. | ||
|
||
## Installation | ||
|
||
In your frontend project, install the Web SDK: | ||
|
||
`$ npm install @zoomus/websdk --save` | ||
|
||
## Usage | ||
|
||
In the component file where you want to use the Web SDK, import `ZoomMtg` and call the `preLoadWasm()` and `prepareJssdk()` functions. | ||
|
||
```js | ||
import { ZoomMtg } from '@zoomus/websdk'; | ||
|
||
ZoomMtg.preLoadWasm(); | ||
ZoomMtg.prepareJssdk(); | ||
``` | ||
npm i @zoomus/websdk | ||
|
||
NOTE: The following directory (already in node_modules) must be accessible in your url path: | ||
|
||
- `node_modules/@zoomus/websdk/dist/lib/` | ||
|
||
Or, you can set a custom path to the Web SDK's lib directory using: | ||
|
||
```js | ||
ZoomMtg.setZoomJSLib('http://localhost:9999/custom/path/to/lib/', '/av') | ||
``` | ||
|
||
[sample-app-web](https://github.com/zoom/sample-app-web) is a demo how to use WebSDK. | ||
NOTE: The following files (already in node_modules) must be globally accessible (equivalent of link and script tag in index.html): | ||
|
||
- `node_modules/@zoomus/websdk/dist/css/bootstrap.css` | ||
- `node_modules/@zoomus/websdk/dist/css/react-select.css` | ||
- `node_modules/jquery/dist/jquery.min.js` | ||
|
||
### Support | ||
For any issues regarding our Web Client SDK, please visit our JS SDK Community Support Forum at | ||
Set the config variables (reference below): | ||
|
||
[https://devforum.zoom.us/c/javascript-api-development](https://devforum.zoom.us/c/javascript-api-development) | ||
```js | ||
// setup your signautre endpoint here: https://github.com/zoom/websdk-sample-signature-node.js | ||
var signatureEndpoint = 'http://localhost:4000' | ||
var apiKey = 'JWT_API_KEY' | ||
var meetingNumber = 123456789 | ||
var role = 0 | ||
var leaveUrl = 'http://localhost:9999' | ||
var userName = 'WebSDK' | ||
var userEmail = '' | ||
var passWord = '' | ||
``` | ||
|
||
Config variables reference: | ||
|
||
| Variable | Description | | ||
| -----------------------|-------------| | ||
| signatureEndpoint | Required, the endpoint url that returns a signature. [Get a signature endpoint here.](https://github.com/zoom/websdk-sample-signature-node.js) | | ||
| apiKey | Required, your Zoom JWT App API Key. | | ||
| meetingNumber | The Zoom Meeting / webinar number. | | ||
| role | Required, 0 to join the meeting / webinar, 1 to start the meeting. | | ||
| 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 | Optional, the user joining / starting the meeting / webinar. | | ||
| passWord | Optional, meeting password. Leave as empty string if the meeting does not require a password. | | ||
|
||
Generate the meeting signature to authenticate, [instructions here](https://github.com/zoom/websdk-sample-signature-node.js). | ||
|
||
```js | ||
var signature = 'eHUzSlBhQV9SSlcyLTlsNV9IQWFMQS4xMjM0NTY3ODkuMTU4MzE2OTUzODc3My4wLkJMNEtiM3FINGx5ZzA1MUZtbGJOcGtPRnlFQS9lQUR2bGllVzJNNGZJeWs9' | ||
``` | ||
|
||
Then init, and join the meeting. | ||
|
||
```js | ||
ZoomMtg.init({ | ||
leaveUrl: leaveUrl, | ||
isSupportAV: true, | ||
success: (success) => { | ||
console.log(success) | ||
|
||
ZoomMtg.join({ | ||
signature: signature, | ||
meetingNumber: meetingNumber, | ||
userName: userName, | ||
apiKey: apiKey, | ||
userEmail: userEmail, | ||
passWord: passWord, | ||
success: (success) => { | ||
console.log(success) | ||
}, | ||
error: (error) => { | ||
console.log(error) | ||
} | ||
}) | ||
|
||
}, | ||
error: (error) => { | ||
console.log(error) | ||
} | ||
}) | ||
``` | ||
|
||
## Sample App | ||
|
||
## License | ||
Checkout the Zoom [Web SDK Sample App](https://github.com/zoom/sample-app-web), and the [Simple Signature Setup Sample App](https://github.com/zoom/websdk-sample-signature-node.js). | ||
|
||
Use of this software is subject to important terms and conditions as set forth in the License file | ||
## Need Support? | ||
The first place to look for help is on our [Developer Forum](https://devforum.zoom.us/), where Zoom Marketplace Developers can ask questions for public answers. | ||
|
||
Please refer to [LICENSE.md](LICENSE.md) file for details | ||
If you can’t find the answer in the Developer Forum or your request requires sensitive information to be relayed, please email us at developersupport@zoom.us. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters