بناء feed فيديو سلس على طريقة TikTok باستخدام expo-video
استخدام expo-video سهل عندما يكون على الشاشة مشغّل واحد فقط.
لكنه يصبح أصعب عندما يحتوي التطبيق نفسه على فيديو رئيسي (hero)، وfeed عمودي، وصفوف أفقية، وشاشة نتيجة فيها أدوات تحكم حقيقية.
هكذا كان إعدادي، ولم تكن المشكلة في الحقيقة "كيف أشغّل فيديو في Expo؟"
المشكلة الحقيقية أنه كان لدي عدد كبير من أسطح الفيديو المختلفة، وكنت أعاملها كأنها الشيء نفسه.
هذا كان الخطأ.
بعض الأسطح يجب أن تنشئ المشغّل مبكرًا. وبعضها يجب ألا يشغّل الفيديو إلا عندما يكون في دائرة التركيز. وبعضها يجب أن يبقى صورة مصغّرة فقط حتى يقترب المستخدم منه. وبعضها يحتاج إلى مسار بديل إذا توقف التشغيل عن بُعد.
كتبت هذا المقال لأن الحل لم يكن prop سحريًا واحدًا. الحل كان تحديد سياسة للتشغيل.
لماذا يصبح الأمر فوضويًا بسرعة
قبل أي شيء آخر، قسّمت المشكلة إلى أربعة قرارات:
- هل يجب أن ينشئ هذا السطح مشغّلًا؟
- هل يجب أن يعمل هذا المشغّل الآن؟
- ما مقدار الكلفة المقبول لهذا المشغّل؟
- ماذا يجب أن يرى المستخدم قبل الإطار الأول؟
عندما فصلت هذه القرارات عن بعضها، أصبح فهم بقية البنية أسهل بكثير.
ضع expo-video خلف غلاف (wrapper)
قبل تحسين أي شيء، غلّفت expo-video.
لم أرد أن تتبعثر إعدادات الـ buffer وسلوك ملء الشاشة ونوع السطح وإعداد المشغّل في أنحاء التطبيق. وكان غلاف واحد كافيًا لجمع هذه الخيارات في مكان واحد.
التوثيق الرسمي موجود هنا: توثيق 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,
},
};
هذا الغلاف لا يفعل شيئًا سحريًا. هو فقط يمنحني مكانًا واحدًا لتعريف:
- مشغّل التفاصيل
- مشغّل المعاينة
- المشغّل النشط في الـ feed
- المشغّل المجاور في الـ feed
ملفات الإعداد (profiles) الخاصة بـ Android مهمة، لكنها جزء واحد فقط من الإعداد. المكاسب الأكبر جاءت من التحكم في متى توجد المشغّلات ومتى يُسمح لها بالتشغيل.
إنشاء المشغّل ليس مثل تشغيله
كان هذا أهم تحول في طريقة تفكيري.
في شاشة الـ feed، توقفت عن معاملة إنشاء المشغّل والتشغيل كأنهما الشيء نفسه.
const shouldCreatePlayer =
isTransitionFinished &&
(isActive || isAdjacent) &&
!!videoUrl;
const shouldPlay =
isActive &&
isAppInForeground &&
isScreenFocused;
هاتان القيمتان المنطقيتان تحلان مشكلتين مختلفتين.
shouldCreatePlayerتجيب عن سؤال: هل يستحق هذا السطح مشغّلًا أصلًا؟shouldPlayتجيب عن سؤال: هل يجب أن يعمل هذا المشغّل الآن؟
هذا التمييز مهم جدًا في الـ feed.
إذا تجاهلته، فغالبًا ستنتهي بعدد كبير من المشغّلات، وتحميل مسبق (buffering) كثير، وعمل كثير بلا فائدة.
الحالة النشطة والمجاورة في الـ feed العمودي
في الـ feed الرئيسي، لا أنشئ مشغّلات إلا للعنصر النشط والعناصر المجاورة له.
هذا يجعل البطاقة النشطة تبدو فورية من دون دفع الكلفة الكاملة للقائمة كلها.
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.
أكتم صوت العناصر غير النشطة وأوقفها مؤقتًا فورًا:
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 مستطيلًا أسود بينما يستعد المشغّل، فهي تبدو معطوبة من البداية.
لذلك أُبقي دائمًا الصورة المصغّرة طبقة أساسية، ولا أُظهر المشغّل إلا بعد عرض الإطار الأول.
<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 على كل المنصات، لكن بعض الحقول داخل هذا الكائن خاصة بمنصة معينة.
عمليًا، هذا يعني:
bufferOptionsكـ API موجودة على Android وiOS معًا- حقول مثل
minBufferForPlaybackوprioritizeTimeOverSizeThresholdهي أدوات الضبط الموجهة إلى Android التي استخدمتها هنا waitsToMinimizeStallingإعداد buffer خاص بـ iOS في الـ API نفسهاsurfaceTypeخاصة بـ Android فقط
هذا ما أتاح لي التمييز بين:
- بطاقات الـ feed النشطة
- بطاقات الـ feed المجاورة
- مشغّلات التفاصيل
- مشغّلات المعاينة
ولهذا أيضًا استخدمت textureView صراحةً في الأماكن التي كانت فيها عروض الفيديو المتداخلة أو الانتقالات متعددة الطبقات مهمة.
بل إن توثيق Expo يذكر surfaceType="textureView" كحل التفافي لمشكلات تداخل VideoView على Android.
لذا عندما أعرض كودًا كهذا:
const player = useAppVideoPlayer(videoSource, {
loop: true,
muted: true,
androidBufferProfile: isActive
? "feed-active"
: "feed-adjacent",
});
فهذا القسم يتعلق فعلًا بضبط كلفة التشغيل على Android، وليس الحل كله.
الحل الكامل يبقى سياسة دورة الحياة حول الإنشاء والتشغيل والإيقاف المؤقت وكتم الصوت والمسار البديل.
الصفوف الأفقية تحتاج إلى ميزانية تشغيل
لم يكن الـ feed سطح الفيديو الوحيد في التطبيق.
كانت لدي أيضًا صفوف أفقية في الشاشة الرئيسية، وهذه الصفوف لا يمكن أن تتصرف مثل TikTok. إذا حصلت كل بطاقة ظاهرة في كل صف ظاهر على مشغّل، فستستهلك ذاكرة كبيرة جدًا لسطح لا يحتاج إليها.
لذا أضفت ميزانية تشغيل على مستوى الصف.
const remainingSlots = heroVisible ? 3 : 4;
const rowBudget = Math.min(2, remainingSlots);
const shouldPlayCard =
isRowVisible &&
isCardVisibleHorizontally &&
cardIndex < rowBudget;
أعطاني ذلك قاعدة بسيطة:
- أول بضع بطاقات مؤهلة فقط في الصفوف الظاهرة تحصل على مشغّلات
- كل ما عداها يبقى صورة مصغّرة فقط
وأخّرت أيضًا إزالة المشغّل (unmount) قليلًا عندما تفقد البطاقة أهليتها، حتى لا تؤدي التغيرات السريعة حول الحد إلى إنشاء المشغّلات وحذفها بشكل مفرط.
useEffect(() => {
if (shouldPlay) {
setShouldRenderVideo(true);
return;
}
const timeout = setTimeout(() => {
setShouldRenderVideo(false);
}, 180);
return () => clearTimeout(timeout);
}, [shouldPlay]);
جعل ذلك الصفوف الأفقية أقل كلفة بكثير من الـ feed بملء الشاشة.
الواجهة الرئيسية (hero) لا يجب أن تتصرف مثل الـ feed
كانت للـ hero مشكلة مختلفة.
أردت أن يبدو الـ carousel تفاعليًا، مع عرض الفيديو عندما يستقر.
الحل كان:
- تحريك الصور المصغّرة أثناء الإيماءة
- عرض الفيديو النشط كطبقة منفصلة فوقها
- إخفاء طبقة الفيديو تدريجيًا أثناء السحب
- عدم التشغيل إلا عندما يكون الـ hero ظاهرًا، والشاشة نشطة، والإيماءة قد استقرت
const shouldPlayHero =
isScreenActive &&
isHeroVisible &&
isSettled &&
!!activeVideoUrl;
نجح هذا أكثر من محاولة إبقاء كل شريحة في الـ hero مشغّلًا حيًا.
شاشة النتيجة تحتاج إلى مشغّل مختلف
لم أستخدم مكوّن المشغّل نفسه في كل مكان.
بطاقات المعاينة المكتومة المتكررة وشاشة النتيجة الكاملة ليستا المشكلة نفسها.
تستخدم شاشة النتيجة VideoPlayer مشتركًا يحتوي على:
- أدوات التحكم في التشغيل
- مستمعات
playingChange - مستمعات
timeUpdate - مستمعات
statusChange - دعم ملء الشاشة على iOS
- تشغيل من المصدر البعيد أولًا مع بديل محلي
إذا كنت تستخدم هذه الأحداث، فهذه صفحات توثيق Expo ذات الصلة:
الاستخدام بسيط:
<VideoPlayer
uri={videoUrl}
controlsVariant="playback"
muted={false}
loop={false}
androidBufferProfile="detail"
iosAllowFullscreen
fallbackToLocal
fallbackTimeoutMs={8000}
/>
منطق المسار البديل مباشر.
إذا بقي المشغّل في حالة التحميل وقتًا طويلًا قبل أول تحميل ناجح، أو إذا انتقل إلى حالة خطأ، أنزّل ملف MP4 إلى مجلد الـ cache وأبدّل المصدر.
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 بعد فصل إنشاء المشغّل عن التشغيل وإبقاء العنصر النشط الأولوية الحقيقية الوحيدة:
أفكار أخيرة
لم يكن expo-video نفسه هو الجزء الصعب هنا.
الجزء الصعب كان أن أكون صادقًا بشأن عدد أسطح الفيديو المختلفة الموجودة فعلًا في التطبيق.
عندما توقفت عن معاملتها كلها بالطريقة نفسها، بدأ الـ feed يبدو أفضل بكثير.
وإنصافًا لـ expo-video، عندما اتضحت سياسة التشغيل، قامت المكتبة نفسها بعملها على أكمل وجه.
وجود useVideoPlayer وVideoView في مسار كود واحد لكل المنصات جعل من الممكن إبقاء معظم البنية مشتركة، وعدم التفرع إلا حيث تختلف المنصات فعلًا، مثل bufferOptions في Android، وsurfaceType في Android، أو سلوك ملء الشاشة في iOS.
إذا كنت تبني واجهة على شكل feed باستخدام expo-video، فمن هنا سأبدأ.