API Reference

npm install semantic-streaming-sdk

import { SemanticStreamingSDK } from 'semantic-streaming-sdk';
const sdk = new SemanticStreamingSDK({ licenseKey: 'ss_live_your_key' });

yourPlayer.onSkip((skip) => {
  const decision = sdk.analyzeSkip({
    duration: skip.seconds,
    currentQuality: skip.quality,
    platform: 'web'
  });
  if (decision.action === 'adjust_quality')
    yourPlayer.setQuality(decision.toQuality);
});

X-API-Key: ss_live_your_api_key_here

// Works with hls.js — real CDN quality switching
const hls = new Hls();
hls.loadSource(videoUrl);
hls.attachMedia(video);

const sdk = new SemanticStreamingSDK({ licenseKey: 'ss_live_your_key' });

video.addEventListener('seeked', async () => {
  const duration = Math.abs(video.currentTime - lastTime);
  if (duration >= 2.0) {
    const decision = await sdk.analyzeSkip({ duration, currentQuality: '1080p' });
    if (decision.action === 'adjust_quality') {
      hls.currentLevel = findLevel(decision.toQuality); // REAL switch
      setTimeout(() => hls.currentLevel = -1, 2000); // restore
    }
  }
});

import { HTML5VideoIntegration } from 'semantic-streaming-sdk';
const optimizer = new HTML5VideoIntegration(videoElement, { minQuality: '360p' });
optimizer.on('savingsCalculated', (d) => console.log(`Saved ${d.savings.savedMB} MB`));

import { useRef, useEffect } from 'react';
import { HTML5VideoIntegration } from 'semantic-streaming-sdk';

function OptimizedPlayer({ src }) {
  const ref = useRef();
  useEffect(() => {
    const opt = new HTML5VideoIntegration(ref.current);
    return () => opt.destroy();
  }, []);
  return <video ref={ref} src={src} controls />;
}