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

By Tarik Pinarci (https://tarikpinarci.com). Published 2026-01-10. Canonical: https://tarikpinarci.com/zh/blog/making-expo-video-work-in-feed-style-uis

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

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

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

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

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

这就是错误所在。

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

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

## 为什么事情很快就会变乱

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

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

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

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

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

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

官方文档在这里：[expo-video 文档](https://docs.expo.dev/versions/latest/sdk/video/)。

```tsx
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 的配置档很重要，但它们只是整体方案的一部分。更大的收益来自控制播放器何时存在、何时允许播放。

## 创建播放器不等于播放

这是最重要的思维转变。

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

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

const shouldPlay =
  isActive &&
  isAppInForeground &&
  isScreenFocused;
```

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

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

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

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

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

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

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

```tsx
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",
});
```

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

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

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

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

```tsx
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 上更稳定。

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

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

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

```tsx
<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`](https://docs.expo.dev/versions/latest/sdk/video/#bufferoptions)，但这个对象里的部分字段是平台专属的。

实际上这意味着：

- `bufferOptions` 这个 API 在 Android 和 iOS 上都存在
- `minBufferForPlayback` 和 `prioritizeTimeOverSizeThreshold` 这类字段，是我这里用到的偏 Android 的调优参数
- `waitsToMinimizeStalling` 是同一个 API 里 iOS 专属的缓冲设置
- [`surfaceType`](https://docs.expo.dev/versions/latest/sdk/video/#surfacetype) 只在 Android 上有效

正是这些让我能够区分：

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

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

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

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

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

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

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

## 横向列表需要播放预算

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

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

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

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

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

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

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

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

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

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

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

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

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

首屏大图（hero）有另一个问题。

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

解决办法是：

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

```tsx
const shouldPlayHero =
  isScreenActive &&
  isHeroVisible &&
  isSettled &&
  !!activeVideoUrl;
```

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

## 结果页需要另一种播放器

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

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

结果页使用一个共享的 `VideoPlayer`，它具备：

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

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

- [`playingChange` 和 `statusChange` 事件概览](https://docs.expo.dev/versions/latest/sdk/video/)
- [`timeUpdateEventInterval`](https://docs.expo.dev/versions/latest/sdk/video/#timeupdateeventinterval)

用法很简单：

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

兜底逻辑也很直接。

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

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

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

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

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

## 真正重要的是什么

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

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

最后一点很重要。

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

更大的收获在于想清楚：

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

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

## 最终效果

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

<div style="display:flex; justify-content:center; margin: 24px 0 32px;">
  <video
    controls
    playsinline
    muted
    loop
    data-autoplay="viewport"
    preload="none"
    poster="/images/blog/expo-video-feed-demo-poster.jpg"
    style="width:100%; max-width:360px; border-radius:24px; box-shadow:0 24px 60px rgba(0,0,0,0.35); background:#000;"
    src="/videos/blog/expo-video-feed/01-vertical-feed-final-demo.mp4"
  >
    你的浏览器不支持 video 标签。
  </video>
</div>

## 写在最后

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

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

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

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

`useVideoPlayer` 和 `VideoView` 走同一条跨平台代码路径，让我能让架构的大部分保持共享，只在平台真正不同的地方分支，比如 Android 的 [`bufferOptions`](https://docs.expo.dev/versions/latest/sdk/video/#bufferoptions)、Android 的 [`surfaceType`](https://docs.expo.dev/versions/latest/sdk/video/#surfacetype)，或者 iOS 的全屏行为。

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

