|
4 | 4 |
|
5 | 5 | This plugin is one of the official bbb plugins. It basically decreases the external video's volume when a user is speaking in the meeting. |
6 | 6 |
|
7 | | -## Running the Plugin from Source |
8 | | - |
9 | | -1. Start the development server: |
10 | | - |
11 | | -```bash |
12 | | -cd src/plugin-decrease-volume-on-speak |
13 | | -npm install |
14 | | -npm start |
15 | | -``` |
16 | | - |
17 | | -2. Add reference to it on BigBlueButton's `settings.yml` or `/etc/bigbluebutton/bbb-html5.yml`: |
18 | | - |
19 | | -```yaml |
20 | | - plugins: |
21 | | - - name: DecreaseVolumeOnSpeak |
22 | | - url: http://127.0.0.1:4701/static/DecreaseVolumeOnSpeak.js |
23 | | -``` |
24 | 7 |
|
25 | 8 | ## Building the Plugin |
26 | 9 |
|
27 | 10 | To build the plugin for production use, follow these steps: |
28 | 11 |
|
29 | 12 | ```bash |
30 | | -cd src/plugin-decrease-volume-on-speak |
| 13 | +cd $HOME/src/plugin-decrease-volume-on-speak |
31 | 14 | npm ci |
32 | 15 | npm run build-bundle |
33 | 16 | ``` |
34 | 17 |
|
35 | | -The above command will generate the `dist` folder, containing the bundled JavaScript file named `DecreaseVolumeOnSpeak.js`. This file can be hosted on any HTTPS server. |
| 18 | +The above commands will generate the `dist` folder, containing the bundled JavaScript file named `DecreaseVolumeOnSpeak.js`. This file can be hosted on any HTTPS server along with its `manifest.json`. |
| 19 | + |
| 20 | +If you install the plugin separated from the manifest, remember to change the `javascriptEntrypointUrl` in the `manifest.json` to the correct endpoint. |
36 | 21 |
|
37 | | -To use the plugin with BigBlueButton, add the plugin's URL to `settings.yml` as shown below: |
| 22 | +To use the plugin in BigBlueButton, send this parameter along in create call: |
38 | 23 |
|
39 | | -```yaml |
40 | | -public: |
41 | | - app: |
42 | | - ... // All app configurations |
43 | | - plugins: |
44 | | - - name: DecreaseVolumeOnSpeak |
45 | | - url: <<PLUGIN_URL>> |
46 | | - ... // All other configurations |
47 | 24 | ``` |
| 25 | +pluginManifests=[{"url":"<your-domain>/path/to/manifest.json"}] |
| 26 | +``` |
| 27 | + |
| 28 | +Or additionally, you can add this same configuration in the `.properties` file from `bbb-web` in `/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties` |
| 29 | + |
| 30 | + |
| 31 | +## Development mode |
48 | 32 |
|
49 | | -Alternatively, you can host the bundled file on the BigBlueButton server by copying `dist/DecreaseVolumeOnSpeak.js` to the folder `/var/www/bigbluebutton-default/assets/plugins`. In this case, the `<<PLUGIN_URL>>` will be `https://<your-host>/plugins/DecreaseVolumeOnSpeak.js`. |
| 33 | +As for development mode (running this plugin from source), please, refer back to https://github.com/bigbluebutton/bigbluebutton-html-plugin-sdk section `Running the Plugin from Source` |
0 commit comments