博客

让 expo-video 在 TikTok 风格的信息流中顺畅运行

2026年1月10日 11 分钟阅读

我如何让 expo-video 在 TikTok 风格的信息流中表现得体:把创建播放器和播放分开,再把信息流、hero、横向列表和结果页当作不同的界面处理。

让 expo-video 在 TikTok 风格的信息流中顺畅运行
ExpoReact Nativeexpo-video性能视频

用 expo-video 打造流畅的 TikTok 风格视频信息流

当屏幕上只有一个播放器时,expo-video 用起来很简单。

但如果同一个应用里既有首屏大图视频(hero),又有竖向信息流、横向列表,还有一个带完整控件的结果页,事情就难了。

我的应用就是这样,而问题其实并不是“怎么在 Expo 里播放视频?”

真正的问题是,我有太多不同的视频界面,却把它们当成同一种东西来处理。

这就是错误所在。

有些界面应该提前创建播放器。有些应该只在获得焦点时播放。有些在用户靠近之前应该只显示缩略图。还有一些在远程播放卡住时需要一条兜底路径。

我写这篇文章,是因为解决办法并不是某个神奇的 prop,而是定义一套播放策略。

为什么事情很快就会变乱

在做任何事之前,我先把问题拆成了四个决策:

  • 这个界面应该创建播放器吗?
  • 这个播放器现在应该在播放吗?
  • 这个播放器的开销应该有多大?
  • 在第一帧出现之前,用户应该看到什么?

把这几个决策分开之后,其余的架构就容易理清多了。

把 expo-video 包在一层封装后面

在做任何优化之前,我先给 expo-video 包了一层。

我不希望缓冲设置、全屏行为、surface 类型和播放器初始化散落在应用各处。一层封装就足以把这些选择集中到一个地方。

官方文档在这里:expo-video 文档。

export type AndroidBufferProfile =
  | "detail"
  | "preview"
  | "feed-active"
  | "feed-adjacent";

const ANDROID_BUFFER_PROFILES: Record<
  AndroidBufferProfile,
  BufferOptions
> = {
  detail: {
    preferredForwardBufferDuration: 1.75,
    minBufferForPlayback: 0.35,
    prioritizeTimeOverSizeThreshold: true,
  },
  preview: {
    preferredForwardBufferDuration: 1.1,
    minBufferForPlayback: 0.2,
    prioritizeTimeOverSizeThreshold: true,
  },
  "feed-active": {
    preferredForwardBufferDuration: 2.5,
    minBufferForPlayback: 0.4,
    prioritizeTimeOverSizeThreshold: true,
  },
  "feed-adjacent": {
    preferredForwardBufferDuration: 0.6,
    minBufferForPlayback: 0.15,
    prioritizeTimeOverSizeThreshold: true,
  },
};

这层封装并没有做什么神奇的事情。它只是给了我一个地方来定义:

  • 详情页播放器
  • 预览播放器
  • 信息流当前播放器
  • 信息流相邻播放器

Android 的配置档很重要,但它们只是整体方案的一部分。更大的收益来自控制播放器何时存在、何时允许播放。

创建播放器不等于播放

这是最重要的思维转变。

在信息流页面里,我不再把创建播放器和播放当成同一件事。

const shouldCreatePlayer =
  isTransitionFinished &&
  (isActive || isAdjacent) &&
  !!videoUrl;

const shouldPlay =
  isActive &&
  isAppInForeground &&
  isScreenFocused;

这两个布尔值解决的是不同的问题。

  • shouldCreatePlayer 回答的是这个界面到底配不配拥有一个播放器
  • shouldPlay 回答的是这个播放器现在是否应该在运行

在信息流里,这个区别非常重要。

如果不做这个区分,最后通常会出现过多的播放器、过多的缓冲,以及大量无意义的工作。

竖向信息流中的当前项和相邻项

在主信息流里,我只为当前项和它的相邻项创建播放器。

这样当前卡片能做到即时响应,又不用为整个列表付出全部代价。

const videoSource = useMemo(() => {
  if (!shouldCreatePlayer || !videoUrl) return null;

  return {
    uri: videoUrl,
    useCaching: Platform.OS !== "ios",
  };
}, [shouldCreatePlayer, videoUrl]);

const player = useAppVideoPlayer(videoSource, {
  loop: true,
  muted: true,
  androidBufferProfile: isActive
    ? "feed-active"
    : "feed-adjacent",
});

当前卡片使用更宽裕的配置。

相邻卡片使用开销更低的配置,因为它可能永远不会成为主角。

但更重要的依然是播放规则,而不是缓冲规则。

我会立即把非当前项静音并暂停:

useEffect(() => {
  if (!player) return;

  if (shouldPlay) {
    player.muted = false;
    player.play();
  } else {
    player.muted = true;
    player.pause();
  }
}, [player, shouldPlay]);

这部分是跨平台的。它才是真正的行为改变。

在预览界面里,我还在 iOS 上保持 useCaching 关闭。这并不是 expo-video 的通用规则,而是针对这个应用的决定,因为对我来说预览缓存在 Android 上比在 iOS 上更稳定。

缩略图优先渲染没有商量余地

如果一个信息流单元格在播放器预热时显示一个黑色矩形,用户就已经觉得它坏了。

所以我始终把缩略图作为底层,只有在第一帧渲染出来之后才显示播放器。

<AppVideoView
  player={player}
  contentFit="cover"
  nativeControls={false}
  pointerEvents="none"
  style={[
    StyleSheet.absoluteFill,
    { opacity: hasFirstFrame ? 1 : 0 },
  ]}
  androidSurfaceType="textureView"
  onFirstFrameRender={() => setHasFirstFrame(true)}
/>

这个小小的透明度开关带来了巨大的差别。

视频不需要立刻出现。它只需要干净地替换掉缩略图。

这段代码的重点是第一帧的交接。textureView 那一行只是一个 Android 专属的渲染细节。

平台相关的调优:bufferOptions 和 surfaceType

这部分需要说得更精确一点。

expo-video 提供了跨平台的 bufferOptions,但这个对象里的部分字段是平台专属的。

实际上这意味着:

  • bufferOptions 这个 API 在 Android 和 iOS 上都存在
  • minBufferForPlayback 和 prioritizeTimeOverSizeThreshold 这类字段,是我这里用到的偏 Android 的调优参数
  • waitsToMinimizeStalling 是同一个 API 里 iOS 专属的缓冲设置
  • surfaceType 只在 Android 上有效

正是这些让我能够区分:

  • 信息流当前卡片
  • 信息流相邻卡片
  • 详情页播放器
  • 预览播放器

这也是为什么在视频视图重叠或有分层转场的地方,我明确使用了 textureView。

Expo 文档甚至专门提到,surfaceType="textureView" 可以作为 Android 上 VideoView 重叠问题的变通办法。

所以当我展示这样的代码时:

const player = useAppVideoPlayer(videoSource, {
  loop: true,
  muted: true,
  androidBufferProfile: isActive
    ? "feed-active"
    : "feed-adjacent",
});

这一节讲的其实是 Android 播放开销的调优,而不是整个解决方案。

完整的方案依然是围绕创建、播放、暂停、静音和兜底的生命周期策略。

横向列表需要播放预算

信息流并不是应用里唯一的视频界面。

首页上还有横向列表,而这些列表不能像 TikTok 那样运作。如果每个可见列表里的每张可见卡片都拿到一个播放器,你就会在一个并不需要它的界面上消耗太多内存。

所以我加了一个列表级别的播放预算。

const remainingSlots = heroVisible ? 3 : 4;
const rowBudget = Math.min(2, remainingSlots);

const shouldPlayCard =
  isRowVisible &&
  isCardVisibleHorizontally &&
  cardIndex < rowBudget;

这给了我一条简单的规则:

  • 只有可见列表中前几张符合条件的卡片才能拿到播放器
  • 其余的一律只显示缩略图

当一张卡片失去资格时,我还会稍微延迟卸载,这样阈值的快速变化就不会过于频繁地创建和销毁播放器。

useEffect(() => {
  if (shouldPlay) {
    setShouldRenderVideo(true);
    return;
  }

  const timeout = setTimeout(() => {
    setShouldRenderVideo(false);
  }, 180);

  return () => clearTimeout(timeout);
}, [shouldPlay]);

这样一来,横向列表的开销就比全屏信息流低得多。

首屏大图不应该像信息流那样运作

首屏大图(hero)有另一个问题。

我希望轮播图在交互时手感灵敏,停稳之后又能显示视频。

解决办法是:

  • 手势进行中滑动的是缩略图
  • 把当前视频作为单独的覆盖层显示
  • 拖动时让视频覆盖层淡出
  • 只有在 hero 可见、页面处于活动状态、手势已经停稳时才播放
const shouldPlayHero =
  isScreenActive &&
  isHeroVisible &&
  isSettled &&
  !!activeVideoUrl;

这比让每张 hero 幻灯片都保持一个运行中的播放器效果更好。

结果页需要另一种播放器

我并没有在所有地方使用同一个播放器组件。

静音循环播放的预览卡片和完整的结果页不是同一个问题。

结果页使用一个共享的 VideoPlayer,它具备:

  • 播放控件
  • playingChange 监听器
  • timeUpdate 监听器
  • statusChange 监听器
  • iOS 上的全屏支持
  • 远程优先播放,并以本地文件兜底

如果你要用到这些事件,相关的 Expo 文档是:

用法很简单:

<VideoPlayer
  uri={videoUrl}
  controlsVariant="playback"
  muted={false}
  loop={false}
  androidBufferProfile="detail"
  iosAllowFullscreen
  fallbackToLocal
  fallbackTimeoutMs={8000}
/>

兜底逻辑也很直接。

如果播放器在第一次成功加载之前处于加载状态太久,或者进入了错误状态,我就把 MP4 下载到缓存目录,然后切换视频源。

if (
  fallbackToLocal &&
  !fallbackApplied.current &&
  !hasLoadedOnce.current
) {
  fallbackTimer.current = setTimeout(() => {
    startLocalFallback();
  }, fallbackTimeoutMs);
}

if (status === "error" && fallbackToLocal) {
  startLocalFallback();
}

这不是为了微优化,而是为了让结果页可靠。

如果一个已经完成的结果打开后播放卡住了,整个功能都会让人觉得坏了。

真正重要的是什么

如果要把整套方案压缩成几条实用规则,大概是这样:

  • 把 expo-video 包在一层封装后面
  • 把创建播放器和播放分开
  • 把信息流、横向列表、hero 和结果页当作不同的界面
  • 默认先显示缩略图
  • 根据焦点和前台状态控制播放
  • 把 Android 缓冲配置当作细节,而不是整个策略
  • 为重要的播放界面加上兜底路径

最后一点很重要。

这篇文章其实并不是关于某一个 Android 缓冲参数。

更大的收获在于想清楚:

  • 播放器应该存在于哪里
  • 它应该何时播放
  • 它应该何时保持静音
  • 什么时候缩略图是更好的默认选择
  • 哪些界面值得拥有恢复路径

一旦我接受了这一点,架构就清晰多了。

最终效果

这是把创建播放器和播放分开、并且只把当前项当作唯一真正优先级之后,信息流的样子:

写在最后

这里真正难的并不是 expo-video 本身。

难的是诚实面对应用里到底有多少种不同的视频界面。

当我不再把它们一视同仁之后,信息流的体验就好多了。

也要替 expo-video 说句公道话,一旦播放策略清晰了,这个库本身就把它的工作做得非常好。

useVideoPlayer 和 VideoView 走同一条跨平台代码路径,让我能让架构的大部分保持共享,只在平台真正不同的地方分支,比如 Android 的 bufferOptions、Android 的 surfaceType,或者 iOS 的全屏行为。

如果你正在用 expo-video 构建信息流风格的界面,我会建议从这里开始。