# TikTok 스타일 피드에서 expo-video 제대로 쓰기

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

# expo-video로 부드러운 TikTok 스타일 영상 피드 만들기

화면에 플레이어가 하나뿐일 때 expo-video는 쉽습니다.

하지만 한 앱에 히어로 영상, 세로 피드, 가로 행, 그리고 제대로 된 컨트롤이 있는 결과 화면이 모두 있으면 어려워집니다.

제 앱이 그런 구조였고, 문제는 사실 "Expo에서 영상을 어떻게 재생하지?"가 아니었습니다.

진짜 문제는 영상이 나오는 곳(surface)이 너무 많이 다른데, 제가 그것들을 전부 같은 것처럼 다루고 있었다는 점이었습니다.

그게 실수였습니다.

어떤 곳은 플레이어를 일찍 만들어야 합니다. 어떤 곳은 포커스를 받았을 때만 재생해야 합니다. 어떤 곳은 사용자가 가까이 올 때까지 썸네일만 보여 줘야 합니다. 어떤 곳은 원격 재생이 멈추면 대체 경로가 필요합니다.

이 글을 쓰게 된 이유는 해결책이 마법 같은 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;
```

두 boolean은 서로 다른 문제를 해결합니다.

- `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의 보편적인 규칙이 아닙니다. 제 경우 미리보기 캐싱이 iOS보다 Android에서 더 안정적이었기 때문에 이 앱에서 내린 결정입니다.

## 썸네일 우선 렌더링은 타협할 수 없습니다

플레이어가 준비되는 동안 피드 셀에 검은 사각형이 보이면, 그것만으로 이미 고장 난 것처럼 느껴집니다.

그래서 항상 썸네일을 기본 레이어로 두고, 첫 프레임이 렌더링된 뒤에만 플레이어를 드러냅니다.

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

이 작은 opacity 게이트가 엄청난 차이를 만듭니다.

영상이 즉시 나타날 필요는 없습니다. 썸네일을 깔끔하게 대체하기만 하면 됩니다.

이 코드에서 중요한 부분은 첫 프레임으로 넘어가는 순간입니다. `textureView` 줄은 Android 전용 렌더링 세부 사항일 뿐입니다.

## 플랫폼별 튜닝: bufferOptions와 surfaceType

이 부분은 조금 더 정확하게 말할 필요가 있습니다.

expo-video는 크로스 플랫폼 [`bufferOptions`](https://docs.expo.dev/versions/latest/sdk/video/#bufferoptions)를 제공하지만, 그 객체 안의 개별 필드 중 일부는 플랫폼 전용입니다.

실제로는 이런 뜻입니다.

- API로서의 `bufferOptions`는 Android와 iOS 모두에 있습니다
- `minBufferForPlayback`이나 `prioritizeTimeOverSizeThreshold` 같은 필드는 제가 여기서 쓴 Android 중심의 튜닝 수단입니다
- `waitsToMinimizeStalling`은 같은 API 안의 iOS 전용 버퍼 설정입니다
- [`surfaceType`](https://docs.expo.dev/versions/latest/sdk/video/#surfacetype)은 Android 전용입니다

덕분에 다음을 구분해서 다룰 수 있었습니다.

- 활성 피드 카드
- 인접 피드 카드
- 상세 화면 플레이어
- 미리보기 플레이어

영상 뷰가 겹치거나 레이어가 쌓이는 전환이 중요한 곳에서 `textureView`를 명시적으로 쓴 것도 그 때문입니다.

Expo 문서에서도 Android에서 `VideoView`가 겹치는 문제의 해결책으로 `surfaceType="textureView"`를 언급합니다.

그러니 제가 이런 코드를 보여 줄 때,

```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]);
```

덕분에 가로 행이 전체 화면 피드보다 훨씬 가볍게 느껴졌습니다.

## 히어로는 피드처럼 동작하면 안 됩니다

히어로에는 다른 문제가 있었습니다.

캐러셀이 인터랙티브하게 느껴지면서도, 멈춰 있을 때는 영상을 보여 주고 싶었습니다.

해결책은 이랬습니다.

- 제스처 중에는 썸네일을 슬라이드합니다
- 활성 영상은 별도의 오버레이로 보여 줍니다
- 드래그하는 동안 영상 오버레이를 서서히 숨깁니다
- 히어로가 보이고, 화면이 활성 상태이고, 제스처가 멈췄을 때만 재생합니다

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

모든 히어로 슬라이드를 살아 있는 플레이어로 유지하려는 것보다 이 방식이 더 잘 동작했습니다.

## 결과 화면에는 다른 플레이어가 필요합니다

모든 곳에서 같은 플레이어 컴포넌트를 쓰지 않았습니다.

음소거된 채 반복 재생되는 미리보기 카드와 전체 결과 화면은 같은 문제가 아닙니다.

결과 화면은 다음을 갖춘 공용 `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는 래퍼 뒤에 둔다
- 플레이어 생성과 재생을 분리한다
- 피드, 행, 히어로, 결과 화면을 서로 다른 곳으로 다룬다
- 기본값은 썸네일 우선으로 한다
- 포커스와 포그라운드 상태에 따라 재생을 허용한다
- 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로 피드 스타일 UI를 만들고 있다면, 저라면 거기서부터 시작하겠습니다.

