feat: add manual video tagging

app/aweme/[awemeId]/hooks/useVideoPlayer.ts

@@ -1,9 +1,10 @@
-import { useEffect, useRef } from "react";
-import type { RefObject } from "react";
 import { useRouter } from "next/navigation";
+import type { RefObject } from "react";
+import { useEffect } from "react";
 import type { LoopMode, Neighbors } from "../types.ts";
 
 interface UseVideoPlayerProps {
+  enabled?: boolean;
   awemeId: string;
   videoRef: RefObject<HTMLVideoElement | null>;
   volume: number;
@@ -17,6 +18,7 @@ interface UseVideoPlayerProps {
 }
 
 export function useVideoPlayer({
+  enabled = true,
   awemeId,
   videoRef,
   volume,
@@ -32,6 +34,7 @@ export function useVideoPlayer({
 
   // 恢复播放进度
   useEffect(() => {
+    if (!enabled) return;
     if (progressRestored) return;
     const v = videoRef.current;
     if (!v) return;
@@ -74,10 +77,11 @@ export function useVideoPlayer({
       v.addEventListener("loadedmetadata", onLoadedMetadata, { once: true });
       return () => v.removeEventListener("loadedmetadata", onLoadedMetadata);
     }
-  }, [awemeId, progressRestored, videoRef, setProgressRestored]);
+  }, [awemeId, enabled, progressRestored, videoRef, setProgressRestored]);
 
   // 保存播放进度
   useEffect(() => {
+    if (!enabled) return;
     const v = videoRef.current;
     if (!v) return;
 
@@ -105,10 +109,11 @@ export function useVideoPlayer({
       window.removeEventListener("beforeunload", onBeforeUnload);
       saveProgress();
     };
-  }, [awemeId, videoRef]);
+  }, [awemeId, enabled, videoRef]);
 
   // 监听播放状态和进度
   useEffect(() => {
+    if (!enabled) return;
     const v = videoRef.current;
     if (!v) return;
 
@@ -137,10 +142,19 @@ export function useVideoPlayer({
       v.removeEventListener("pause", onPause);
       v.removeEventListener("ended", onEnded);
     };
-  }, [loopMode, neighbors?.next, router, videoRef, setIsPlaying, setProgress]);
+  }, [
+    enabled,
+    loopMode,
+    neighbors?.next,
+    router,
+    videoRef,
+    setIsPlaying,
+    setProgress,
+  ]);
 
   // 自动播放检测
   useEffect(() => {
+    if (!enabled) return;
     const v = videoRef.current;
     if (!v) return;
 
@@ -148,7 +162,7 @@ export function useVideoPlayer({
       try {
         await v.play();
         setIsPlaying(true);
-      } catch (error) {
+      } catch {
         console.log("自动播放被阻止，需要用户交互");
         setIsPlaying(false);
       }
@@ -160,16 +174,18 @@ export function useVideoPlayer({
       v.addEventListener("loadedmetadata", checkAutoplay, { once: true });
       return () => v.removeEventListener("loadedmetadata", checkAutoplay);
     }
-  }, [awemeId, videoRef, setIsPlaying]);
+  }, [enabled, videoRef, setIsPlaying]);
 
   // 更新音量和倍速
   useEffect(() => {
+    if (!enabled) return;
     const v = videoRef.current;
     if (v) v.volume = volume;
-  }, [volume, videoRef]);
+  }, [enabled, volume, videoRef]);
 
   useEffect(() => {
+    if (!enabled) return;
     const v = videoRef.current;
     if (v) v.playbackRate = rate;
-  }, [rate, videoRef]);
+  }, [enabled, rate, videoRef]);
 }