Production Truck: NDI camera joystick

NDI camera joystick

Adds direct NDI PTZ control from an on-screen touch/mouse pad and compatible USB/gamepad joysticks. This uses NDI receiver PTZ pan/tilt-speed and zoom-speed functions through the installed native NDI runtime. It does not crop the OBS picture or translate commands to VISCA/ONVIF. Connect controls discovers the selected configured NDI sender by exact name; ambiguous names are rejected. A metadata-only receiver avoids a second full video feed. The sender must be connected and advertise NDI PTZ support before movement is accepted.

Open PTZ / Camera PTZ, select its camera card and choose Connect controls. Drag and hold the pad for pan/tilt; hold zoom +/− for zoom. Release to send stop; STOP disables USB movement too. Start at low speed and verify directions. For USB, press a joystick button so the browser detects it, open USB joystick, choose the device and axis/hold-button indices, then Enable USB movement. Center all mapped axes and release the hold button before the first movement. Hold the configured button to move; release to stop. Axis indices start at zero; −1 disables an axis. Axis inversion and speed are adjustable. Generic HID devices exposed by the browser Gamepad API are supported; proprietary serial controllers are not automatically mapped. Movement is never enabled automatically at startup.

Only one camera/session per app is controlled. Changing selection stops and disconnects the old camera. Selecting a different Program camera does not retarget the joystick. Commands are sequenced so late moves cannot override a later stop; movement updates have one pending request per browser session. Touch cancellation, pointer/keyboard release, lost browser focus, hidden tabs and USB removal stop motion while retaining the selected USB device and camera connection. Movement resumes only after valid input returns, the mapped sticks center and the hold button is released. STOP explicitly disables USB movement; Disconnect releases the camera. An app-owned watchdog requests stop after approximately 0.5 seconds without a fresh move. Closing the application releases its receiver. These are best-effort network commands: app crashes or lost camera connectivity can prevent stop delivery; use the camera's own controls if needed. No independent service or worker is added.

The selector lists only direct NDI cameras mapped on this truck. Configure their NDI sender in Camera setup. Shared kiosk relay feeds are excluded because they are not direct NDI camera senders. Hub assignment refresh closes joystick control; source/event changes invalidate a prior session. Existing local station authorization and Workstation application entitlements still apply.

NDI API reference: https://docs.ndi.video/all/developing-with-ndi/sdk/ndi-recv