@gcorevideo/player 2.3.1 → 2.4.1

package/src/types.ts

@@ -1,3 +1,5 @@
+import { PlayerMediaSource } from "./internal.types"
+
 export type PlayerDebugTag = 'all' | 'clappr' | 'dash' | 'hls' | 'none'
 export type PlayerDebugSettings = PlayerDebugTag | boolean
 
@@ -21,6 +23,7 @@ export type PlayerConfig = {
   pluginSettings?: Record<string, unknown>
   poster?: string
   priorityTransport?: TransportPreference
+  sources: PlayerMediaSource[];
   strings: TranslationSettings
 }
 
@@ -104,8 +107,6 @@ export type QualityLevelInfo = {
   bitrate: number
 }
 
-export type BitrateInfo = QualityLevelInfo
-
 export enum PlayerEvent {
   Ready = 'ready',
   Play = 'play',

package/src/typings/@clappr/core/player.d.ts

@@ -1,73 +1,73 @@
 import "@clappr/core";
 
 declare module "@clappr/core" {
-    type MediacontrolStyles = {
-        // TODO
-    }
+    // type MediacontrolStyles = {
+    //     // TODO
+    // }
 
-    type PlayerMediaSourceDesc = {
-        mimeType?: string;
-        source: string;
-    }
+    // type PlayerMediaSourceDesc = {
+    //     mimeType?: string;
+    //     source: string;
+    // }
 
-    type PlayerMediaSource = string | PlayerMediaSourceDesc;
+    // type PlayerMediaSource = string | PlayerMediaSourceDesc;
 
-    type HlsjsConfig = {
-        debug?: boolean;
-        startLevel?: number;
-    } & Record<string, unknown>;
+    // type HlsjsConfig = {
+    //     debug?: boolean;
+    //     startLevel?: number;
+    // } & Record<string, unknown>;
 
-    type ShakaConfig = Record<string, unknown>;
+    // type ShakaConfig = Record<string, unknown>;
 
-    declare type CorePlaybackConfig = {
-        // audioOnly: boolean;
-        disableContextMenu?: boolean;
-        controls?: boolean;
-        crossOrigin?: 'anonymous' | 'use-credentials';
-        // enableAutomaticABR?: boolean;
-        externalTracks?: unknown[]; // TODO
-        hlsjsConfig?: HlsjsConfig;
-        // initialBandwidthEstimate?: number;
-        // maxBufferLength?: number;
-        // maxBackBufferLength?: number;
-        // minBufferLength?: number;
-        minimumDvrSize?: number; // TODO ?
-        // maxAdaptiveBitrate?: number;
-        // maxAdaptiveVideoDimensions?: unknown; // TODO
-        playInline: boolean;
-        preload?: 'metadata' | 'auto' | 'none';
-        // preferredTextLanguage?: string;
-        // preferredAudioLanguage?: string;
-        shakaConfiguration?: ShakaConfig;
-    }
+    // declare type CorePlaybackConfig = {
+    //     // audioOnly: boolean;
+    //     disableContextMenu?: boolean;
+    //     controls?: boolean;
+    //     crossOrigin?: 'anonymous' | 'use-credentials';
+    //     // enableAutomaticABR?: boolean;
+    //     externalTracks?: unknown[]; // TODO
+    //     hlsjsConfig?: HlsjsConfig;
+    //     // initialBandwidthEstimate?: number;
+    //     // maxBufferLength?: number;
+    //     // maxBackBufferLength?: number;
+    //     // minBufferLength?: number;
+    //     minimumDvrSize?: number; // TODO ?
+    //     // maxAdaptiveBitrate?: number;
+    //     // maxAdaptiveVideoDimensions?: unknown; // TODO
+    //     playInline: boolean;
+    //     preload?: 'metadata' | 'auto' | 'none';
+    //     // preferredTextLanguage?: string;
+    //     // preferredAudioLanguage?: string;
+    //     shakaConfiguration?: ShakaConfig;
+    // }
 
-    type ErrorLevel = "FATAL" | "WARN" | "INFO";
+    // type ErrorLevel = "FATAL" | "WARN" | "INFO";
 
-    declare type EventSpec = string;
-    declare type EventHandlerSpec = string;
-    declare type PluginEventsConfig = Record<EventSpec, EventHandlerSpec>;
+    // declare type EventSpec = string;
+    // declare type EventHandlerSpec = string;
+    // declare type PluginEventsConfig = Record<EventSpec, EventHandlerSpec>;
 
-    declare type PlaybackError = {
-        code?: number | string;
-        description: string;
-        raw?: MediaError;
-        level?: ErrorLevel;
-    }
+    // declare type PlaybackError = {
+    //     code?: number | string;
+    //     description: string;
+    //     raw?: MediaError;
+    //     level?: ErrorLevel;
+    // }
 
-    declare type CorePlayerEvents = {
-        // TODO event arguments types
-        onReady?: () => void;
-        onResize?: (data: { width: number; height: number }) => void;
-        onPlay?: (metadata: unknown) => void;
-        onPause?: (metadata: unknown) => void;
-        onStop?: (metadata: unknown) => void;
-        onEnded?: () => void;
-        onSeek?: (currentTime: number) => void;
-        onError?: (err: PlaybackError) => void;
-        onTimeUpdate?: (timeProgress: { current: number; total: number }) => void;
-        onVolumeUpdate?: (value: number) => void;
-        onSubtitleAvailable?: () => void;
-    }
+    // declare type CorePlayerEvents = {
+    //     // TODO event arguments types
+    //     onReady?: () => void;
+    //     onResize?: (data: { width: number; height: number }) => void;
+    //     onPlay?: (metadata: unknown) => void;
+    //     onPause?: (metadata: unknown) => void;
+    //     onStop?: (metadata: unknown) => void;
+    //     onEnded?: () => void;
+    //     onSeek?: (currentTime: number) => void;
+    //     onError?: (err: PlaybackError) => void;
+    //     onTimeUpdate?: (timeProgress: { current: number; total: number }) => void;
+    //     onVolumeUpdate?: (value: number) => void;
+    //     onSubtitleAvailable?: () => void;
+    // }
 
     declare type ClapprVersionSpec = {
         min: string;

package/src/utils/mediaSources.ts

@@ -0,0 +1,104 @@
+import { PlayerMediaSource } from '../internal.types'
+import DashPlayback from '../plugins/dash-playback/DashPlayback'
+import HlsPlayback from '../plugins/hls-playback/HlsPlayback'
+import { StreamMediaSource, TransportPreference } from '../types'
+
+export type SourceVariants = {
+  dash: string | null
+  master: string | null
+  hls: string | null
+  mpegts: string | null
+}
+
+export function buildSourcesSet(sources: PlayerMediaSource[]): SourceVariants {
+  const sv: SourceVariants = {
+    dash: null,
+    master: null,
+    hls: null,
+    mpegts: null,
+  }
+  sources.forEach((ps) => {
+    const [s, t] = typeof ps === 'string' ? [ps, ''] : [ps.source, ps.mimeType]
+    if (DashPlayback.canPlay(s, t)) {
+      sv.dash = s
+    } else if (HlsPlayback.canPlay(s, t)) {
+      sv.hls = s
+    } else {
+      sv.master = s
+    }
+  })
+  return sv
+}
+
+export function buildSourcesPriorityList(
+  sources: SourceVariants,
+  priorityTransport: TransportPreference = 'auto',
+): PlayerMediaSource[] {
+  const msl: string[] = []
+  switch (priorityTransport) {
+    case 'dash':
+      addDash()
+      break
+    case 'hls':
+      addHls()
+      break
+    case 'mpegts':
+      addMpegts()
+      break
+    case 'auto':
+      addDash()
+      addHls()
+      break
+  }
+  Object.values(sources).forEach((s) => {
+    if (s) {
+      msl.push(s)
+    }
+  })
+  return msl
+
+  function addMpegts() {
+    if (sources.mpegts) {
+      msl.push(sources.mpegts)
+      sources.mpegts = null
+    }
+  }
+
+  function addHls() {
+    if (sources.hls && HlsPlayback.canPlay(sources.hls)) {
+      msl.push(sources.hls)
+      sources.hls = null
+    }
+    if (
+      sources.master?.endsWith('.m3u8') &&
+      HlsPlayback.canPlay(sources.master)
+    ) {
+      msl.push(sources.master)
+      sources.master = null
+    }
+  }
+
+  function addDash() {
+    if (sources.dash && DashPlayback.canPlay(sources.dash)) {
+      msl.push(sources.dash)
+      sources.dash = null
+    }
+  }
+}
+
+export function unwrapSource(s: PlayerMediaSource): string {
+  return typeof s === 'string' ? s : s.source
+}
+
+export function buildGcoreStreamSourcesList(
+  ms: StreamMediaSource,
+  priorityTransport: TransportPreference,
+): PlayerMediaSource[] {
+  const sources: Record<'dash' | 'master' | 'hls' | 'mpegts', string | null> = {
+    dash: ms.sourceDash,
+    master: ms.source,
+    hls: ms.hlsCmafUrl,
+    mpegts: ms.hlsMpegtsUrl,
+  }
+  return buildSourcesPriorityList(sources, priorityTransport)
+}