Currently designing a plug-in for Q-SYS (REST via Lua) to query a room for available cameras and switch between them. I can currently do this with the found camera IDs, but need to be able to query the room for which camera/mic/speaker is currently selected / in-use, which will inform visual feedback and which camera’s set of controls gets selected downstream.
Is this currently possible using the ZR API?
Hi @bstrelko
Thanks for reaching out to us!
Here is the link to our docs where you will find all the Zoom Room APIs
I could not find one that help you find your needs but I might not bee understanding your use case.
Please take a look and let me know
Sure, @elisa.zoom - happy to illustrate further.
We’re building a Q-SYS plugin for Zoom Rooms control of a few heavily-used functions in a large space. A master User Control Interface is being built in Q-SYS, which will include native Q-SYS DSP controls (gain control of mics upstream, mutes, control of other 3rd party devices in the space, etc.)
One of the functions we are looking to implement is ZR camera switching (asking the Zoom Room to switch camera feeds - a mix of USB and NDI). We would like to show the controls for the currently selected camera in the same user interface, which requires accurate feedback from the Zoom Room on which camera is currently selected. Without this piece of information, the User Control Interface’s assumed selected camera and the Zoom Room’s [actual] selected camera could go out of sync, resulting in lack of control (or even control of the wrong camera).
We would like to be able to poll the Zoom Room to make sure Q-SYS is aware of which camera is currently ‘on the air’ so that we can inform Q-SYS which camera controls to provide in our UI. We’d also use this feedback to confirm that commands sent to switch cameras have fully taken effect (verify that camera requested via API call is now reporting as the selected camera).
This source of truth would also allow us to provide text fields when the plugin loads and connects to the ZR. Current Camera, Current Mic, Current Speaker, etc.
I had reviewed the Rooms API documentation thoroughly several times before posting here and was not able to find any call that could return currently active/selected A/V devices, only a list of available devices, which is less helpful here.
Please let me know if further clarification is needed - thanks!
Hi @bstrelko
Thanks for the detailed response, I do not think we have an endpoint to help you achieve what you are looking for.
I will reach out to a colleague to see if they have more insight about this
1 Like
Hey @bstrelko
I was able to get in touch with one of our Engineers and they confirmed that there is no mechanism in the current API set to do exactly what you want to do.
The best suggestion we can offer is that you intentionally set the device to use a particular camera by ID at the start of a call, so your are at least beginning using a known value.
But the current “Get device information” API does not, as you noted, include indication of which camera is currently active/selected
This is unfortunate, and the uni-directional ‘workaround’ doesn’t solve the issue of requesting real-time feedback if someone in the room changes the camera from a ZRC in-call… BUT, thank you for officially confirming the lack of functionality so that we can move on.
We will explore the ZRC SDK and see if this is better suited for designing a modern AV integration within the constraints of the Zoom development ecosystem.
1 Like
Of course, always happy to help!