Troubleshooting | Ramped Gain Controls in Zoom Room UCI Panels
This article addresses an issue where gain ramp controls in Zoom Rooms UCI panels behave unpredictably.
Affected Products
Hardware Model/Series |
n/a / Varies |
Software |
Q-SYS Control for Zoom Rooms Application |
Problem | Symptoms
Specific to gain controls. When using WebUI-based UCIs in Zoom Rooms, ramped gain controls may change level multiple steps for a single press of the up/down button on certain touch controllers.
-
A single press on a ramped gain Up or Down button may:
- Increase/decrease the gain by more than one step
-
Frequency:
- Intermittent, but “fairly frequent” in some deployments
-
Pattern:
- May appear more noticeable when multiple gain controls exist on the same UCI layer/page
Although this can feel like a “runaway” or overly sensitive volume control, it is not planned to be fixed in an upcoming software version.
Instead, this behavior is treated as a limitation of the interaction between:
- The HTML UCI viewer used by Zoom Rooms (and other web/touch environments), and
- the performance and input characteristics of certain touch controllers, which can vary across third-party Zoom Rooms controllers
Cause
This is considered a limitation of HTML‑based UCI viewers rendering within Zoom Rooms rather than a software defect. It is primarily driven by latency in receiving the mouse/touch “up” event when using HTML viewer environments:
- Standard browsers and HTML UCI viewers can deliver slightly different timing than dedicated UCI viewers.
- On certain devices, additional processing delay can make the effect more noticeable.
- The gain ramp logic is timing-based; small timing delays can make a “tap” behave more like a short “press-and-hold,” resulting in multiple increments.
Solution | Workaround
Summary: The recommended approach is to tune the gain component timing parameters for the specific controller hardware and, where appropriate, adjust the UCI design to avoid press‑and‑hold behavior. Adjusting the Gain ramp timing parameters is the most effective mitigation.
Recommended starting point (general guidance):
- Hold Off Time: 1.0 s
- Time: 3.0 s
These values were specifically recommended during investigation as a broadly effective baseline for touch/HTML environments. You may need to tune further depending on controller model and responsiveness.
Steps
- Open your design in Q-SYS Designer.
- Locate the Gain component used by the ramped up/down control.
-
Adjust:
- Hold Off Time → set to 1.0 seconds (starting recommendation)
- Time → set to 3.0 seconds (starting recommendation)
- Save, deploy, and test on the target Zoom Rooms controller.
Tuning guidance
- If single taps still jump multiple steps → increase Hold Time slightly.
- If ramp feels too slow when intentionally holding → reduce Time slightly (carefully), and re-test.