Preview

Displays video and audio streams in real-time for monitoring via WebRTC, JPEG or MoQ (WebTransport)

Component Configuration

Option Description Required

id

A unique identifier for the component instance

displayName

The name shown in the Studio UI of this component

previewMode

How to display the video. MoQ requires the global MoQ Preview listener (cert + key) to be configured. The browser must trust the cert (real CA, or use serveFingerprint with a self-signed cert via mkcert). (default: "image")

showPreview

Show video preview (default: true)

jitterBuffer

Configure the buffer to smooth outgoing data. Leave empty to use global latency profile default. (default: {})

notes

Additional notes about this component

Jitter Buffer

Option Description Required

bufferDelayMs

How many milliseconds in the jitter buffer. Leave empty to use the global latency profile default.

Global Configuration

Ice Servers

Option Description Required

url

URL of the STUN/TURN server (with turn:/stun: prefix) as accessed by Norsk Studio

reportedUrl

Optional URL of the STUN/TURN server as accessed by the client (if different to the above)

username

Optional username

credential

Optional password

Moq Preview

Option Description Required

quicServerPort

QUIC listener port for native MoQT subscribers (optional — only needed for non-browser clients)

webTransportPort

WebTransport listener port for browser MoQ players. Defaults to 4443. Override via GLOBAL_MOQ_PREVIEW_WEBTRANSPORTPORT env var. (default: 4443)

quicServerCert

TLS certificate file path. If omitted, a self-signed cert is auto-generated (14-day validity, rotated every 10 days).

quicServerKey

TLS private key file path. If omitted, auto-generated alongside the cert.

serveFingerprint

Publishes the cert SHA-256 so the moq-js player can trust it via WebTransport's serverCertificateHashes. Defaults on. (default: true)

Tags: preview monitor webrtc jpeg moq webtransport