Getting Started
The CamDirector® MultiShot module (AV-CD-MSHOT1) allows automatic switching between multiple camera angles using predefined presets. This is ideal for lecture capture and streaming environments.
- Ensure the CamDirector® software is installed and updated to the latest version.
- Connect all PTZ cameras via IP and confirm each camera has unique, reachable IP settings within the same subnet.
- Verify that the system supports multicast and latency is kept below 250ms per camera feed.
- Assign presets to all cameras before enabling MultiShot mode. Each camera must have at least one preset stored.
- Use only the CamDirector web interface or supported API calls to activate the MultiShot switching logic.
TABLE OF CONTENTS
- Getting Started
- Overview of MultiShot Mode
- Web Interface Configuration
- REST API Integration
- Integration with TeacherTracker
- Limitations and Requirements
- Troubleshooting
Overview of MultiShot Mode
The MultiShot mode enables CamDirector to automatically cut or fade between up to four different camera presets based on configured timing. This creates a dynamic multi-angle production using fixed PTZ camera locations.
Supported Hardware
- Up to 4 Avonic PTZ cameras connected via IP
- Optional: CamDirector TeacherTracker for advanced trigger logic
Preset Configuration
Each camera can store multiple presets. MultiShot mode requires one preset per camera to be assigned to the switching sequence.
- Presets must be configured manually before activation.
- Each camera must be uniquely identifiable (Cam1, Cam2, etc.).
- Switching order is defined by preset input index (1–4).
Timing and Transition Settings
Each preset switch can be customized using:
- Delay: Time before switching to the next preset.
- Cut/Fade: Transition type between shots.
- Looping: Whether the sequence repeats automatically.
Web Interface Configuration
Access the MultiShot settings via the CamDirector GUI:
- Navigate to
http://<camdirector_ip>/camdirector
- Enable MultiShot under the ‘Modes’ tab
- Assign camera inputs and presets in the MultiShot settings panel
Example Settings Panel
This interface allows you to define:
- Input number (camera index)
- Preset number to recall
- Duration of shot
- Transition type
REST API Integration
The MultiShot feature can be externally triggered or modified using HTTP GET requests. This allows for seamless integration with production tools like OBS.
Basic API Command
http://<ip_address>/camdirector/ms/set?input=1
Where input
corresponds to the preset slot (1–4). Optional parameters:
cut=true
orcut=false
delay=5000
(milliseconds before next switch)
Use Case: OBS Scene Switching
Combine OBS WebSocket with CamDirector API calls to align scenes and presets. Use delay settings to time transitions smoothly.
Integration with TeacherTracker
MultiShot can be used alongside the TeacherTracker module to enhance the switching logic:
- Trigger MultiShot when the teacher is detected in a predefined zone
- Pause switching during board writing or inactivity
- Resume when the teacher returns to the podium
Zone-Triggered Switching
TeacherTracker provides trigger conditions which can start or stop the MultiShot sequence dynamically based on teacher movement.
Limitations and Requirements
- Maximum latency per camera input: 250ms
- MultiShot supports only IP-based camera control
- VISCA is not supported for switching presets
- Only 4 inputs are allowed in the MultiShot loop
Known Issues
- Switching delays below 2000ms may cause overlapping transitions
- Cut/fade timing may vary depending on network jitter
Troubleshooting
- Ensure all cameras respond to HTTP preset recall before enabling MultiShot
- Use the diagnostic log in CamDirector GUI to confirm switching triggers
- When API commands fail, check firewall settings and IP access lists
- .