feat(player): save video quality in storage

closes #1127

packages/vidstack/src/core/state/media-player-delegate.ts

@@ -3,6 +3,7 @@ import { DOMEvent, type InferEventDetail } from 'maverick.js/std';
 
 import type { MediaContext } from '../api/media-context';
 import type { MediaEvents } from '../api/media-events';
+import type { VideoQuality } from '../quality/video-quality';
 
 let seenAutoplayWarning = false;
 
@@ -72,7 +73,7 @@ export class MediaPlayerDelegate {
       }
 
       let provider = this._media.$provider(),
-        { storage } = this._media,
+        { storage, qualities } = this._media,
         { muted, volume, clipStartTime, playbackRate } = this._media.$props;
 
       const remotePlaybackTime = remotePlaybackInfo()?.savedState?.currentTime,
@@ -88,6 +89,27 @@ export class MediaPlayerDelegate {
         if (startTime > 0) provider.setCurrentTime(startTime);
       }
 
+      const prefQuality = await storage?.getVideoQuality();
+      if (prefQuality && qualities.length) {
+        let currentQuality: VideoQuality | null = null,
+          currentScore = Infinity;
+
+        for (const quality of qualities) {
+          const score =
+            Math.abs(prefQuality.width - quality.width) +
+            Math.abs(prefQuality.height - quality.height) +
+            (prefQuality.bitrate ? Math.abs(prefQuality.bitrate - quality.bitrate) : 0);
+
+          // Lowest score wins (smallest diff between width/height/bitrate).
+          if (score < currentScore) {
+            currentQuality = quality;
+            currentScore = score;
+          }
+        }
+
+        if (currentQuality) currentQuality.selected = true;
+      }
+
       if (canPlay() && shouldAutoPlay && !started()) {
         await this._attemptAutoplay(trigger);
       }

packages/vidstack/src/core/state/media-request-manager.ts

@@ -430,9 +430,11 @@ export class MediaRequestManager extends MediaPlayerController implements MediaR
   }
 
   ['media-audio-track-change-request'](event: RE.MediaAudioTrackChangeRequestEvent) {
-    if (this._media.audioTracks.readonly) {
+    const { logger, audioTracks } = this._media;
+
+    if (audioTracks.readonly) {
       if (__DEV__) {
-        this._media.logger
+        logger
           ?.warnGroup(`[vidstack] attempted to change audio track but it is currently read-only`)
           .labelledLog('Request Event', event)
           .dispatch();
@@ -442,16 +444,16 @@ export class MediaRequestManager extends MediaPlayerController implements MediaR
     }
 
     const index = event.detail,
-      track = this._media.audioTracks[index];
+      track = audioTracks[index];
 
     if (track) {
       const key = event.type as 'media-audio-track-change-request';
       this._request._queue._enqueue(key, event);
       track.selected = true;
     } else if (__DEV__) {
-      this._media.logger
+      logger
         ?.warnGroup('[vidstack] failed audio track change request (invalid index)')
-        .labelledLog('Audio Tracks', this._media.audioTracks.toArray())
+        .labelledLog('Audio Tracks', audioTracks.toArray())
         .labelledLog('Index', index)
         .labelledLog('Request Event', event)
         .dispatch();
@@ -618,9 +620,11 @@ export class MediaRequestManager extends MediaPlayerController implements MediaR
   }
 
   ['media-quality-change-request'](event: RE.MediaQualityChangeRequestEvent) {
-    if (this._media.qualities.readonly) {
+    const { qualities, storage, logger } = this._media;
+
+    if (qualities.readonly) {
       if (__DEV__) {
-        this._media.logger
+        logger
           ?.warnGroup(`[vidstack] attempted to change video quality but it is currently read-only`)
           .labelledLog('Request Event', event)
           .dispatch();
@@ -632,16 +636,26 @@ export class MediaRequestManager extends MediaPlayerController implements MediaR
     this._request._queue._enqueue('media-quality-change-request', event);
 
     const index = event.detail;
+
     if (index < 0) {
-      this._media.qualities.autoSelect(event);
+      qualities.autoSelect(event);
+      if (event.isOriginTrusted) storage?.setVideoQuality?.(null);
     } else {
-      const quality = this._media.qualities[index];
+      const quality = qualities[index];
       if (quality) {
         quality.selected = true;
+        if (event.isOriginTrusted) {
+          storage?.setVideoQuality?.({
+            id: quality.id,
+            width: quality.width,
+            height: quality.height,
+            bitrate: quality.bitrate,
+          });
+        }
       } else if (__DEV__) {
-        this._media.logger
+        logger
           ?.warnGroup('[vidstack] failed quality change request (invalid index)')
-          .labelledLog('Qualities', this._media.qualities.toArray())
+          .labelledLog('Qualities', qualities.toArray())
           .labelledLog('Index', index)
           .labelledLog('Request Event', event)
           .dispatch();

packages/vidstack/src/core/state/media-storage.ts

@@ -22,6 +22,9 @@ export interface MediaStorage {
   getPlaybackRate(): Promise<number | null>;
   setPlaybackRate?(rate: number): Promise<void>;
 
+  getVideoQuality(): Promise<SerializedVideoQuality | null>;
+  setVideoQuality?(quality: SerializedVideoQuality | null): Promise<void>;
+
   /**
    * Called when the `mediaId` has changed. This method can return a function to be called
    * before the next change.
@@ -41,6 +44,13 @@ export interface MediaStorage {
   onDestroy?(): void;
 }
 
+export interface SerializedVideoQuality {
+  id: string;
+  width: number;
+  height: number;
+  bitrate?: number;
+}
+
 export class LocalMediaStorage implements MediaStorage {
   protected playerId = 'vds-player';
   protected mediaId: string | null = null;
@@ -52,6 +62,7 @@ export class LocalMediaStorage implements MediaStorage {
     lang: null,
     captions: null,
     rate: null,
+    quality: null,
   };
 
   async getVolume() {
@@ -108,6 +119,15 @@ export class LocalMediaStorage implements MediaStorage {
     this.save();
   }
 
+  async getVideoQuality() {
+    return this._data.quality;
+  }
+
+  async setVideoQuality(quality: SerializedVideoQuality | null) {
+    this._data.quality = quality;
+    this.save();
+  }
+
   onChange(src: MediaSrc, mediaId: string | null, playerId = 'vds-player') {
     const savedData = playerId ? localStorage.getItem(playerId) : null,
       savedTime = mediaId ? localStorage.getItem(mediaId) : null;
@@ -120,6 +140,8 @@ export class LocalMediaStorage implements MediaStorage {
       muted: null,
       lang: null,
       captions: null,
+      rate: null,
+      quality: null,
       ...(savedData ? JSON.parse(savedData) : {}),
       time: savedTime ? +savedTime : null,
     };
@@ -145,4 +167,5 @@ interface SavedMediaData {
   lang: string | null;
   captions: boolean | null;
   rate: number | null;
+  quality: SerializedVideoQuality | null;
 }