@codenkay/video-nsgplayer-ui 3.0.0 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +21 -0
- package/README.md +11 -0
- package/dist/index.cjs +283 -30
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +77 -5
- package/dist/index.d.ts +77 -5
- package/dist/index.js +276 -29
- package/dist/index.js.map +1 -1
- package/dist/player-ui.css +9 -2
- package/package.json +16 -6
- package/styles.css +462 -0
package/dist/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as react from 'react';
|
|
2
2
|
import { CSSProperties, RefObject, ReactNode } from 'react';
|
|
3
|
-
import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, VideoPlayer, PlayerConfig, PlaybackRate, HlsQualityLevel, QualitySelection, PlayerTextTrack, TextTrackSelection, PlayerAudioTrack, PlayIconPreset as PlayIconPreset$1 } from '@codenkay/video-nsgplayer-core';
|
|
3
|
+
import { AuthConfig, PlaybackCredentialConfig, mergePlayerConfig, AnalyticsConfig, VideoPlayer, PlayerConfig, PlaybackRate, HlsQualityLevel, QualitySelection, PlayerTextTrack, TextTrackSelection, PlayerAudioTrack, PlayIconPreset as PlayIconPreset$1 } from '@codenkay/video-nsgplayer-core';
|
|
4
4
|
|
|
5
5
|
type NsgVideoPlayerWithControlsProps = {
|
|
6
6
|
videoId: string;
|
|
@@ -8,6 +8,7 @@ type NsgVideoPlayerWithControlsProps = {
|
|
|
8
8
|
playback?: PlaybackCredentialConfig;
|
|
9
9
|
sourceUrl?: string;
|
|
10
10
|
config?: Parameters<typeof mergePlayerConfig>[0];
|
|
11
|
+
analytics?: AnalyticsConfig;
|
|
11
12
|
className?: string;
|
|
12
13
|
style?: CSSProperties;
|
|
13
14
|
onWatchTime?: (time: number) => void;
|
|
@@ -19,12 +20,18 @@ type NsgVideoPlayerWithControlsProps = {
|
|
|
19
20
|
}) => void;
|
|
20
21
|
onPlay?: () => void;
|
|
21
22
|
onPause?: () => void;
|
|
23
|
+
onAuthError?: (error: {
|
|
24
|
+
message: string;
|
|
25
|
+
retryable: boolean;
|
|
26
|
+
}) => void;
|
|
27
|
+
/** Optional seek-bar hover preview image URL for a given media time. */
|
|
28
|
+
getSeekPreview?: (time: number) => string | null | undefined;
|
|
22
29
|
};
|
|
23
30
|
/**
|
|
24
31
|
* Full player with control chrome (seek, quality, speed, live, zoom, keyboard).
|
|
25
32
|
* Does not use native `<video controls>`.
|
|
26
33
|
*/
|
|
27
|
-
declare
|
|
34
|
+
declare const NsgVideoPlayerWithControls: react.ForwardRefExoticComponent<NsgVideoPlayerWithControlsProps & react.RefAttributes<VideoPlayer>>;
|
|
28
35
|
|
|
29
36
|
type PlayerChromeProps = {
|
|
30
37
|
player: VideoPlayer | null;
|
|
@@ -32,12 +39,13 @@ type PlayerChromeProps = {
|
|
|
32
39
|
containerRef: RefObject<HTMLElement | null>;
|
|
33
40
|
videoSlot: ReactNode;
|
|
34
41
|
className?: string;
|
|
42
|
+
getSeekPreview?: (time: number) => string | null | undefined;
|
|
35
43
|
};
|
|
36
44
|
/**
|
|
37
45
|
* Control shell over an already-mounted video (children / videoSlot).
|
|
38
46
|
* Zoom is UI-only via CSS transform.
|
|
39
47
|
*/
|
|
40
|
-
declare function PlayerChrome({ player, config, containerRef, videoSlot, className, }: PlayerChromeProps): react.JSX.Element;
|
|
48
|
+
declare function PlayerChrome({ player, config, containerRef, videoSlot, className, getSeekPreview, }: PlayerChromeProps): react.JSX.Element;
|
|
41
49
|
|
|
42
50
|
declare function formatPlaybackTime(seconds: number): string;
|
|
43
51
|
declare function resolveVisiblePlaybackRates(count: number): PlaybackRate[];
|
|
@@ -87,6 +95,7 @@ type PlayerControlBarProps = {
|
|
|
87
95
|
onZoomIn: () => void;
|
|
88
96
|
onZoomOut: () => void;
|
|
89
97
|
seekBarRef?: RefObject<HTMLInputElement | null>;
|
|
98
|
+
getSeekPreview?: (time: number) => string | null | undefined;
|
|
90
99
|
};
|
|
91
100
|
declare function PlayerControlBar(props: PlayerControlBarProps): react.JSX.Element;
|
|
92
101
|
|
|
@@ -145,12 +154,13 @@ declare function PlaybackSpeedSelector({ rate, speedOptionCount, onSelect, }: {
|
|
|
145
154
|
onSelect: (rate: PlaybackRate) => void;
|
|
146
155
|
}): react.JSX.Element;
|
|
147
156
|
|
|
148
|
-
declare function SeekBar({ currentTime, duration, bufferedEnd, onSeek, seekInputRef, }: {
|
|
157
|
+
declare function SeekBar({ currentTime, duration, bufferedEnd, onSeek, seekInputRef, getSeekPreview, }: {
|
|
149
158
|
currentTime: number;
|
|
150
159
|
duration: number;
|
|
151
160
|
bufferedEnd: number;
|
|
152
161
|
onSeek: (time: number) => void;
|
|
153
162
|
seekInputRef?: RefObject<HTMLInputElement | null> | RefObject<HTMLInputElement>;
|
|
163
|
+
getSeekPreview?: (time: number) => string | null | undefined;
|
|
154
164
|
}): react.JSX.Element;
|
|
155
165
|
|
|
156
166
|
declare function TextTrackSelector({ tracks, selection, onSelect, }: {
|
|
@@ -203,4 +213,66 @@ declare function PlayIconPreset({ preset, size, }: {
|
|
|
203
213
|
size?: number;
|
|
204
214
|
}): react.JSX.Element;
|
|
205
215
|
|
|
206
|
-
|
|
216
|
+
type WatermarkPosition = {
|
|
217
|
+
topPct: number;
|
|
218
|
+
leftPct: number;
|
|
219
|
+
};
|
|
220
|
+
/**
|
|
221
|
+
* Random on-player position within safe margins (percent of container).
|
|
222
|
+
*/
|
|
223
|
+
declare function randomWatermarkPosition(random?: () => number): WatermarkPosition;
|
|
224
|
+
/**
|
|
225
|
+
* Random delay in `[0, maxMs]` for the gap between watermark appearances.
|
|
226
|
+
*/
|
|
227
|
+
declare function randomWatermarkDelay(maxMs: number, random?: () => number): number;
|
|
228
|
+
/**
|
|
229
|
+
* Random delay before the first watermark show after playback is ready.
|
|
230
|
+
*/
|
|
231
|
+
declare function randomFirstShowDelay(random?: () => number): number;
|
|
232
|
+
|
|
233
|
+
type StoredQualityPreference = "auto" | {
|
|
234
|
+
height: number;
|
|
235
|
+
};
|
|
236
|
+
declare const QUALITY_PREFERENCE_STORAGE_KEY = "nsg-player:quality-preference";
|
|
237
|
+
/**
|
|
238
|
+
* Reads the stored quality preference from localStorage.
|
|
239
|
+
* Returns `"auto"` when missing, invalid, or unavailable (SSR).
|
|
240
|
+
*/
|
|
241
|
+
declare function readQualityPreference(): StoredQualityPreference;
|
|
242
|
+
/**
|
|
243
|
+
* Persists quality preference. Stores `"auto"` or `{ height }` only.
|
|
244
|
+
*/
|
|
245
|
+
declare function writeQualityPreference(preference: StoredQualityPreference): void;
|
|
246
|
+
/**
|
|
247
|
+
* Maps a stored preference onto available levels.
|
|
248
|
+
* Missing height → `"auto"` (preference is kept in storage for later videos).
|
|
249
|
+
*/
|
|
250
|
+
declare function matchQualityPreference(preference: StoredQualityPreference, levels: Array<{
|
|
251
|
+
index: number;
|
|
252
|
+
height: number;
|
|
253
|
+
}>): "auto" | number;
|
|
254
|
+
/**
|
|
255
|
+
* Builds a preference payload from the user's runtime selection.
|
|
256
|
+
*/
|
|
257
|
+
declare function preferenceFromSelection(selection: "auto" | number, levels: Array<{
|
|
258
|
+
index: number;
|
|
259
|
+
height: number;
|
|
260
|
+
}>): StoredQualityPreference;
|
|
261
|
+
|
|
262
|
+
type PlaybackWatermarkState = WatermarkPosition & {
|
|
263
|
+
visible: boolean;
|
|
264
|
+
};
|
|
265
|
+
/**
|
|
266
|
+
* Schedules intermittent anti-leak watermark appearances while playback is active.
|
|
267
|
+
* When `reducedMotion` is true, shows a fixed-position watermark continuously.
|
|
268
|
+
*/
|
|
269
|
+
declare function usePlaybackWatermark({ enabled, label, active, durationMs, intervalMaxMs, reducedMotion, }: {
|
|
270
|
+
enabled: boolean;
|
|
271
|
+
label: string | null;
|
|
272
|
+
active: boolean;
|
|
273
|
+
durationMs: number;
|
|
274
|
+
intervalMaxMs: number;
|
|
275
|
+
reducedMotion?: boolean;
|
|
276
|
+
}): PlaybackWatermarkState;
|
|
277
|
+
|
|
278
|
+
export { AudioTrackSelector, LiveBadgeButton, NsgVideoPlayerWithControls, type NsgVideoPlayerWithControlsProps, PlayIconPreset, PlaybackSpeedSelector, type PlaybackWatermarkState, PlayerCenterOverlay, PlayerChrome, type PlayerChromeProps, PlayerControlBar, type PlayerControlBarProps, PlayerMenu, PlayerMenuItem, type PlayerOverlayKind, PlayerSkipCue, type PlayerZoomLevel, QUALITY_PREFERENCE_STORAGE_KEY, QualitySelector, SeekBar, type StoredQualityPreference, TextTrackSelector, type UsePlayerControlsOptions, type UsePlayerControlsResult, type WatermarkPosition, ZOOM_STEPS, formatPlaybackTime, matchQualityPreference, nextZoom, preferenceFromSelection, randomFirstShowDelay, randomWatermarkDelay, randomWatermarkPosition, readQualityPreference, resolvePlayerOverlay, resolveVisiblePlaybackRates, snapPlaybackRate, usePlaybackWatermark, usePlayerControls, writeQualityPreference };
|
package/dist/index.js
CHANGED
|
@@ -1,8 +1,12 @@
|
|
|
1
|
+
"use client";
|
|
2
|
+
|
|
1
3
|
// src/NsgVideoPlayerWithControls.tsx
|
|
2
4
|
import {
|
|
3
|
-
|
|
5
|
+
forwardRef,
|
|
6
|
+
useEffect as useEffect7,
|
|
7
|
+
useImperativeHandle,
|
|
4
8
|
useMemo as useMemo2,
|
|
5
|
-
useRef as
|
|
9
|
+
useRef as useRef6
|
|
6
10
|
} from "react";
|
|
7
11
|
import {
|
|
8
12
|
mergePlayerConfig,
|
|
@@ -86,6 +90,62 @@ function nextZoom(current, direction) {
|
|
|
86
90
|
return ZOOM_STEPS[next] ?? 1;
|
|
87
91
|
}
|
|
88
92
|
|
|
93
|
+
// src/utils/qualityPreference.ts
|
|
94
|
+
var QUALITY_PREFERENCE_STORAGE_KEY = "nsg-player:quality-preference";
|
|
95
|
+
function readQualityPreference() {
|
|
96
|
+
if (typeof window === "undefined" || !window.localStorage) {
|
|
97
|
+
return "auto";
|
|
98
|
+
}
|
|
99
|
+
try {
|
|
100
|
+
const raw = window.localStorage.getItem(QUALITY_PREFERENCE_STORAGE_KEY);
|
|
101
|
+
if (!raw) {
|
|
102
|
+
return "auto";
|
|
103
|
+
}
|
|
104
|
+
if (raw === "auto") {
|
|
105
|
+
return "auto";
|
|
106
|
+
}
|
|
107
|
+
const parsed = JSON.parse(raw);
|
|
108
|
+
if (parsed && typeof parsed === "object" && "height" in parsed && typeof parsed.height === "number" && Number.isFinite(parsed.height) && parsed.height > 0) {
|
|
109
|
+
return { height: parsed.height };
|
|
110
|
+
}
|
|
111
|
+
} catch {
|
|
112
|
+
}
|
|
113
|
+
return "auto";
|
|
114
|
+
}
|
|
115
|
+
function writeQualityPreference(preference) {
|
|
116
|
+
if (typeof window === "undefined" || !window.localStorage) {
|
|
117
|
+
return;
|
|
118
|
+
}
|
|
119
|
+
try {
|
|
120
|
+
if (preference === "auto") {
|
|
121
|
+
window.localStorage.setItem(QUALITY_PREFERENCE_STORAGE_KEY, "auto");
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
124
|
+
window.localStorage.setItem(
|
|
125
|
+
QUALITY_PREFERENCE_STORAGE_KEY,
|
|
126
|
+
JSON.stringify({ height: preference.height })
|
|
127
|
+
);
|
|
128
|
+
} catch {
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
function matchQualityPreference(preference, levels) {
|
|
132
|
+
if (preference === "auto" || levels.length === 0) {
|
|
133
|
+
return "auto";
|
|
134
|
+
}
|
|
135
|
+
const match = levels.find((level) => level.height === preference.height);
|
|
136
|
+
return match ? match.index : "auto";
|
|
137
|
+
}
|
|
138
|
+
function preferenceFromSelection(selection, levels) {
|
|
139
|
+
if (selection === "auto") {
|
|
140
|
+
return "auto";
|
|
141
|
+
}
|
|
142
|
+
const level = levels.find((item) => item.index === selection);
|
|
143
|
+
if (!level || level.height <= 0) {
|
|
144
|
+
return "auto";
|
|
145
|
+
}
|
|
146
|
+
return { height: level.height };
|
|
147
|
+
}
|
|
148
|
+
|
|
89
149
|
// src/hooks/usePlayerControls.ts
|
|
90
150
|
function usePlayerControls(options) {
|
|
91
151
|
const { player, config, containerRef } = options;
|
|
@@ -113,16 +173,31 @@ function usePlayerControls(options) {
|
|
|
113
173
|
useEffect(() => {
|
|
114
174
|
setZoom(config.player.defaultZoom || 1);
|
|
115
175
|
}, [config.player.defaultZoom]);
|
|
176
|
+
useEffect(() => {
|
|
177
|
+
setVolumeState(config.player.volume);
|
|
178
|
+
setMuted(config.player.startMuted);
|
|
179
|
+
}, [config.player.volume, config.player.startMuted]);
|
|
116
180
|
useEffect(() => {
|
|
117
181
|
if (!player) return;
|
|
118
182
|
if (containerRef?.current) {
|
|
119
183
|
player.setFullscreenElement(containerRef.current);
|
|
120
184
|
}
|
|
121
185
|
const syncTracks = () => {
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
186
|
+
const levels = player.getAvailableQualities();
|
|
187
|
+
setQualities(levels);
|
|
188
|
+
let selection = player.getQuality();
|
|
189
|
+
if (config.controls.persistQualityPreference && levels.length > 0) {
|
|
190
|
+
const preferred = matchQualityPreference(
|
|
191
|
+
readQualityPreference(),
|
|
192
|
+
levels
|
|
193
|
+
);
|
|
194
|
+
if (preferred !== selection) {
|
|
195
|
+
player.setQuality(preferred);
|
|
196
|
+
selection = preferred;
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
setQualitySelection(selection);
|
|
200
|
+
setActiveLevel(typeof selection === "number" ? selection : -1);
|
|
126
201
|
setTextTracks(player.getTextTracks());
|
|
127
202
|
setSelectedTextTrack(player.getSelectedTextTrack());
|
|
128
203
|
setAudioTracks(player.getAudioTracks());
|
|
@@ -131,7 +206,12 @@ function usePlayerControls(options) {
|
|
|
131
206
|
setAtLiveEdge(player.isAtLiveEdge());
|
|
132
207
|
setVolumeState(player.getVolume());
|
|
133
208
|
setMuted(player.isMuted());
|
|
134
|
-
|
|
209
|
+
if (player.isLive()) {
|
|
210
|
+
player.setPlaybackRate(1);
|
|
211
|
+
setPlaybackRateState(1);
|
|
212
|
+
} else {
|
|
213
|
+
setPlaybackRateState(player.getPlaybackRate());
|
|
214
|
+
}
|
|
135
215
|
setIsFullscreen(player.isFullscreen());
|
|
136
216
|
};
|
|
137
217
|
const offs = [
|
|
@@ -196,7 +276,7 @@ function usePlayerControls(options) {
|
|
|
196
276
|
for (const off of offs) off();
|
|
197
277
|
document.removeEventListener("fullscreenchange", onFs);
|
|
198
278
|
};
|
|
199
|
-
}, [player, containerRef]);
|
|
279
|
+
}, [player, containerRef, config.controls.persistQualityPreference]);
|
|
200
280
|
const togglePlay = useCallback(() => {
|
|
201
281
|
if (!player) return;
|
|
202
282
|
if (player.getState() === "playing") {
|
|
@@ -237,6 +317,9 @@ function usePlayerControls(options) {
|
|
|
237
317
|
}, [player]);
|
|
238
318
|
const setPlaybackRate = useCallback(
|
|
239
319
|
(rate) => {
|
|
320
|
+
if (player?.isLive()) {
|
|
321
|
+
return;
|
|
322
|
+
}
|
|
240
323
|
player?.setPlaybackRate(rate);
|
|
241
324
|
setPlaybackRateState(rate);
|
|
242
325
|
},
|
|
@@ -245,8 +328,16 @@ function usePlayerControls(options) {
|
|
|
245
328
|
const setQuality = useCallback(
|
|
246
329
|
(selection) => {
|
|
247
330
|
player?.setQuality(selection);
|
|
331
|
+
if (config.controls.persistQualityPreference) {
|
|
332
|
+
writeQualityPreference(
|
|
333
|
+
preferenceFromSelection(
|
|
334
|
+
selection,
|
|
335
|
+
player?.getAvailableQualities() ?? []
|
|
336
|
+
)
|
|
337
|
+
);
|
|
338
|
+
}
|
|
248
339
|
},
|
|
249
|
-
[player]
|
|
340
|
+
[player, config.controls.persistQualityPreference]
|
|
250
341
|
);
|
|
251
342
|
const setTextTrack = useCallback(
|
|
252
343
|
(selection) => {
|
|
@@ -661,13 +752,15 @@ function SeekBar({
|
|
|
661
752
|
duration,
|
|
662
753
|
bufferedEnd,
|
|
663
754
|
onSeek,
|
|
664
|
-
seekInputRef
|
|
755
|
+
seekInputRef,
|
|
756
|
+
getSeekPreview
|
|
665
757
|
}) {
|
|
666
758
|
const trackRef = useRef3(null);
|
|
667
759
|
const [hover, setHover] = useState4(INITIAL_HOVER);
|
|
668
760
|
const max = duration > 0 ? duration : 0;
|
|
669
761
|
const bufferedPct = max > 0 ? Math.min(100, bufferedEnd / max * 100) : 0;
|
|
670
762
|
const playedPct = max > 0 ? Math.min(100, currentTime / max * 100) : 0;
|
|
763
|
+
const previewUrl = hover.visible && getSeekPreview ? getSeekPreview(hover.time) : null;
|
|
671
764
|
const updateHover = useCallback2(
|
|
672
765
|
(clientX) => {
|
|
673
766
|
const track = trackRef.current;
|
|
@@ -729,13 +822,24 @@ function SeekBar({
|
|
|
729
822
|
style: { width: `${playedPct}%` }
|
|
730
823
|
}
|
|
731
824
|
),
|
|
732
|
-
hover.visible && max > 0 ? /* @__PURE__ */
|
|
825
|
+
hover.visible && max > 0 ? /* @__PURE__ */ jsxs6(
|
|
733
826
|
"div",
|
|
734
827
|
{
|
|
735
828
|
className: "nsg-player-seek__tooltip",
|
|
736
829
|
style: { left: `${hover.percent}%` },
|
|
737
830
|
role: "tooltip",
|
|
738
|
-
children:
|
|
831
|
+
children: [
|
|
832
|
+
previewUrl ? /* @__PURE__ */ jsx8(
|
|
833
|
+
"img",
|
|
834
|
+
{
|
|
835
|
+
className: "nsg-player-seek__preview",
|
|
836
|
+
src: previewUrl,
|
|
837
|
+
alt: "",
|
|
838
|
+
draggable: false
|
|
839
|
+
}
|
|
840
|
+
) : null,
|
|
841
|
+
formatPlaybackTime(hover.time)
|
|
842
|
+
]
|
|
739
843
|
}
|
|
740
844
|
) : null,
|
|
741
845
|
/* @__PURE__ */ jsx8(
|
|
@@ -825,7 +929,8 @@ function PlayerControlBar(props) {
|
|
|
825
929
|
onToggleFullscreen,
|
|
826
930
|
onZoomIn,
|
|
827
931
|
onZoomOut,
|
|
828
|
-
seekBarRef
|
|
932
|
+
seekBarRef,
|
|
933
|
+
getSeekPreview
|
|
829
934
|
} = props;
|
|
830
935
|
const controls = config.controls;
|
|
831
936
|
const showZoom = config.player.zoomEnabled && controls.showZoom;
|
|
@@ -844,7 +949,8 @@ function PlayerControlBar(props) {
|
|
|
844
949
|
duration,
|
|
845
950
|
bufferedEnd,
|
|
846
951
|
onSeek,
|
|
847
|
-
seekInputRef: seekBarRef
|
|
952
|
+
seekInputRef: seekBarRef,
|
|
953
|
+
getSeekPreview
|
|
848
954
|
}
|
|
849
955
|
),
|
|
850
956
|
/* @__PURE__ */ jsxs8("div", { className: "nsg-player-control-row", children: [
|
|
@@ -954,7 +1060,7 @@ function PlayerControlBar(props) {
|
|
|
954
1060
|
]
|
|
955
1061
|
}
|
|
956
1062
|
) : null,
|
|
957
|
-
controls.showSpeed ? /* @__PURE__ */ jsx10(
|
|
1063
|
+
controls.showSpeed && !isLive ? /* @__PURE__ */ jsx10(
|
|
958
1064
|
PlaybackSpeedSelector,
|
|
959
1065
|
{
|
|
960
1066
|
rate: playbackRate,
|
|
@@ -1053,7 +1159,8 @@ function PlayerChrome({
|
|
|
1053
1159
|
config,
|
|
1054
1160
|
containerRef,
|
|
1055
1161
|
videoSlot,
|
|
1056
|
-
className
|
|
1162
|
+
className,
|
|
1163
|
+
getSeekPreview
|
|
1057
1164
|
}) {
|
|
1058
1165
|
const rootRef = useRef4(null);
|
|
1059
1166
|
const seekBarRef = useRef4(null);
|
|
@@ -1237,7 +1344,8 @@ function PlayerChrome({
|
|
|
1237
1344
|
onToggleFullscreen: () => void controls.toggleFullscreen(),
|
|
1238
1345
|
onZoomIn: controls.zoomIn,
|
|
1239
1346
|
onZoomOut: controls.zoomOut,
|
|
1240
|
-
seekBarRef
|
|
1347
|
+
seekBarRef,
|
|
1348
|
+
getSeekPreview
|
|
1241
1349
|
}
|
|
1242
1350
|
) : null
|
|
1243
1351
|
]
|
|
@@ -1245,11 +1353,117 @@ function PlayerChrome({
|
|
|
1245
1353
|
);
|
|
1246
1354
|
}
|
|
1247
1355
|
|
|
1356
|
+
// src/hooks/usePlaybackWatermark.ts
|
|
1357
|
+
import { useEffect as useEffect6, useRef as useRef5, useState as useState6 } from "react";
|
|
1358
|
+
|
|
1359
|
+
// src/utils/watermarkSchedule.ts
|
|
1360
|
+
var WATERMARK_TOP_MIN_PCT = 8;
|
|
1361
|
+
var WATERMARK_TOP_MAX_PCT = 70;
|
|
1362
|
+
var WATERMARK_LEFT_MIN_PCT = 5;
|
|
1363
|
+
var WATERMARK_LEFT_MAX_PCT = 70;
|
|
1364
|
+
var WATERMARK_FIRST_SHOW_MIN_MS = 3e3;
|
|
1365
|
+
var WATERMARK_FIRST_SHOW_MAX_MS = 8e3;
|
|
1366
|
+
function randomInRange(min, max, random = Math.random) {
|
|
1367
|
+
if (max <= min) {
|
|
1368
|
+
return min;
|
|
1369
|
+
}
|
|
1370
|
+
return min + random() * (max - min);
|
|
1371
|
+
}
|
|
1372
|
+
function randomWatermarkPosition(random = Math.random) {
|
|
1373
|
+
const topPct = WATERMARK_TOP_MIN_PCT + random() * (WATERMARK_TOP_MAX_PCT - WATERMARK_TOP_MIN_PCT);
|
|
1374
|
+
const leftPct = WATERMARK_LEFT_MIN_PCT + random() * (WATERMARK_LEFT_MAX_PCT - WATERMARK_LEFT_MIN_PCT);
|
|
1375
|
+
return { topPct, leftPct };
|
|
1376
|
+
}
|
|
1377
|
+
function randomWatermarkDelay(maxMs, random = Math.random) {
|
|
1378
|
+
if (!Number.isFinite(maxMs) || maxMs <= 0) {
|
|
1379
|
+
return 0;
|
|
1380
|
+
}
|
|
1381
|
+
return Math.min(maxMs, Math.floor(random() * (maxMs + 1)));
|
|
1382
|
+
}
|
|
1383
|
+
function randomFirstShowDelay(random = Math.random) {
|
|
1384
|
+
return Math.floor(
|
|
1385
|
+
randomInRange(
|
|
1386
|
+
WATERMARK_FIRST_SHOW_MIN_MS,
|
|
1387
|
+
WATERMARK_FIRST_SHOW_MAX_MS,
|
|
1388
|
+
random
|
|
1389
|
+
)
|
|
1390
|
+
);
|
|
1391
|
+
}
|
|
1392
|
+
|
|
1393
|
+
// src/hooks/usePlaybackWatermark.ts
|
|
1394
|
+
var HIDDEN = {
|
|
1395
|
+
visible: false,
|
|
1396
|
+
topPct: 0,
|
|
1397
|
+
leftPct: 0
|
|
1398
|
+
};
|
|
1399
|
+
function usePlaybackWatermark({
|
|
1400
|
+
enabled,
|
|
1401
|
+
label,
|
|
1402
|
+
active,
|
|
1403
|
+
durationMs,
|
|
1404
|
+
intervalMaxMs,
|
|
1405
|
+
reducedMotion = false
|
|
1406
|
+
}) {
|
|
1407
|
+
const [state, setState] = useState6(HIDDEN);
|
|
1408
|
+
const showTimerRef = useRef5(null);
|
|
1409
|
+
const hideTimerRef = useRef5(null);
|
|
1410
|
+
const generationRef = useRef5(0);
|
|
1411
|
+
useEffect6(() => {
|
|
1412
|
+
const clearTimers = () => {
|
|
1413
|
+
if (showTimerRef.current !== null) {
|
|
1414
|
+
window.clearTimeout(showTimerRef.current);
|
|
1415
|
+
showTimerRef.current = null;
|
|
1416
|
+
}
|
|
1417
|
+
if (hideTimerRef.current !== null) {
|
|
1418
|
+
window.clearTimeout(hideTimerRef.current);
|
|
1419
|
+
hideTimerRef.current = null;
|
|
1420
|
+
}
|
|
1421
|
+
};
|
|
1422
|
+
generationRef.current += 1;
|
|
1423
|
+
const generation = generationRef.current;
|
|
1424
|
+
clearTimers();
|
|
1425
|
+
setState(HIDDEN);
|
|
1426
|
+
if (!enabled || !label || !active) {
|
|
1427
|
+
return () => {
|
|
1428
|
+
clearTimers();
|
|
1429
|
+
};
|
|
1430
|
+
}
|
|
1431
|
+
if (reducedMotion) {
|
|
1432
|
+
setState({ visible: true, topPct: 12, leftPct: 8 });
|
|
1433
|
+
return () => {
|
|
1434
|
+
clearTimers();
|
|
1435
|
+
};
|
|
1436
|
+
}
|
|
1437
|
+
const scheduleShow = (delayMs) => {
|
|
1438
|
+
showTimerRef.current = window.setTimeout(() => {
|
|
1439
|
+
if (generation !== generationRef.current) {
|
|
1440
|
+
return;
|
|
1441
|
+
}
|
|
1442
|
+
const position = randomWatermarkPosition();
|
|
1443
|
+
setState({ visible: true, ...position });
|
|
1444
|
+
hideTimerRef.current = window.setTimeout(() => {
|
|
1445
|
+
if (generation !== generationRef.current) {
|
|
1446
|
+
return;
|
|
1447
|
+
}
|
|
1448
|
+
setState(HIDDEN);
|
|
1449
|
+
scheduleShow(randomWatermarkDelay(intervalMaxMs));
|
|
1450
|
+
}, durationMs);
|
|
1451
|
+
}, delayMs);
|
|
1452
|
+
};
|
|
1453
|
+
scheduleShow(randomFirstShowDelay());
|
|
1454
|
+
return () => {
|
|
1455
|
+
generationRef.current += 1;
|
|
1456
|
+
clearTimers();
|
|
1457
|
+
};
|
|
1458
|
+
}, [enabled, label, active, durationMs, intervalMaxMs, reducedMotion]);
|
|
1459
|
+
return state;
|
|
1460
|
+
}
|
|
1461
|
+
|
|
1248
1462
|
// src/NsgVideoPlayerWithControls.tsx
|
|
1249
1463
|
import { jsx as jsx13, jsxs as jsxs11 } from "react/jsx-runtime";
|
|
1250
|
-
|
|
1251
|
-
const containerRef =
|
|
1252
|
-
const onWatchTimeRef =
|
|
1464
|
+
var NsgVideoPlayerWithControls = forwardRef(function NsgVideoPlayerWithControls2(props, ref) {
|
|
1465
|
+
const containerRef = useRef6(null);
|
|
1466
|
+
const onWatchTimeRef = useRef6(props.onWatchTime);
|
|
1253
1467
|
onWatchTimeRef.current = props.onWatchTime;
|
|
1254
1468
|
const resolvedConfig = useMemo2(
|
|
1255
1469
|
() => mergePlayerConfig({
|
|
@@ -1267,10 +1481,15 @@ function NsgVideoPlayerWithControls(props) {
|
|
|
1267
1481
|
playback: props.playback,
|
|
1268
1482
|
sourceUrl: props.sourceUrl,
|
|
1269
1483
|
config: resolvedConfig,
|
|
1484
|
+
analytics: props.analytics,
|
|
1270
1485
|
onReady: props.onReady,
|
|
1271
|
-
onError: props.onError
|
|
1486
|
+
onError: props.onError,
|
|
1487
|
+
onPlay: props.onPlay,
|
|
1488
|
+
onPause: props.onPause,
|
|
1489
|
+
onAuthError: props.onAuthError
|
|
1272
1490
|
});
|
|
1273
|
-
|
|
1491
|
+
useImperativeHandle(ref, () => player, [player]);
|
|
1492
|
+
useEffect7(() => {
|
|
1274
1493
|
if (!player) return;
|
|
1275
1494
|
const report = () => {
|
|
1276
1495
|
const t = player.getCurrentTime();
|
|
@@ -1278,9 +1497,7 @@ function NsgVideoPlayerWithControls(props) {
|
|
|
1278
1497
|
};
|
|
1279
1498
|
const offs = [
|
|
1280
1499
|
player.on("pause", report),
|
|
1281
|
-
player.on("ended", report)
|
|
1282
|
-
player.on("play", () => props.onPlay?.()),
|
|
1283
|
-
player.on("pause", () => props.onPause?.())
|
|
1500
|
+
player.on("ended", report)
|
|
1284
1501
|
];
|
|
1285
1502
|
const onBeforeUnload = () => report();
|
|
1286
1503
|
window.addEventListener("beforeunload", onBeforeUnload);
|
|
@@ -1288,7 +1505,16 @@ function NsgVideoPlayerWithControls(props) {
|
|
|
1288
1505
|
for (const off of offs) off();
|
|
1289
1506
|
window.removeEventListener("beforeunload", onBeforeUnload);
|
|
1290
1507
|
};
|
|
1291
|
-
}, [player
|
|
1508
|
+
}, [player]);
|
|
1509
|
+
const watermarkActive = state === "playing" || state === "paused" || state === "buffering";
|
|
1510
|
+
const watermark = usePlaybackWatermark({
|
|
1511
|
+
enabled: resolvedConfig.watermark.enabled,
|
|
1512
|
+
label: resolvedConfig.watermark.text?.trim() || null,
|
|
1513
|
+
active: watermarkActive,
|
|
1514
|
+
durationMs: resolvedConfig.watermark.durationMs,
|
|
1515
|
+
intervalMaxMs: resolvedConfig.watermark.intervalMaxMs,
|
|
1516
|
+
reducedMotion: resolvedConfig.accessibility.reducedMotion
|
|
1517
|
+
});
|
|
1292
1518
|
const cssVars = themeToCssVars(resolvedConfig.theme);
|
|
1293
1519
|
const showBootstrap = state === "loading" || state === "idle";
|
|
1294
1520
|
return /* @__PURE__ */ jsxs11(
|
|
@@ -1314,6 +1540,7 @@ function NsgVideoPlayerWithControls(props) {
|
|
|
1314
1540
|
player,
|
|
1315
1541
|
config: resolvedConfig,
|
|
1316
1542
|
containerRef,
|
|
1543
|
+
getSeekPreview: props.getSeekPreview,
|
|
1317
1544
|
videoSlot: /* @__PURE__ */ jsx13(
|
|
1318
1545
|
"video",
|
|
1319
1546
|
{
|
|
@@ -1325,13 +1552,24 @@ function NsgVideoPlayerWithControls(props) {
|
|
|
1325
1552
|
)
|
|
1326
1553
|
}
|
|
1327
1554
|
),
|
|
1328
|
-
|
|
1555
|
+
watermark.visible ? /* @__PURE__ */ jsx13(
|
|
1556
|
+
"div",
|
|
1557
|
+
{
|
|
1558
|
+
className: "nsg-player-watermark",
|
|
1559
|
+
"aria-hidden": true,
|
|
1560
|
+
style: {
|
|
1561
|
+
top: `${watermark.topPct}%`,
|
|
1562
|
+
left: `${watermark.leftPct}%`
|
|
1563
|
+
},
|
|
1564
|
+
children: resolvedConfig.watermark.text
|
|
1565
|
+
}
|
|
1566
|
+
) : null,
|
|
1329
1567
|
error ? /* @__PURE__ */ jsx13("p", { className: "nsg-player-error", role: "alert", children: error.message || "Unable to play this video." }) : null,
|
|
1330
1568
|
showBootstrap && !error ? /* @__PURE__ */ jsx13("p", { className: "nsg-player-status", children: "Loading video\u2026" }) : null
|
|
1331
1569
|
]
|
|
1332
1570
|
}
|
|
1333
1571
|
);
|
|
1334
|
-
}
|
|
1572
|
+
});
|
|
1335
1573
|
export {
|
|
1336
1574
|
AudioTrackSelector,
|
|
1337
1575
|
LiveBadgeButton,
|
|
@@ -1344,15 +1582,24 @@ export {
|
|
|
1344
1582
|
PlayerMenu,
|
|
1345
1583
|
PlayerMenuItem,
|
|
1346
1584
|
PlayerSkipCue,
|
|
1585
|
+
QUALITY_PREFERENCE_STORAGE_KEY,
|
|
1347
1586
|
QualitySelector,
|
|
1348
1587
|
SeekBar,
|
|
1349
1588
|
TextTrackSelector,
|
|
1350
1589
|
ZOOM_STEPS,
|
|
1351
1590
|
formatPlaybackTime,
|
|
1591
|
+
matchQualityPreference,
|
|
1352
1592
|
nextZoom,
|
|
1593
|
+
preferenceFromSelection,
|
|
1594
|
+
randomFirstShowDelay,
|
|
1595
|
+
randomWatermarkDelay,
|
|
1596
|
+
randomWatermarkPosition,
|
|
1597
|
+
readQualityPreference,
|
|
1353
1598
|
resolvePlayerOverlay,
|
|
1354
1599
|
resolveVisiblePlaybackRates,
|
|
1355
1600
|
snapPlaybackRate,
|
|
1356
|
-
|
|
1601
|
+
usePlaybackWatermark,
|
|
1602
|
+
usePlayerControls,
|
|
1603
|
+
writeQualityPreference
|
|
1357
1604
|
};
|
|
1358
1605
|
//# sourceMappingURL=index.js.map
|