Interface VinylOptions

Configuration for the default adaptive bitrate selector.

Allow list restricting which media content types ('audio', 'video') are streamed. When set, only streams whose content type is in the list are created; all other media streams are ignored. For example, ['audio'] streams audio but never video. Changing this reloads the track using only the allowed content types. Null (the default) means no restriction (all available media content types are streamed).

Text tracks (subtitles / closed captions) are not affected by this allow list; they are governed by caption selection and always remain available.

Audio (language / audio-description) configuration. See AudioOptions.

The default is { selection: { language: null, descriptive: false } }: audio is ordered by the platform's navigator.languages and audio-description renditions are excluded. Set selection.language to prefer specific language(s) and selection.descriptive to true to opt into described audio.

Explicit codec allow/deny overrides that bypass browser support detection. Keys are RFC 6381 codec strings or prefixes (e.g. "hvc1"), values are 'allow' or 'deny'. An 'allow' forces a codec to be treated as supported; a 'deny' forces it to be treated as unsupported. Empty by default (support is determined solely by the browser and the known-false-report list).

Text-track (subtitles / closed captions) configuration: enable/disable and the selection criteria. See TextTrackControllerOptions.

The default is { enabled: 'forced' }: with no explicit language, the platform's navigator.languages are preferred, showing only forced (narrative) tracks. Set enabled to 'on' for full subtitle tracks or 'off' to render nothing; selection.language/selection.id choose a specific rendition.