Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* 文件预览里的视频播放:系统原生播放器(iOS AVPlayerViewController / Android ExoPlayer)。
* 控件、全屏、旋转都交给系统,随系统版本自动是当代样式;本组件只补两件事:
* 缓冲时显示已加载百分比,所在页失活(翻页 / 压栈)时暂停,回到本页不代用户续播。
*/
import { useEvent } from "expo";
import { GlassView } from "expo-glass-effect";
import { useVideoPlayer, VideoView } from "expo-video";
import { useEffect, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import {
ActivityIndicator,
StyleSheet,
View,
type StyleProp,
type ViewStyle,
} from "react-native";
import { Text } from "@/components/AppText";
import { mobileDebugLog } from "@/debug/mobileDebugLog";
import { sanitizeDiagnosticText } from "@/debug/fileDiagnostics";
import { createMediaPlayerWebViewLifecycle } from "@/session/mediaPlayerWebViewLifecycle";
import { transferPercent } from "@/session/transferProgress";
import { useLiquidGlassAvailable } from "@/session/useLiquidGlassAvailable";
import { lineHeight, radius, spacing, typeScale } from "@/theme/tokens";
/** 每次起播 AVPlayer 都会短暂进入 loading 评估缓冲,短于此时长不打扰。 */
const BUFFERING_HINT_DELAY_MS = 400;
const BUFFER_SAMPLE_MS = 500;
const HINT_SPINNER = "#FFFFFF";
export function NativeVideoPlayer({
onError,
style,
testID,
url,
visible,
autoPlay = false,
onVideoSize,
}: {
onError(detail: string): void;
style?: StyleProp<ViewStyle>;
testID?: string;
url: string;
/** 所在页是否为当前可见页:可见 → 失活沿暂停一次。 */
visible: boolean;
/** Only true after an explicit play action in the message stream. */
autoPlay?: boolean;
/** Intrinsic display size, available once the native track renders. */
onVideoSize?: (size: { width: number; height: number }) => void;
}) {
const { t } = useTranslation();
const liquidGlass = useLiquidGlassAvailable();
const player = useVideoPlayer(url, instance => { if (autoPlay && visible) instance.play(); });
const { status, error } = useEvent(player, "statusChange", {
status: player.status,
});
const [buffering, setBuffering] = useState(false);
const [bufferedPercent, setBufferedPercent] = useState<number | null>(null);
const onErrorRef = useRef(onError);
onErrorRef.current = onError;
useEffect(() => {
mobileDebugLog(
status === "error" ? "warn" : "debug",
"files",
"native video state",
{
state: status,
mediaError: error?.message
? sanitizeDiagnosticText(error.message)
: null,
},
);
if (status === "error") onErrorRef.current(error?.message ?? "media error");
}, [error, status]);
useEffect(() => {
if (status !== "loading") {
setBuffering(false);
return undefined;
}
const timer = setTimeout(() => setBuffering(true), BUFFERING_HINT_DELAY_MS);
return () => clearTimeout(timer);
}, [status]);
// 缓冲期间 AVPlayer 不发 timeUpdate(暂停时也不发),主动采样已加载到的位置。
useEffect(() => {
if (!buffering) return undefined;
const sample = () => {
const duration = player.duration;
const loaded = player.bufferedPosition;
setBufferedPercent(
duration > 0 && loaded >= 0
? transferPercent({ loaded, total: duration })
: null,
);
};
sample();
const timer = setInterval(sample, BUFFER_SAMPLE_MS);
return () => clearInterval(timer);
}, [buffering, player]);
// 与 WebView 播放器共用同一判据:只在「可见 → 失活」沿暂停一次。
const lifecycleRef = useRef(createMediaPlayerWebViewLifecycle());
useEffect(() => {
if (lifecycleRef.current.onVisibilityChange(visible)) player.pause();
}, [player, visible]);
const label =
bufferedPercent === null
? t("files.preview.videoBuffering")
: t("files.preview.videoBufferingPercent", { percent: bufferedPercent });
return (
<View style={[styles.stage, style]} testID={testID}>
<VideoView
allowsPictureInPicture={false}
contentFit="contain"
fullscreenOptions={{ enable: true, orientation: "default" }}
nativeControls
onFirstFrameRender={() => {
const size = player.videoTrack?.size;
if (size && Number.isFinite(size.width) && Number.isFinite(size.height)
&& size.width > 0 && size.height > 0) onVideoSize?.(size);
}}
player={player}
style={StyleSheet.absoluteFill}
/>
{buffering ? (
<View
pointerEvents="none"
style={styles.hintAnchor}
testID="filePreview.videoBuffering"
>
{liquidGlass ? (
<GlassView
colorScheme="dark"
glassEffectStyle="regular"
style={styles.hintPill}
>
<ActivityIndicator color={HINT_SPINNER} size="small" />
<Text style={styles.hintText}>{label}</Text>
</GlassView>
) : (
<View style={[styles.hintPill, styles.hintPillFallback]}>
<ActivityIndicator color={HINT_SPINNER} size="small" />
<Text style={styles.hintText}>{label}</Text>
</View>
)}
</View>
) : null}
</View>
);
}
// 视频画布双模式恒深(与图片 lightbox 同一做法):系统播放控件按深底设计,
// 叠在上面的提示也按恒深配色,不随主题反相。
const styles = StyleSheet.create({
stage: { backgroundColor: "#000000", flex: 1, overflow: "hidden" },
hintAnchor: {
alignItems: "center",
left: 0,
position: "absolute",
right: 0,
top: spacing.lg,
},
hintPill: {
alignItems: "center",
borderRadius: radius.pill,
flexDirection: "row",
gap: spacing.sm,
overflow: "hidden",
paddingHorizontal: spacing.md,
paddingVertical: spacing.sm,
},
hintPillFallback: {
backgroundColor: "rgba(0, 0, 0, 0.6)",
borderColor: "rgba(255, 255, 255, 0.22)",
borderWidth: StyleSheet.hairlineWidth,
},
hintText: {
color: "rgba(255, 255, 255, 0.85)",
fontSize: typeScale.footnote,
fontVariant: ["tabular-nums"],
lineHeight: lineHeight.caption,
},
});