HOWTO / Feature Request: Dynamic Room Creation

[DamonOehlman]

I can see that for the plugins that have a concept of rooms that rooms are configured in relevant plugin configuration file, with the room id being identified in an INI file section.

Is there any plans to support dynamic room creation through the API. Or alternatively something similar to the way nginx uses the HUP signal to trigger a reload of configuration files?

I'm fine with either way :)

[meetecho]

That's definitely planned! The plugins that are available now are mostly proof of concepts, and so there's definitely room for improvement. Adding a further message to create rooms, for instance, would be quite trivial.

A dynamic approach is what we're aiming at for all plugins. The idea I have of the streaming plugin, for instance, is something like icecast where you can dynamically allocate a mountpoint and stream to it. I'll keep you posted on updates in that direction.

[meetecho]

Hi Damon,

I just commited a change that adds a new "create" request to the API of both the Audio Bridge and Video MCU plugins. There are no hooks in the demo examples yet, but I did a quick test and they behave as expected. The syntax of the plugin messages is quite simple and mirrors what can be configured in the INI:

Audio Bridge
{
"request" : "create",
"description" : "My awesome room",
"sampling" : 16000,
"record" : false
}

Video Room:
{
"request" : "create",
"description" : "My awesome videoroom",
"bitrate" : 256000,
"publishers" : 3
}

The only mandatory field in both messages is the request: if the other ones are missing, defaults are used. The response messages in both cases contain a "room" field with the newly created numeric ID.

Let me know if they work for you.

[DamonOehlman]

Awesome - thanks mate. Will check it out tomorrow :)

[DamonOehlman]

@meetecho Works fantastically. I've added some tests (for the audiobridge plugin at least) to in the rtc-janus module that I'm currently working on:

https://github.com/rtc-io/rtc-janus/blob/master/test/audiobridge.js

[meetecho]

@DamonOehlman that's amazing! I'm looking forward to your efforts myself as soon as I can!

[warrenjmcdonald]

@DamonOehlman you beat me to this question. @meetecho Thank you. This will make testing a proof of concept for audio recording quite easy. Looking forward to working with you both on this.

Warren

[meetecho]

Hi Warren,

just FYI, the Audio Bridge plugin already has a rough recording mechanism in place. Right now, if enabled (record=yes in the configuration, record=true in the API create request), the mixed audio for each room is saved as an uncompressed WAV in /tmp. The VoiceMail plugin also has a way to record the incoming audio stream to an .opus file instead, something that we'll extend to video and add to the Video MCIU plugin as well in the future.

Hope that helps!

[Will-I4M]

is there any "destroy" associated command we can use ?
thanks for your reply.

[benwtrent]

yes, you can reference the video room and destroy it through a synchronous command.

[Ajmal1990]

Can I able to create a room with a specific name like "room 1" ? What is the latest status of dynamic room creation and destroying? No mentions in the docs?

[cacheworks]

@Ajmal1990
Yes you can, as described in this comment, just change the description;
#2 (comment)

The videoroom plugin API requests are mentioned here; https://janus.conf.meetecho.com/docs/janus__videoroom_8c.html#sfuapi