Join room
End point: /room/getJoinToken
Request parameters
Field | Type | Required | Description |
---|---|---|---|
room_id | string | Yes | Room Id that you created before to join. |
user_info | string | Yes |
User info
Field | Type | Required | Description |
---|---|---|---|
name | string | Yes | User full name |
user_id | string | Yes | User unique ID. Should be unquie for every user. |
is_admin | boolean | Yes | If true then user will be treated as an admin for this room. |
is_hidden | boolean | No | If true then user will be invisible in the room. |
user_metadata | string | Yes |
User metadata
Field | Type | Required | Description |
---|---|---|---|
profile_pic | string | No | Profile avatar |
lock_settings | string | No | Lock settings |
Example
{
"room_id": "room01",
"user_info": {
"name": "Your name",
"user_id": "Your-Unique-User-Id",
"is_admin": true,
"is_hidden": false,
"user_metadata": {
"profile_pic": "https://profile.pic/im.jpg",
"lock_settings": {
"lock_microphone": false,
"lock_webcam": false,
"lock_screen_sharing": true,
"lock_chat": false,
"lock_chat_send_message": false,
"lock_chat_file_share": false
}
}
}
}
Response
Field | Type | Position | Description |
---|---|---|---|
status | boolean | root | The status of the request |
msg | string | root | Response message |
token | string | root | Join token |
When you'll receive token during that time you can pass that token to plugNmeet-client. If you've setup it with plugNmeet-server then:
https://Your-Plug-N-Meet-Server.com/?access_token=<TOKEN HERE>
If you are using plugNmeet-client build static files in somewhere else then you'll require to pass token like that too. For example you've uploaded build static files inside conference
directory. In this case:
https://Your-Domain.com/conference/?access_token=<TOKEN HERE>
Custom design
It's possible to add extra query parameter custom_design
with the join link. This way you can use seperate design for indivisual user. The value of custom_design
will need to be url encoded json value. You can view supported parameters from design-parameters. Example:
https://Your-Domain.com/conference/?access_token=<TOKEN HERE>&custom_design=%7B%22primary_color%22%3A%22%23004D90%22%2C%22secondary_color%22%3A%22%2324AEF7%22%7D