ブログ

TikTok風フィードでexpo-videoをうまく動かす

2026年1月10日 11分で読めます

TikTok風フィードでexpo-videoを快適に動かした方法。プレイヤーの作成と再生を分け、フィード、ヒーロー、行、結果画面を別々のサーフェスとして扱います。

TikTok風フィードでexpo-videoをうまく動かす
ExpoReact Nativeexpo-videoパフォーマンス動画

expo-videoでなめらかなTikTok風動画フィードを作る

画面にプレイヤーがひとつしかないなら、expo-videoは簡単です。

難しくなるのは、同じアプリの中にヒーロー動画、縦型フィード、横スクロールの行、そして本格的なコントロールを持つ結果画面がある場合です。

それが私の構成でした。そして問題は「Expoで動画をどう再生するか?」ではありませんでした。

本当の問題は、動画を表示する場所(サーフェス)があまりにも多く、それらをすべて同じものとして扱っていたことでした。

それが間違いでした。

早めにプレイヤーを作るべきサーフェスもあれば、フォーカスされたときだけ再生すべきものもあります。ユーザーが近づくまでサムネイルだけにしておくべきものもあります。リモート再生が止まったときのためにフォールバックの経路が必要なものもあります。

この記事を書いたのは、解決策がひとつの魔法のpropではなかったからです。解決策は、再生ポリシーを定義することでした。

なぜすぐに散らかるのか

まず、問題を4つの判断に分けました。

  • このサーフェスはプレイヤーを作るべきか?
  • このプレイヤーは今再生しているべきか?
  • このプレイヤーにどれくらいコストをかけるべきか?
  • 最初のフレームが出るまで、ユーザーは何を見るべきか?

これらの判断を分けてから、残りのアーキテクチャがずっと考えやすくなりました。

expo-videoはラッパーの裏に置く

何かを最適化する前に、expo-videoをラップしました。

バッファ設定、フルスクリーンの挙動、サーフェスの種類、プレイヤーのセットアップがアプリ中に散らばるのは避けたかったのです。それらの選択を一か所にまとめておくには、ラッパーで十分でした。

公式ドキュメントはこちらです。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;

この2つのbooleanは、別々の問題を解決します。

  • 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の普遍的なルールではありません。私の場合、プレビューのキャッシュはiOSよりAndroidのほうが安定していたので、このアプリのための判断です。

サムネイルを先に描画するのは譲れない

プレイヤーの準備中にフィードのセルが黒い四角を表示したら、その時点で壊れているように感じられます。

なので、常にサムネイルをベースのレイヤーとして置き、最初のフレームが描画されてからプレイヤーを表示します。

<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を提供していますが、そのオブジェクトの中の個々のフィールドには、プラットフォーム固有のものもあります。

実際には、次のような意味です。

  • APIとしてのbufferOptionsはAndroidとiOSの両方にある
  • minBufferForPlaybackやprioritizeTimeOverSizeThresholdのようなフィールドは、ここで私が使ったAndroid向けのチューニング項目
  • waitsToMinimizeStallingは、同じAPIの中のiOS固有のバッファ設定
  • surfaceTypeはAndroid専用

これによって、次のものを区別できました。

  • アクティブなフィードのカード
  • 隣接するフィードのカード
  • 詳細画面のプレイヤー
  • プレビューのプレイヤー

動画のビューが重なる場所や、レイヤーを重ねたトランジションが重要な場所で、明示的にtextureViewを使ったのもこのためです。

Expoのドキュメントでも、AndroidでVideoViewが重なる問題の回避策としてsurfaceType="textureView"が挙げられています。

なので、次のようなコードを見せるとき、

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

これで横スクロールの行は、全画面のフィードよりずっと軽く感じられるようになりました。

ヒーローはフィードと同じように振る舞うべきではない

ヒーローには別の問題がありました。

カルーセルをインタラクティブに感じさせつつ、止まっているときには動画を見せたかったのです。

解決策は次のとおりです。

  • ジェスチャー中はサムネイルをスライドさせる
  • アクティブな動画は別のオーバーレイとして表示する
  • ドラッグ中は動画のオーバーレイをフェードアウトする
  • ヒーローが見えていて、画面がアクティブで、ジェスチャーが落ち着いているときだけ再生する
const shouldPlayHero =
  isScreenActive &&
  isHeroVisible &&
  isSettled &&
  !!activeVideoUrl;

これは、ヒーローのすべてのスライドを生きたプレイヤーとして保とうとするよりうまくいきました。

結果画面には別のプレイヤーが必要

どこでも同じプレイヤーコンポーネントを使ったわけではありません。

ミュートでループするプレビューカードと、全画面の結果画面は、同じ問題ではありません。

結果画面では、次の機能を持つ共有の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はラッパーの裏に置く
  • プレイヤーの作成と再生を分ける
  • フィード、行、ヒーロー、結果画面を別々のサーフェスとして扱う
  • デフォルトはサムネイルを先に出す
  • 再生はフォーカスとフォアグラウンドの状態で制御する
  • Androidのバッファプロファイルは戦略のすべてではなく、細部として使う
  • 重要な再生サーフェスにはフォールバックの経路を用意する

最後の点は重要です。

この記事は、実はAndroidのバッファのフラグひとつについての話ではありません。

より大きな勝利は、次のことを決めたことでした。

  • どこにプレイヤーを置くべきか
  • いつ再生すべきか
  • いつミュートのままにすべきか
  • いつサムネイルのほうが良いデフォルトなのか
  • どのサーフェスに復旧の経路が必要か

それを受け入れてから、アーキテクチャはずっとすっきりしました。

最終結果

プレイヤーの作成と再生を分け、アクティブなアイテムだけを本当の優先対象にしたあとのフィードは、こんな感じになりました。

おわりに

ここで難しかったのは、expo-videoそのものではありませんでした。

難しかったのは、アプリに実際いくつの異なる動画サーフェスがあるのかに正直に向き合うことでした。

それらをすべて同じように扱うのをやめたら、フィードはずっと良く感じられるようになりました。

expo-videoの名誉のために言っておくと、再生ポリシーが明確になってからは、ライブラリ自体はとてもよく仕事をしてくれました。

useVideoPlayerとVideoViewがひとつのクロスプラットフォームのコードパスにあったおかげで、アーキテクチャの大部分を共有したまま、AndroidのbufferOptions、AndroidのsurfaceType、iOSのフルスクリーンの挙動のように、プラットフォームが実際に異なる部分でだけ分岐できました。

expo-videoでフィード型のUIを作っているなら、私ならそこから始めます。