Skip to content

Commit

Permalink
version 2.1.0-1
Browse files Browse the repository at this point in the history
  • Loading branch information
tommygaessler committed Jan 17, 2025
1 parent ea95468 commit 1964394
Show file tree
Hide file tree
Showing 6 changed files with 46 additions and 6 deletions.
31 changes: 29 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Use of this SDK is subject to our [Terms of Use](https://explore.zoom.us/en/vide

The [Zoom Video SDK UI toolkit](https://developers.zoom.us/docs/video-sdk/web/ui-toolkit/) is a prebuilt video chat user interface powered by the Zoom Video SDK.

![Zoom Video SDK UI toolkit web](ui-toolkit–gallery-view.png)
![Zoom Video SDK UI toolkit web](uitoolkitgalleryview.png)

## Installation

Expand Down Expand Up @@ -66,7 +66,14 @@ var config = {
sessionName: 'SessionA',
userName: 'UserA',
sessionPasscode: 'abc123',
features: ['preview', 'video', 'audio', 'share', 'chat', 'users', 'settings'],
streamUrl: 'rtmp://a.rtmp.siteofyourchoice.com',
streamKey: 'xxxx-xxxx-xxxx-xxxx',
broadcastUrl: 'https://studio.siteofyourchoice.com/livestreaming',
crDisclaimer: 'Cloud recording disclaimer for the UIToolkit to prompt',
lttDisclaimer: 'Live Transscription and Translation disclaimer for the UIToolkit to prompt',
livestreamDisclaimer: 'Live streaming disclaimer for the UIToolkit to prompt',
disableCaptionsOnJoin: true,
features: ['preview', 'video', 'audio', 'share', 'chat', 'users', 'livestream', 'pstn', 'ltt', 'recording', 'settings', 'feedback'],
options: { init: {}, audio: {}, video: {}, share: {}},
virtualBackground: {
allowVirtualBackground: true,
Expand All @@ -76,6 +83,20 @@ var config = {
}
```

If you pass a string to the config object disclaimers(cr, ltt, and livestream), you are telling the UIToolkit that it will handle prompting the disclaimers passed when the corresponding event triggers. If you leave the fields empty, the developer is responsible for the disclaimer UI and the prompting these disclaimers when the event is triggered. You can listen for these events and pass in a callback via the code below:

```js
const client = ZoomVideo.createClient();

client.on('recording-change', () => {});
client.on('caption-status', () => {});
client.on('live-stream-status', () => {});
```

Because the VideoClient follows the singleton pattern, you can call createClient() to retrieve the same client object the UIToolKit uses to control the underlying Zoom Video SDK. You can then utilize any functions offered by the base Zoom Video SDK. Please note, that certain components in the UIToolKit depend on state stored and passed within its underlying components so calling certain functions outside of the UIToolKit can introduce unexpected behavior in the UI.



Currently, we support the following features:

| `features[]` | Description |
Expand All @@ -85,8 +106,14 @@ Currently, we support the following features:
| `audio` | Show the audio button on the toolbar, and to send and receive audio. |
| `share` | Show the screen share button on the toolbar, and to send and receive screen share content. |
| `chat` | Show the chat button on the toolbar, and to send and receive session chats. |
| `livestream` | Show the settings button on the toolbar, and to configure virtual background, camera, microphone, and speaker devices, and see session quality statistics. |
| `users` | Show the users button on the toolbar, and to see the list of users in the session. |
| `pstn` | Show the invite by phone feature in the users interface. |
| `crc` | Show the invite by SIP feature in the users interface. |
| `ltt` | Show the Live Transcription button on the toolbar. The user can start transcription and hide or show the captions. |
| `recording` | Show the Cloud Recording button on the toolbar. |
| `settings` | Show the settings button on the toolbar, and to configure virtual background, camera, microphone, and speaker devices, and see session quality statistics. |
| `feedback` | Show the feedback flow after the session is left or ended. The user can rate the session (1-5 stars) and report feedback to Zoom. |

We also support setting specific properties for the Video SDK [init](https://marketplacefront.zoom.us/sdk/custom/web/interfaces/InitOptions.html), [audio](https://marketplacefront.zoom.us/sdk/custom/web/interfaces/AudioOption.html), [video](https://marketplacefront.zoom.us/sdk/custom/web/interfaces/CaptureVideoOption.html), and [share](https://marketplacefront.zoom.us/sdk/custom/web/interfaces/ScreenShareOption.html) options.

Expand Down
2 changes: 1 addition & 1 deletion dist/videosdk-ui-toolkit.css

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions dist/videosdk-ui-toolkit.js

Large diffs are not rendered by default.

13 changes: 13 additions & 0 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@zoom/videosdk-ui-toolkit",
"version": "1.12.1-1",
"version": "2.1.0-1",
"description": "The Zoom Video SDK UI toolkit is a prebuilt video chat user interface powered by the Zoom Video SDK.",
"main": "index.js",
"types": "index.d.ts",
Expand Down
File renamed without changes

0 comments on commit 1964394

Please sign in to comment.