# Як змусити expo-video працювати у стрічці в стилі TikTok

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

# Плавна відеострічка в стилі TikTok на expo-video

З expo-video усе просто, коли на екрані лише один плеєр.

Складніше стає, коли в одному застосунку є hero-відео, вертикальна стрічка, горизонтальні ряди та екран результату зі справжніми елементами керування.

Саме таким був мій випадок, і проблема насправді була не в тому, «як відтворити відео в Expo?»

Справжня проблема була в тому, що в мене було забагато різних відеоповерхонь, а я поводився з ними так, ніби це одне й те саме.

У цьому й була помилка.

Деякі поверхні мають створювати плеєр заздалегідь. Деякі мають відтворювати відео лише тоді, коли вони у фокусі. Деякі мають показувати тільки мініатюру, доки користувач не підійде ближче. Деяким потрібен запасний шлях, якщо віддалене відтворення зависає.

Ця стаття з'явилася тому, що рішенням був не один чарівний проп. Рішенням було визначити політику відтворення.

## Чому все так швидко заплутується

Насамперед я розбив проблему на чотири рішення:

- чи має ця поверхня створювати плеєр?
- чи має цей плеєр грати саме зараз?
- наскільки дорогим має бути цей плеєр?
- що користувач має бачити до першого кадру?

Щойно ці рішення стали окремими, про решту архітектури стало набагато простіше міркувати.

## Тримайте expo-video за обгорткою

Ще до будь-яких оптимізацій я загорнув expo-video в обгортку.

Я не хотів, щоб налаштування буфера, поведінка повноекранного режиму, тип поверхні й налаштування плеєра були розкидані по всьому застосунку. Обгортки вистачило, щоб тримати ці рішення в одному місці.

Офіційна документація тут: [документація 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]);
```

Ця частина кросплатформна. Саме вона і змінює поведінку.

На поверхнях прев'ю я також залишив `useCaching` вимкненим на iOS. Це не універсальне правило 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` це налаштування буфера лише для iOS у тому самому API
- [`surfaceType`](https://docs.expo.dev/versions/latest/sdk/video/#surfacetype) існує лише на Android

Саме це дало мені змогу розрізняти:

- активні картки стрічки
- сусідні картки стрічки
- плеєри детального екрана
- плеєри прев'ю

Через це ж я явно використовував `textureView` там, де мали значення відеоподання, що перекриваються, чи шаруваті переходи.

Документація Expo навіть прямо згадує `surfaceType="textureView"` як обхідний шлях для проблем із `VideoView`, що перекриваються, на Android.

Тож коли я показую такий код:

```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 була інша проблема.

Я хотів, щоб карусель відчувалася інтерактивною, але все одно показувала відео, коли вона зупинилася.

Рішення було таким:

- під час жесту гортаються мініатюри
- активне відео показується окремим оверлеєм
- під час перетягування оверлей із відео плавно зникає
- відтворення лише тоді, коли 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.

Якщо ви будуєте UI у стилі стрічки на expo-video, я б почав саме з цього.

