VDO.Ninja Developer API Sandbox

// HTTP GET API Example
function sendHTTPRequest(apiID, action, target = "null", value = "null") {
  // Construct URL
  const url = `https://api.vdo.ninja/${apiID}/${action}/${target}/${value}`;
  
  // Send request
  fetch(url)
    .then(response => {
      if (!response.ok) {
        throw new Error(`HTTP error! Status: ${response.status}`);
      }
      return response.text();
    })
    .then(data => {
      // Handle response (could be text or JSON)
      try {
        const jsonData = JSON.parse(data);
        console.log("Response JSON:", jsonData);
      } catch (e) {
        console.log("Response text:", data);
      }
    })
    .catch(error => {
      console.error("Error:", error);
    });
}

// Usage examples:
// sendHTTPRequest("YOUR_API_ID", "mic", "null", "toggle");
// sendHTTPRequest("YOUR_API_ID", "camera", "null", "false");
// sendHTTPRequest("YOUR_API_ID", "joinGroup", "null", "1");

// Camera control examples (relative adjustments only via HTTP):
// sendHTTPRequest("YOUR_API_ID", "zoom", "null", "0.1");    // Zoom in 10%
// sendHTTPRequest("YOUR_API_ID", "zoom", "null", "-0.1");   // Zoom out 10%
// sendHTTPRequest("YOUR_API_ID", "pan", "null", "-0.1");    // Pan left 10%
// sendHTTPRequest("YOUR_API_ID", "focus", "null", "0.1");   // Focus far 10%

// For directors targeting a specific guest
// sendHTTPRequest("YOUR_API_ID", "mic", "1", "toggle");     // Target guest in slot 1
// sendHTTPRequest("YOUR_API_ID", "ptzZoom", "2", "0.1");    // Zoom guest 2's camera in

// Server-Sent Events (SSE) Example
function connectToSSE(apiID) {
  // Create EventSource connection
  const eventSource = new EventSource(`https://api.vdo.ninja/sse/${apiID}`);
  
  // Connection opened
  eventSource.onopen = function() {
    console.log("SSE connection established");
  };
  
  // Listen for messages
  eventSource.onmessage = function(event) {
    try {
      const data = JSON.parse(event.data);
      console.log("SSE event:", data);
      
      // Handle different types of events
      if (data.type === "state_update") {
        // Handle state updates
        updateUI(data.state);
      } else if (data.type === "guest_joined") {
        // Handle guest joining
        console.log(`Guest joined: ${data.guestID}`);
      }
      // Add more event handlers as needed
      
    } catch (e) {
      console.error("Error parsing SSE event:", e);
    }
  };
  
  // Handle errors
  eventSource.onerror = function(error) {
    console.error("SSE connection error:", error);
    
    // Close connection
    eventSource.close();
    
    // Implement reconnection logic
    setTimeout(() => {
      console.log("Attempting to reconnect SSE...");
      connectToSSE(apiID);
    }, 3000);
  };
  
  // Return EventSource instance (for later disconnection if needed)
  return eventSource;
}

// Usage:
// const sseConnection = connectToSSE("YOUR_API_ID");
// 
// // To disconnect later:
// // sseConnection.close();

// HTTP POST API Example
function sendPOSTRequest(apiID, data) {
  // Construct URL
  const url = `https://api.vdo.ninja/${apiID}`;
  
  // Configure request
  const options = {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
  };
  
  // Send request
  fetch(url, options)
    .then(response => {
      if (!response.ok) {
        throw new Error(`HTTP error! Status: ${response.status}`);
      }
      return response.json();
    })
    .then(data => {
      console.log("Response:", data);
    })
    .catch(error => {
      console.error("Error:", error);
    });
}

// Usage examples:
// sendPOSTRequest("YOUR_API_ID", {
//   action: "mic",
//   value: "toggle"
// });
//
// Camera control with absolute positioning:
// sendPOSTRequest("YOUR_API_ID", {
//   action: "zoom",
//   value: 0.75,
//   value2: "abs"  // Sets zoom to exactly 75%
// });
//
// Camera control with relative adjustments:
// sendPOSTRequest("YOUR_API_ID", {
//   action: "pan",
//   value: -0.1    // Pan left by 10%
// });
//
// sendPOSTRequest("YOUR_API_ID", {
//   action: "layout",
//   value: [
//     {"x":0,"y":0,"w":50,"h":100,"slot":0},
//     {"x":50,"y":0,"w":50,"h":100,"slot":1}
//   ]
// });
//
// For directors targeting a specific guest:
// sendPOSTRequest("YOUR_API_ID", {
//   action: "ptzZoom",
//   target: "2", 
//   value: 0.1     // Zoom in guest 2's camera by 10%
// });

// Camera Control (PTZ) Example
function sendCameraCommand(apiID, action, value, value2 = null, target = null) {
  // Using WebSocket (preferred for responsive camera control)
  if (socket && socket.readyState === WebSocket.OPEN) {
    const command = { action, value };
    if (value2 !== null) command.value2 = value2;
    if (target !== null) command.target = target;
    
    socket.send(JSON.stringify(command));
  } 
  // Using HTTP POST (supports all features including value2)
  else {
    const url = `https://api.vdo.ninja/${apiID}`;
    const data = { action, value };
    if (value2 !== null) data.value2 = value2;
    if (target !== null) data.target = target;
    
    fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data)
    })
    .then(response => response.json())
    .then(data => console.log("Response:", data))
    .catch(error => console.error("Error:", error));
  }
}

// RELATIVE ADJUSTMENTS (change from current position)
// sendCameraCommand("YOUR_API_ID", "zoom", 0.1);        // Zoom in by 10%
// sendCameraCommand("YOUR_API_ID", "zoom", -0.1);       // Zoom out by 10%
// sendCameraCommand("YOUR_API_ID", "focus", 0.1);       // Focus farther by 10%
// sendCameraCommand("YOUR_API_ID", "focus", -0.1);      // Focus nearer by 10%
// sendCameraCommand("YOUR_API_ID", "pan", -0.1);        // Pan left by 10%
// sendCameraCommand("YOUR_API_ID", "pan", 0.1);         // Pan right by 10%
// sendCameraCommand("YOUR_API_ID", "tilt", 0.1);        // Tilt up by 10%
// sendCameraCommand("YOUR_API_ID", "tilt", -0.1);       // Tilt down by 10%
// sendCameraCommand("YOUR_API_ID", "exposure", 0.1);    // Increase exposure by 10%
// sendCameraCommand("YOUR_API_ID", "exposure", -0.1);   // Decrease exposure by 10%

// ABSOLUTE POSITIONING (set to exact values)
// sendCameraCommand("YOUR_API_ID", "zoom", 1.5, "abs");      // Set zoom to 1.5x
// sendCameraCommand("YOUR_API_ID", "focus", 0.75, "abs");    // Set focus to 75%
// sendCameraCommand("YOUR_API_ID", "pan", 0, "abs");         // Center pan
// sendCameraCommand("YOUR_API_ID", "pan", -0.5, "abs");      // Pan 50% left
// sendCameraCommand("YOUR_API_ID", "tilt", 0.25, "abs");     // Tilt 25% up
// sendCameraCommand("YOUR_API_ID", "exposure", 0.8, "abs");  // Set exposure to 80%

// Camera presets using absolute positioning
function setCameraPreset(preset) {
  switch(preset) {
    case 1: // Center position
      sendCameraCommand("YOUR_API_ID", "zoom", 1.0, "abs");
      sendCameraCommand("YOUR_API_ID", "pan", 0, "abs");
      sendCameraCommand("YOUR_API_ID", "tilt", 0, "abs");
      break;
    case 2: // Wide shot
      sendCameraCommand("YOUR_API_ID", "zoom", 0.5, "abs");
      sendCameraCommand("YOUR_API_ID", "pan", 0, "abs");
      sendCameraCommand("YOUR_API_ID", "tilt", 0, "abs");
      break;
    case 3: // Close-up
      sendCameraCommand("YOUR_API_ID", "zoom", 2.0, "abs");
      sendCameraCommand("YOUR_API_ID", "pan", 0, "abs");
      sendCameraCommand("YOUR_API_ID", "tilt", 0, "abs");
      break;
  }
}

// Targeting a specific guest's camera (for directors)
// sendCameraCommand("YOUR_API_ID", "ptzZoom", 0.1, null, "2");    // Zoom guest 2's camera in
// sendCameraCommand("YOUR_API_ID", "ptzPan", -0.5, "abs", "1");   // Set guest 1's pan to 50% left
// Note: guest-targeted exposure is not currently part of the director targetGuest API.

// MIDI Integration Example
function initializeMIDI() {
  // Check if Web MIDI API is supported
  if (!navigator.requestMIDIAccess) {
    console.error("Web MIDI API not supported in this browser");
    return Promise.reject("MIDI not supported");
  }
  
  // Request MIDI access
  return navigator.requestMIDIAccess({ sysex: false })
    .then(midiAccess => {
      console.log("MIDI Access granted");
      
      // Get MIDI inputs
      const inputs = midiAccess.inputs.values();
      const devices = [];
      
      // Setup devices
      for (let input = inputs.next(); input && !input.done; input = inputs.next()) {
        devices.push(input.value);
        setupMIDIDevice(input.value);
      }
      
      // Listen for device connection/disconnection
      midiAccess.onstatechange = function(e) {
        console.log("MIDI state change:", e.port.name, e.port.state);
      };
      
      return { midiAccess, devices };
    })
    .catch(error => {
      console.error("Failed to get MIDI access:", error);
      throw error;
    });
}

function setupMIDIDevice(inputDevice) {
  // Set up MIDI message handler
  inputDevice.onmidimessage = function(message) {
    // Extract MIDI data
    const command = message.data[0];
    const note = message.data[1];
    const velocity = message.data[2];
    
    console.log(`MIDI message - Command: ${command}, Note: ${note}, Velocity: ${velocity}`);
    
    // Handle Note On messages (144 = Note On, channel 1)
    if (command === 144 && velocity > 0) {
      handleNoteOn(note, velocity);
    }
    // Handle Note Off messages (128 = Note Off, channel 1)
    else if (command === 128 || (command === 144 && velocity === 0)) {
      handleNoteOff(note);
    }
    // Handle Control Change messages (176 = CC, channel 1)
    else if (command === 176) {
      handleControlChange(note, velocity);
    }
  };
}

function handleControlChange(cc, value) {
  // Map control change messages to actions
  
  // CC110 - Advanced commands
  if (cc === 110) {
    switch(value) {
      case 20: sendCommand("zoom", 0.1); break;           // Zoom in
      case 21: sendCommand("zoom", -0.1); break;          // Zoom out
      case 22: sendCommand("pan", -0.1); break;           // Pan left
      case 23: sendCommand("pan", 0.1); break;            // Pan right
      case 24: sendCommand("tilt", 0.1); break;           // Tilt up
      case 25: sendCommand("tilt", -0.1); break;          // Tilt down
      case 26: sendCommand("exposure", 0.1); break;       // Exposure up
      case 27: sendCommand("exposure", -0.1); break;      // Exposure down
      case 28: sendCommand("focus", -0.1); break;         // Focus near
      case 29: sendCommand("focus", 0.1); break;          // Focus far
      case 30: // Camera preset 1
        sendCommand("zoom", 1.0, "abs");
        sendCommand("pan", 0, "abs");
        sendCommand("tilt", 0, "abs");
        break;
      // Add more CC110 values as needed
    }
  }
  // CC80-84: Absolute camera controls
  else if (cc >= 80 && cc <= 84) {
    const normalizedValue = value / 127; // 0-1 range
    
    switch(cc) {
      case 80: // Zoom absolute (0-127 maps to 0-2x zoom)
        sendCommand("zoom", normalizedValue * 2, "abs");
        break;
      case 81: // Pan absolute (0-127 maps to -1 to +1)
        sendCommand("pan", (normalizedValue * 2) - 1, "abs");
        break;
      case 82: // Tilt absolute (0-127 maps to -1 to +1)
        sendCommand("tilt", (normalizedValue * 2) - 1, "abs");
        break;
      case 83: // Exposure absolute (0-127 maps to 0-1)
        sendCommand("exposure", normalizedValue, "abs");
        break;
      case 84: // Focus absolute (0-127 maps to 0-1)
        sendCommand("focus", normalizedValue, "abs");
        break;
    }
  }
}

// Helper function to convert MIDI note number to note name
function getNoteNameFromNumber(noteNumber) {
  const notes = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
  const octave = Math.floor(noteNumber / 12) - 1;
  const noteName = notes[noteNumber % 12];
  return noteName + octave;
}

// Usage:
// initializeMIDI()
//   .then(midi => console.log("MIDI ready with devices:", midi.devices))
//   .catch(error => console.error("MIDI setup failed:", error));

// Guest Control Example (Director Mode)
function controlGuest(apiID, target, action, value = null, value2 = null, method = "websocket") {
  if (method === "websocket") {
    // WebSocket method (supports all features including value2)
    if (socket && socket.readyState === WebSocket.OPEN) {
      const msg = {
        target: target,
        action: action
      };
      
      if (value !== null) msg.value = value;
      if (value2 !== null) msg.value2 = value2;
      
      socket.send(JSON.stringify(msg));
      console.log("Sent guest command via WebSocket:", msg);
    } else {
      console.error("WebSocket not connected");
    }
  } else if (method === "http") {
    // HTTP method (limited - no value2 support)
    const targetStr = target || "null";
    const valueStr = value !== null ? value : "null";
    const url = `https://api.vdo.ninja/${apiID}/${action}/${targetStr}/${valueStr}`;
    
    fetch(url)
      .then(response => response.text())
      .then(data => console.log("Guest command response:", data))
      .catch(error => console.error("Error sending guest command:", error));
  }
}

// Basic guest control examples:
// controlGuest("YOUR_API_ID", "1", "mic", "toggle");      // Toggle mic for guest 1
// controlGuest("YOUR_API_ID", "2", "camera", false);      // Turn off camera for guest 2
// controlGuest("YOUR_API_ID", "3", "addScene", 1);        // Add guest 3 to scene 1
// controlGuest("YOUR_API_ID", "1", "sendDirectorChat", "You're live in 10 seconds");
// controlGuest("YOUR_API_ID", "2", "volume", 85);         // Set guest 2 volume to 85%
// controlGuest("YOUR_API_ID", "1", "rotate", true);       // Rotate guest 1 video by +90 degrees
// controlGuest("YOUR_API_ID", "1", "rotate", 180);        // Set guest 1 rotation explicitly
// controlGuest("YOUR_API_ID", "4", "forward", "room123"); // Transfer guest 4 to room123

// Camera/PTZ control for specific guests:
// Relative adjustments
// controlGuest("YOUR_API_ID", "1", "ptzZoom", 0.1);           // Zoom guest 1's camera in by 10%
// controlGuest("YOUR_API_ID", "2", "ptzPan", -0.1);           // Pan guest 2's camera left by 10%
// controlGuest("YOUR_API_ID", "3", "ptzFocus", 0.1);          // Focus guest 3's camera farther
// controlGuest("YOUR_API_ID", "4", "ptzAutofocus", "manual"); // Disable guest 4 autofocus

// Absolute positioning (WebSocket or HTTP POST)
// controlGuest("YOUR_API_ID", "1", "ptzZoom", 1.5, "abs");    // Set guest 1's zoom to 1.5x
// controlGuest("YOUR_API_ID", "2", "ptzPan", 0, "abs");       // Center guest 2's pan
// controlGuest("YOUR_API_ID", "3", "ptzTilt", -0.25, "abs");  // Tilt guest 3's camera 25% down
// controlGuest("YOUR_API_ID", "4", "requestResolution", "1280x720"); // Request 720p preview

// Camera Control Value Ranges:
// zoom: Relative -1 to 1, Absolute 0 to 2 (0=minimum zoom, 2=2x zoom)
// focus: Relative -1 to 1, Absolute 0 to 1 (0=near, 1=far)
// pan: Always absolute -1 to 1 (-1=left, 0=center, 1=right)
// tilt: Relative -1 to 1, Absolute -1 to 1 (-1=down, 0=center, 1=up)
// exposure: Relative -1 to 1, Absolute 0 to 1 (0=dark, 1=bright)

// WebSocket Examples:
// Relative: {"action": "zoom", "value": 0.1}                    // Zoom in 10%
// Absolute: {"action": "zoom", "value": 1.5, "value2": "abs"}   // Set zoom to 1.5x

// HTTP POST Examples:
// Relative: POST body: {"action": "focus", "value": -0.1}
// Absolute: POST body: {"action": "exposure", "value": 0.8, "value2": "abs"}

// Note: HTTP GET only supports relative adjustments

// Single layout example
{
  "action": "layout",
  "value": [
    {"x": 0, "y": 0, "w": 50, "h": 100, "slot": 0},
    {"x": 50, "y": 0, "w": 50, "h": 100, "slot": 1}
  ]
}

// Using URL parameter to define multiple layouts
// ?layouts=[[{"x":0,"y":0,"w":100,"h":100,"slot":0}],[{"x":0,"y":0,"w":50,"h":100,"slot":0},{"x":50,"y":0,"w":50,"h":100,"slot":1}]]

// Layout properties:
// x, y: Position (percentage of container)
// w, h: Width and height (percentage of container)
// slot: Guest slot number (0-indexed)
// c: Crop to fit (true/false)
// z: Z-index (layer)

// To switch layouts:
// {"action": "layout", "value": 0} // Auto-mix
// {"action": "layout", "value": 1} // First custom layout
// {"action": "layout", "value": 2} // Second custom layout