@videojs/html 10.0.0-beta.30 → 10.0.0-beta.31

package/docs/reference/hlsjs-video.md

@@ -298,6 +298,632 @@ Read-only.
 
 Also exposes these properties from the native media API. See [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement) for details: `autoplay``buffered``controls``crossOrigin``currentSrc``currentTime``defaultMuted``defaultPlaybackRate``disablePictureInPicture``disableRemotePlayback``duration``ended``loop``muted``paused``playbackRate``played``playsInline``poster``readyState``remote``seekable``seeking``textTracks``title``videoHeight``videoWidth``volume`
 
+### Engine options
+
+#### `source.engine.hlsJs`
+
+Pass hls.js’s own configuration here. It’s handed to hls.js untouched, so every option in its [config reference](https://github.com/video-dev/hls.js/blob/master/docs/API.md#fine-tuning) works, spelled the way hls.js spells it. [Media Sources](../concepts/media-sources.md) covers how engine options fit into a structured source.
+
+The names and types below come from hls.js’s own type definitions, so they tell you what exists and what shape it takes. hls.js documents what each one does; the descriptions are theirs to write, and most are blank here because its types carry none.
+
+ts
+
+```
+const video = document.querySelector('hlsjs-video');
+video.source = {
+  src: 'https://example.com/playlist.m3u8',
+  engine: { hlsJs: { maxBufferLength: 30, lowLatencyMode: true } },
+};
+```
+
+Option
+
+Type
+
+Details
+
+`abrBandWidthFactor`
+
+`number`
+
+`abrBandWidthUpFactor`
+
+`number`
+
+`abrController`
+
+`typeof AbrController`
+
+`abrEwmaDefaultEstimate`
+
+`number`
+
+▸
+
+Description
+
+Default bandwidth estimate in bits/s prior to collecting fragment bandwidth samples
+
+`abrEwmaDefaultEstimateMax`
+
+`number`
+
+`abrEwmaFastLive`
+
+`number`
+
+`abrEwmaFastVoD`
+
+`number`
+
+`abrEwmaSlowLive`
+
+`number`
+
+`abrEwmaSlowVoD`
+
+`number`
+
+`abrMaxWithRealBitrate`
+
+`boolean`
+
+`appendErrorMaxRetry`
+
+`number`
+
+`assetPlayerId`
+
+`string`
+
+`audioPreference`
+
+`AudioSelectionOption`
+
+`audioStreamController`
+
+`typeof AudioStreamController`
+
+`audioTrackController`
+
+`typeof AudioTrackController`
+
+`autoStartLoad`
+
+`boolean`
+
+`backBufferLength`
+
+`number`
+
+`bufferController`
+
+`typeof BufferController`
+
+`capLevelController`
+
+`typeof CapLevelController`
+
+`capLevelOnFPSDrop`
+
+`boolean`
+
+`capLevelToPlayerSize`
+
+`boolean`
+
+`captionsTextTrack1Label`
+
+`string`
+
+`captionsTextTrack1LanguageCode`
+
+`string`
+
+`captionsTextTrack2Label`
+
+`string`
+
+`captionsTextTrack2LanguageCode`
+
+`string`
+
+`captionsTextTrack3Label`
+
+`string`
+
+`captionsTextTrack3LanguageCode`
+
+`string`
+
+`captionsTextTrack4Label`
+
+`string`
+
+`captionsTextTrack4LanguageCode`
+
+`string`
+
+`certLoadPolicy`
+
+`LoadPolicy`
+
+`cmcd`
+
+`CMCDControllerConfig`
+
+`cmcdController`
+
+`typeof CMCDController`
+
+`contentSteeringController`
+
+`typeof ContentSteeringController`
+
+`cueHandler`
+
+`CuesInterface`
+
+`debug`
+
+`boolean | ILogger`
+
+`defaultAudioCodec`
+
+`string`
+
+`detectStallWithCurrentTimeMs`
+
+`number`
+
+`drmSystemOptions`
+
+`DRMSystemOptions | undefined`
+
+`drmSystems`
+
+`Partial<Record<KeySystems, DRMSystemC...`
+
+▸
+
+Type
+
+`Partial<Record<KeySystems, DRMSystemConfiguration>> | undefined`
+
+`emeController`
+
+`typeof EMEController`
+
+`emeEnabled`
+
+`boolean`
+
+`enableCEA708Captions`
+
+`boolean`
+
+`enableDateRangeMetadataCues`
+
+`boolean`
+
+`enableEmsgKLVMetadata`
+
+`boolean`
+
+`enableEmsgMetadataCues`
+
+`boolean`
+
+`enableID3MetadataCues`
+
+`boolean`
+
+`enableIMSC1`
+
+`boolean`
+
+`enableInterstitialPlayback`
+
+`boolean`
+
+`enableSoftwareAES`
+
+`boolean`
+
+`enableWebVTT`
+
+`boolean`
+
+`enableWorker`
+
+`boolean`
+
+`errorController`
+
+`typeof ErrorController`
+
+`fetchSetup`
+
+`function`
+
+▸
+
+Type
+
+`(context: LoaderContext, initParams: any) => Request | Promise<Request>`
+
+`fLoader`
+
+`FragmentLoaderConstructor`
+
+`forceKeyFrameOnDiscontinuity`
+
+`boolean`
+
+`fpsController`
+
+`typeof FPSController`
+
+`fpsDroppedMonitoringPeriod`
+
+`number`
+
+`fpsDroppedMonitoringThreshold`
+
+`number`
+
+`fragLoadingMaxRetry`
+
+`number`
+
+`fragLoadingMaxRetryTimeout`
+
+`number`
+
+`fragLoadingRetryDelay`
+
+`number`
+
+`fragLoadingTimeOut`
+
+`number`
+
+`fragLoadPolicy`
+
+`LoadPolicy`
+
+`frontBufferFlushThreshold`
+
+`number`
+
+`highBufferWatchdogPeriod`
+
+`number`
+
+`ignoreDevicePixelRatio`
+
+`boolean`
+
+`ignorePlaylistParsingErrors`
+
+`boolean`
+
+`initialLiveManifestSize`
+
+`number`
+
+`interstitialAppendInPlace`
+
+`boolean`
+
+`interstitialAssetListLoadPolicy`
+
+`LoadPolicy`
+
+`interstitialLiveLookAhead`
+
+`number`
+
+`interstitialsController`
+
+`typeof InterstitialsController`
+
+`keyLoadPolicy`
+
+`LoadPolicy`
+
+`levelLoadingMaxRetry`
+
+`number`
+
+`levelLoadingMaxRetryTimeout`
+
+`number`
+
+`levelLoadingRetryDelay`
+
+`number`
+
+`levelLoadingTimeOut`
+
+`number`
+
+`licenseResponseCallback`
+
+`function`
+
+▸
+
+Type
+
+`(this: Hls, xhr: XMLHttpRequest, url: string, keyContext: MediaKeySessionContext) => ArrayBuffer`
+
+`licenseXhrSetup`
+
+`function`
+
+▸
+
+Type
+
+`(this: Hls, xhr: XMLHttpRequest, url: string, keyContext: MediaKeySessionContext, licenseChallenge: Uint8Array<ArrayBufferLike>) => void | ... 1 more ... | Promise<...>`
+
+`liveBackBufferLength`
+
+`number | null`
+
+`liveDurationInfinity`
+
+`boolean`
+
+`liveMaxLatencyDuration`
+
+`number`
+
+`liveMaxLatencyDurationCount`
+
+`number`
+
+`liveSyncDuration`
+
+`number`
+
+`liveSyncDurationCount`
+
+`number`
+
+`liveSyncMode`
+
+`"buffered" | "edge"`
+
+`liveSyncOnStallIncrease`
+
+`number`
+
+`loader`
+
+`function`
+
+▸
+
+Type
+
+`new (confg: HlsConfig) => Loader<LoaderContext>`
+
+`lowLatencyMode`
+
+`boolean`
+
+`manifestLoadingMaxRetry`
+
+`number`
+
+`manifestLoadingMaxRetryTimeout`
+
+`number`
+
+`manifestLoadingRetryDelay`
+
+`number`
+
+`manifestLoadingTimeOut`
+
+`number`
+
+`manifestLoadPolicy`
+
+`LoadPolicy`
+
+`maxAudioFramesDrift`
+
+`number`
+
+`maxBufferHole`
+
+`number`
+
+`maxBufferLength`
+
+`number`
+
+`maxBufferSize`
+
+`number`
+
+`maxDevicePixelRatio`
+
+`number`
+
+`maxFragLookUpTolerance`
+
+`number`
+
+`maxLiveSyncPlaybackRate`
+
+`number`
+
+`maxLoadingDelay`
+
+`number`
+
+`maxMaxBufferLength`
+
+`number`
+
+`maxStarvationDelay`
+
+`number`
+
+`minAutoBitrate`
+
+`number`
+
+`nudgeMaxRetry`
+
+`number`
+
+`nudgeOffset`
+
+`number`
+
+`nudgeOnVideoHole`
+
+`boolean`
+
+`playlistLoadPolicy`
+
+`LoadPolicy`
+
+`pLoader`
+
+`PlaylistLoaderConstructor`
+
+`preferManagedMediaSource`
+
+`boolean`
+
+`preserveManualLevelOnError`
+
+`boolean`
+
+`primarySessionId`
+
+`string`
+
+`progressive`
+
+`boolean`
+
+`renderTextTracksNatively`
+
+`boolean`
+
+`requestMediaKeySystemAccessFunc`
+
+`MediaKeyFunc | null`
+
+`requireKeySystemAccessOnStart`
+
+`boolean`
+
+`startFragPrefetch`
+
+`boolean`
+
+`startLevel`
+
+`number`
+
+`startOnSegmentBoundary`
+
+`boolean`
+
+`startPosition`
+
+`number`
+
+`steeringManifestLoadPolicy`
+
+`LoadPolicy`
+
+`stretchShortVideoTrack`
+
+`boolean`
+
+`subtitlePreference`
+
+`SubtitleSelectionOption`
+
+`subtitleStreamController`
+
+`typeof SubtitleStreamController`
+
+`subtitleTrackController`
+
+`typeof SubtitleTrackController`
+
+`testBandwidth`
+
+`boolean`
+
+`timelineController`
+
+`typeof TimelineController`
+
+`timelineOffset`
+
+`number`
+
+`useMediaCapabilities`
+
+`boolean`
+
+`videoPreference`
+
+`VideoSelectionOption`
+
+`widevineLicenseUrl`
+
+`string`
+
+`workerPath`
+
+`string | null`
+
+`xhrSetup`
+
+`function`
+
+▸
+
+Type
+
+`(xhr: XMLHttpRequest, url: string) => void | Promise<void>`
+
+#### `source.engine.nativeHls`
+
+When playback falls back to the browser’s own HLS, hls.js isn’t involved and its options don’t apply. This configures that path instead.
+
+Option
+
+Type
+
+Details
+
+`drmSystems`
+
+`Partial<Record<KeySystem, DrmSystemCo...`
+
+▸
+
+Description
+
+License servers for protected content, keyed by EME key system id. An escape hatch for licensing native playback differently from every other path: naming it replaces `source.drm` here, and nowhere else.
+
+Type
+
+`Partial<Record<KeySystem, DrmSystemConfig>> | undefined`
+
 ### Methods
 
 Supports these media methods. See [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement) for details: `addTextTrack``canPlayType``exitFullscreen``exitPictureInPicture``load``pause``play``requestFullscreen``requestPictureInPicture`

package/docs/reference/native-hls-video.md

@@ -252,6 +252,46 @@ Read-only.
 
 Also exposes these properties from the native media API. See [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement) for details: `autoplay``buffered``controls``crossOrigin``currentSrc``currentTime``defaultMuted``defaultPlaybackRate``disablePictureInPicture``disableRemotePlayback``duration``ended``loop``muted``paused``playbackRate``played``playsInline``poster``readyState``remote``seekable``seeking``textTracks``title``videoHeight``videoWidth``volume`
 
+### Engine options
+
+#### `source.engine.nativeHls`
+
+This element hands playback to the browser, so there’s no JavaScript engine to configure. This carries the one thing native playback still needs from you. [Media Sources](../concepts/media-sources.md) covers how engine options fit into a structured source.
+
+ts
+
+```
+const video = document.querySelector('native-hls-video');
+video.source = {
+  src: 'https://example.com/playlist.m3u8',
+  engine: {
+    nativeHls: {
+      drmSystems: { 'com.apple.fps': { licenseUrl: 'https://example.com/license' } },
+    },
+  },
+};
+```
+
+Option
+
+Type
+
+Details
+
+`drmSystems`
+
+`Partial<Record<KeySystem, DrmSystemCo...`
+
+▸
+
+Description
+
+License servers for protected content, keyed by EME key system id. An escape hatch for licensing native playback differently from every other path: naming it replaces `source.drm` here, and nowhere else.
+
+Type
+
+`Partial<Record<KeySystem, DrmSystemConfig>> | undefined`
+
 ### Methods
 
 Supports these media methods. See [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement) for details: `addTextTrack``canPlayType``exitFullscreen``exitPictureInPicture``load``pause``play``requestFullscreen``requestPictureInPicture`