# تشغيل expo-video في feed على طريقة TikTok

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

# بناء feed فيديو سلس على طريقة TikTok باستخدام expo-video

استخدام expo-video سهل عندما يكون على الشاشة مشغّل واحد فقط.

لكنه يصبح أصعب عندما يحتوي التطبيق نفسه على فيديو رئيسي (hero)، وfeed عمودي، وصفوف أفقية، وشاشة نتيجة فيها أدوات تحكم حقيقية.

هكذا كان إعدادي، ولم تكن المشكلة في الحقيقة "كيف أشغّل فيديو في Expo؟"

المشكلة الحقيقية أنه كان لدي عدد كبير من أسطح الفيديو المختلفة، وكنت أعاملها كأنها الشيء نفسه.

هذا كان الخطأ.

بعض الأسطح يجب أن تنشئ المشغّل مبكرًا. وبعضها يجب ألا يشغّل الفيديو إلا عندما يكون في دائرة التركيز. وبعضها يجب أن يبقى صورة مصغّرة فقط حتى يقترب المستخدم منه. وبعضها يحتاج إلى مسار بديل إذا توقف التشغيل عن بُعد.

كتبت هذا المقال لأن الحل لم يكن prop سحريًا واحدًا. الحل كان تحديد سياسة للتشغيل.

## لماذا يصبح الأمر فوضويًا بسرعة

قبل أي شيء آخر، قسّمت المشكلة إلى أربعة قرارات:

- هل يجب أن ينشئ هذا السطح مشغّلًا؟
- هل يجب أن يعمل هذا المشغّل الآن؟
- ما مقدار الكلفة المقبول لهذا المشغّل؟
- ماذا يجب أن يرى المستخدم قبل الإطار الأول؟

عندما فصلت هذه القرارات عن بعضها، أصبح فهم بقية البنية أسهل بكثير.

## ضع expo-video خلف غلاف (wrapper)

قبل تحسين أي شيء، غلّفت expo-video.

لم أرد أن تتبعثر إعدادات الـ buffer وسلوك ملء الشاشة ونوع السطح وإعداد المشغّل في أنحاء التطبيق. وكان غلاف واحد كافيًا لجمع هذه الخيارات في مكان واحد.

التوثيق الرسمي موجود هنا: [توثيق 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,
  },
};
```

هذا الغلاف لا يفعل شيئًا سحريًا. هو فقط يمنحني مكانًا واحدًا لتعريف:

- مشغّل التفاصيل
- مشغّل المعاينة
- المشغّل النشط في الـ feed
- المشغّل المجاور في الـ feed

ملفات الإعداد (profiles) الخاصة بـ Android مهمة، لكنها جزء واحد فقط من الإعداد. المكاسب الأكبر جاءت من التحكم في متى توجد المشغّلات ومتى يُسمح لها بالتشغيل.

## إنشاء المشغّل ليس مثل تشغيله

كان هذا أهم تحول في طريقة تفكيري.

في شاشة الـ feed، توقفت عن معاملة إنشاء المشغّل والتشغيل كأنهما الشيء نفسه.

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

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

هاتان القيمتان المنطقيتان تحلان مشكلتين مختلفتين.

- `shouldCreatePlayer` تجيب عن سؤال: هل يستحق هذا السطح مشغّلًا أصلًا؟
- `shouldPlay` تجيب عن سؤال: هل يجب أن يعمل هذا المشغّل الآن؟

هذا التمييز مهم جدًا في الـ feed.

إذا تجاهلته، فغالبًا ستنتهي بعدد كبير من المشغّلات، وتحميل مسبق (buffering) كثير، وعمل كثير بلا فائدة.

## الحالة النشطة والمجاورة في الـ feed العمودي

في الـ feed الرئيسي، لا أنشئ مشغّلات إلا للعنصر النشط والعناصر المجاورة له.

هذا يجعل البطاقة النشطة تبدو فورية من دون دفع الكلفة الكاملة للقائمة كلها.

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

البطاقة النشطة تحصل على الـ profile الأكثر سخاءً.

والبطاقة المجاورة تحصل على profile أرخص لأنها قد لا تصبح أبدًا البطاقة الأساسية.

لكن الجزء الأهم يبقى قاعدة التشغيل، لا قاعدة الـ buffer.

أكتم صوت العناصر غير النشطة وأوقفها مؤقتًا فورًا:

```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.

## العرض بالصورة المصغّرة أولًا أمر لا تفاوض فيه

إذا عرضت خلية في الـ feed مستطيلًا أسود بينما يستعد المشغّل، فهي تبدو معطوبة من البداية.

لذلك أُبقي دائمًا الصورة المصغّرة طبقة أساسية، ولا أُظهر المشغّل إلا بعد عرض الإطار الأول.

```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) على كل المنصات، لكن بعض الحقول داخل هذا الكائن خاصة بمنصة معينة.

عمليًا، هذا يعني:

- `bufferOptions` كـ API موجودة على Android وiOS معًا
- حقول مثل `minBufferForPlayback` و`prioritizeTimeOverSizeThreshold` هي أدوات الضبط الموجهة إلى Android التي استخدمتها هنا
- `waitsToMinimizeStalling` إعداد buffer خاص بـ iOS في الـ API نفسها
- [`surfaceType`](https://docs.expo.dev/versions/latest/sdk/video/#surfacetype) خاصة بـ Android فقط

هذا ما أتاح لي التمييز بين:

- بطاقات الـ feed النشطة
- بطاقات الـ feed المجاورة
- مشغّلات التفاصيل
- مشغّلات المعاينة

ولهذا أيضًا استخدمت `textureView` صراحةً في الأماكن التي كانت فيها عروض الفيديو المتداخلة أو الانتقالات متعددة الطبقات مهمة.

بل إن توثيق Expo يذكر `surfaceType="textureView"` كحل التفافي لمشكلات تداخل `VideoView` على Android.

لذا عندما أعرض كودًا كهذا:

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

فهذا القسم يتعلق فعلًا بضبط كلفة التشغيل على Android، وليس الحل كله.

الحل الكامل يبقى سياسة دورة الحياة حول الإنشاء والتشغيل والإيقاف المؤقت وكتم الصوت والمسار البديل.

## الصفوف الأفقية تحتاج إلى ميزانية تشغيل

لم يكن الـ feed سطح الفيديو الوحيد في التطبيق.

كانت لدي أيضًا صفوف أفقية في الشاشة الرئيسية، وهذه الصفوف لا يمكن أن تتصرف مثل TikTok. إذا حصلت كل بطاقة ظاهرة في كل صف ظاهر على مشغّل، فستستهلك ذاكرة كبيرة جدًا لسطح لا يحتاج إليها.

لذا أضفت ميزانية تشغيل على مستوى الصف.

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

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

أعطاني ذلك قاعدة بسيطة:

- أول بضع بطاقات مؤهلة فقط في الصفوف الظاهرة تحصل على مشغّلات
- كل ما عداها يبقى صورة مصغّرة فقط

وأخّرت أيضًا إزالة المشغّل (unmount) قليلًا عندما تفقد البطاقة أهليتها، حتى لا تؤدي التغيرات السريعة حول الحد إلى إنشاء المشغّلات وحذفها بشكل مفرط.

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

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

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

جعل ذلك الصفوف الأفقية أقل كلفة بكثير من الـ feed بملء الشاشة.

## الواجهة الرئيسية (hero) لا يجب أن تتصرف مثل الـ feed

كانت للـ hero مشكلة مختلفة.

أردت أن يبدو الـ carousel تفاعليًا، مع عرض الفيديو عندما يستقر.

الحل كان:

- تحريك الصور المصغّرة أثناء الإيماءة
- عرض الفيديو النشط كطبقة منفصلة فوقها
- إخفاء طبقة الفيديو تدريجيًا أثناء السحب
- عدم التشغيل إلا عندما يكون الـ 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 إلى مجلد الـ cache وأبدّل المصدر.

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

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

هذا لا يتعلق بتحسينات دقيقة. يتعلق بجعل شاشة النتيجة موثوقة.

إذا فُتحت نتيجة مكتملة وتوقف التشغيل، فستبدو الميزة كلها معطوبة.

## ما الذي كان مهمًا فعلًا

لو اضطررت إلى تلخيص الإعداد كله في بضع قواعد عملية، فستكون هذه:

- ضع expo-video خلف غلاف
- افصل إنشاء المشغّل عن التشغيل
- عامل الـ feed والصفوف والـ hero وشاشات النتائج كأسطح مختلفة
- اجعل الصور المصغّرة هي الخيار الافتراضي أولًا
- اربط التشغيل بحالة التركيز وبوجود التطبيق في المقدمة
- استخدم ملفات buffer الخاصة بـ Android كتفصيل، لا كالاستراتيجية كلها
- أضف مسارًا بديلًا لأسطح التشغيل المهمة

النقطة الأخيرة مهمة.

هذا المقال لا يتعلق فعلًا بخيار buffer واحد في Android.

المكسب الأكبر كان تحديد:

- أين يجب أن يوجد المشغّل
- متى يجب أن يعمل
- متى يجب أن يبقى مكتومًا
- متى تكون الصورة المصغّرة الخيار الافتراضي الأفضل
- أي الأسطح تستحق مسارًا للتعافي

عندما تقبّلت ذلك، أصبحت البنية أنظف بكثير.

## النتيجة النهائية

هكذا بدا الـ feed بعد فصل إنشاء المشغّل عن التشغيل وإبقاء العنصر النشط الأولوية الحقيقية الوحيدة:

<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>
</div>

## أفكار أخيرة

لم يكن expo-video نفسه هو الجزء الصعب هنا.

الجزء الصعب كان أن أكون صادقًا بشأن عدد أسطح الفيديو المختلفة الموجودة فعلًا في التطبيق.

عندما توقفت عن معاملتها كلها بالطريقة نفسها، بدأ الـ feed يبدو أفضل بكثير.

وإنصافًا لـ expo-video، عندما اتضحت سياسة التشغيل، قامت المكتبة نفسها بعملها على أكمل وجه.

وجود `useVideoPlayer` و`VideoView` في مسار كود واحد لكل المنصات جعل من الممكن إبقاء معظم البنية مشتركة، وعدم التفرع إلا حيث تختلف المنصات فعلًا، مثل [`bufferOptions`](https://docs.expo.dev/versions/latest/sdk/video/#bufferoptions) في Android، و[`surfaceType`](https://docs.expo.dev/versions/latest/sdk/video/#surfacetype) في Android، أو سلوك ملء الشاشة في iOS.

إذا كنت تبني واجهة على شكل feed باستخدام expo-video، فمن هنا سأبدأ.

