Class HSVideo

Bridge type for working with video playback in JavaScript HSVideo wraps an AVQueuePlayer and can be embedded in an hs.ui.window via .video(), or driven entirely from JavaScript with play(), pause(), seek(), loop(), and volume.

Loading Video

Each entry may be a local file path (~ is expanded) or a remote URL string. Multiple entries are queued and play back to back, in order.

// A single local file
const clip = HSVideo.fromURLs(["~/Movies/clip.mp4"])

// A playlist mixing a local file and a remote stream
const playlist = HSVideo.fromURLs(["~/Movies/intro.mp4", "https://example.com/video.mp4"])
Copy

Playback Control

const clip = HSVideo.fromURLs(["~/Movies/clip.mp4"])
clip.volume = 0.5
clip.loop(true)
clip.play()
// ... later ...
clip.seek(30)
clip.pause()
Copy

Looping

Gapless looping (via AVPlayerLooper) is only supported when the playlist contains a single URL. Calling loop(true) on a multi-URL playlist has no effect (the playlist just plays through once) and logs a warning.