Air video

@get-air/video owns Air's platform-neutral video controller. Playback is explicit: applications select HTML directly or register a native adapter such as Tauri. The standalone @get-air/transcode package supplies the GStreamer fallback without coupling this browser package to a server runtime.

Playback backends

| Runtime | Backend | Playback path | | --- | --- | --- | | Browser and Smart TV | html, webos, or vizio | Platform <video> | | Samsung Tizen | tizen | AVPlay | | Tauri | tauri from @get-air/video-tauri | Native platform engine | | Browser fallback | transcode from @get-air/transcode | GStreamer HLS |

There is no automatic backend or client-side demux/decoder. Pass one backend ID or an explicit ordered fallback list:

import { createVideoClient } from '@get-air/video'
import { tauriVideoBackend } from '@get-air/video-tauri'
import { transcodeVideoBackend } from '@get-air/transcode/video'

const client = createVideoClient({
  adapters: [
    tauriVideoBackend(),
    transcodeVideoBackend({ client: transcode }),
  ],
})

const player = await client.attach(video, {
  source,
  backend: ['html', 'tauri', 'transcode'],
})

HTML must reach canplay and produce non-zero video dimensions. A failed backend advances only through the fallback IDs the caller explicitly supplied.

Install

npm install @get-air/video

Basic use

import { attachVideo } from '@get-air/video'

const player = await attachVideo(document.querySelector('video')!, {
  source: 'https://media.example/movie.mp4',
  backend: 'html',
  autoplay: true,
})

await player.seek(90)
await player.load('https://media.example/next.mp4')

Entrypoints

| Entrypoint | Purpose | | --- | --- | | @get-air/video | Promise-based DOM and TV API | | @get-air/video/effect | Effect services and typed errors | | @get-air/video/react | React player and TV focus | | @get-air/video/canvas | Framework-neutral canvas integration | | @get-air/video/solid | SolidTV helpers | | @get-air/video/blits | Blits helpers |

The Tauri adapter comes from @get-air/video-tauri. The transcode adapter comes from @get-air/transcode.

API · Platforms · Versioning · Contributing

MIT OR Apache-2.0