This page lists the typical scenarios for connecting your website or app users with voice and video, along with how you can implement each scenario using the Videola.io Embed API and mobile SDKs.
This scenario is typical for websites that connect customers with service providers (e.g. students with teachers, patients with doctors etc.) The arrangement is as follows:
https://www.learningconnect.com
.tyvqxln2uw4b
.https://www.learningconnect.com/video-call?room=tyvqxln2uw4b
.The first step in implementing this scenario is to place the Videola.io embed on a page on your website, and then add the JavaScript code to make the embed automatically join the room passed in the page’s URL. Here is how to do it:
https://www.learningconnect.com/video-call
) that will hold the embed.room
GET parameter (so the URL emailed to the users will be https://www.learningconnect.com/video-call?room=tyvqxln2uw4b
), implement a way to pass the value of the parameter to the JavaScript code you have running on the page. It could be passing the parameter value from your server side, or parsing the URL query string with JavaScript directly on the page.ready
event, make the embed start the call automatically as follows:
1 2 3 4 5 6 |
embed.on("ready", function(e) { // Start a video call once the Gruveo widget has loaded. // The below assumes that the "room" variable contains // the room name to join. embed.call(room, true); }); |
https://www.learningconnect.com/video-call?room=tyvqxln2uw4b
URL in two tabs of your browser. You should get connected with yourself in the Videola.io embed.The final step is to implement the generation of the random Videola.io room name when a call is booked on your website. This is as simple as generating a random alphanumeric string of sufficient length (12 characters or more is recommended). You do not need to “register” or “create” the room with Videola.io beforehand as the rooms come into existence automatically when someone joins them. Randomizing the room name provides a sufficient degree of protection from unwanted users joining the call by pure chance.
Instead of passing the Videola.io room name in the URL, you may be passing the booking ID instead and then pulling the room name for the booking from the database, or fetching the booking’s room name in some other way. This scenario can also be extended to connecting your users in a custom iOS or Android app using the Videola.io mobile SDKs.
In this advanced scenario, your app users can call each other directly. Behind the scenes, your app generates a random Videola.io room name for each call to connect the users. Here is how it works:
generateRandomCode()
helper function in the Android SDK.Note that in this scenario, the necessary signaling (i.e. the exchange of messages between the users’ app instances) is left to your implementation.