
چندسالی هست که میخوام در مورد کتابخونهای بنویسم که برای پایان دادن کارهای نهاییش چند ماه اخیر وقت زیادی ازم گرفته و خیلی چیزها هم به واسطه تولیدش ازش یاد گرفتم. اسمش rn-vlc-plyr هست، یه پلیر صوت و تصویر برای React Native که موتورش VLC هست. توی این مقاله یکم از تاریخچهاش میگم، بعد اینکه چرا VLC و چرا Nitro، بعد نصب و استفاده، و آخرش اینکه زمان پخش رو چطوری نشون بدیم.
ماجرا از اینجا شروع شد که توی یه اپ React Native لازم داشتم فایلهای MKV با چند تا ترک صدا و زیرنویس پخش بشه یا حتی با فرمتهای دیگه مثل MP4 و MOV که اصلا مشخص نبود و بکند نمیتونست مشخص کنه فرمت فایل صوتی تصویری چیه. یک نیاز دیگه هم داشتم که به استریمRTSP از دوربین هم نیاز داشت. پلیرهای معمول React Native روی AVPlayer توی iOS و ExoPlayer توی اندروید سوار هستن، یعنی اینکه چی پخش میشه و چی نه، بستگی به گوشی داره. یه گوشی فایل رو پخش میکنه، اون یکی ارور میده. ولی VLC کدکهاش رو با خودش میاره و براش فرقی نمیکنه گوشی چیه.
حال حوصله ندارید؟ کدها روی گیتهاب هست و پکیجش هم روی npm.
داستان این کتابخونه خیلی قدیمیتر از نسخه ۱.۰ هست. ریپوش رو اواسط مرداد ۱۳۹۹ ساختم و اسمش اول react-native-video-spieler بود. آره، آلمانی! Spieler یعنی پخش کننده. با @react-native-community/bob روی React Native 0.62 اسکفولدش کرده بودم.
مهر همون سال ۹۹ اسمش رو گذاشتم react-native-ir-player و بردمش زیر iran-react-community توی گیتهاب. پاییز همون سال با مازیار سعادتفر سمت iOS رو با MobileVLCKit و Swift نوشتیم، play و pause، رویدادها، وضعیت پارس شدن فایل و صدا. اصل زحمتش رو هم مازیار کشید، من هم تایپهای TypeScript، اپ نمونه، تم، آیکونها و لوگو رو درست کردم. آخرین کامیت اون دوره اواسط آذر ۹۹ بود. سمت اندروید هیچ وقت به VLC نرسید و کار همونجا موند و به دلایل مالی پیش نرفت.
در آخرین روزهای سال ۱۴۰۰، و بهتره بگم که دقیقا روز آخر سال، دوباره سراغش رفتم. اسمش رو ساده کردم و شد همین rn-vlc-plyr و ریپو رو آوردم توی اکانت خودم. اول react-native-ir-player نسخه 0.1.1 رو روی npm یک انتشار تستی کردم و سریع unpublish کردم، ولی باز هم کار جدیای روش انجام نشد.
دوباره آذر ۱۴۰۴ برنچهای قدیمی رو پاک کردم و با یه اسکفولد تازه از اول شروع کردم. این بار یه کامپوننت Fabric روی React Native 0.81 بود، url و loop و muted و autoPlay همه prop های خودِ ویو بودن و play و pause و seek کامندهای نیتیو که با ref ویو صدا میزدید. این بار اندروید هم با VLC-Android راه افتاد. آخر آذر ماه بود که داشتم CI/CD رو با GitHub Actions و انتشار بدون توکن یا همون OIDC درست میکردم و راستش رو بخواید از 0.2.1 تا 0.2.9-beta.1کلی تگ زدم تا ساعتها بعد از نیمه شب بالاخره npm یکیش رو قبول کرد. بعدش چند تا بتا دیگه تا ۵ دی، و رویداد onError که سمت اندرویدش تازه بهمن رسید. چه روزهایی بود 💔 بعد هم که جنگ شد و پروژه چند ماهی خاک خورد تا این روزها.
مهر ۱۴۰۵ که برگشتم سراغش، دیدم مشکل یکی دو تا باگ نیست، مشکل ساختارشه. پلیر داخل خودِ ویو زندگی میکرد، پس هر ویو دوم، مثلا تمام صفحه، یعنی یه پلیر دوم و لود دوباره فایل. اسکفولد هم قدیمی شده بود. برای همین دل رو زدم به دریا و از صفر شروع کردم. تاریخچه قدیمی رو توی برنچ legacy و تگ legacy-v0.2.0 نگه داشتم که چیزی گم نشه، و یه برنچ یتیم orphanبا اسکفولد جدید و Nitro Modules ساختم. ۱۵ مهر نسخه 1.0.0 منتشر شد و فرداش هم 1.0.1 با یه فیکس برای اندروید. که شد نسخه پایدار این کتابخونه.
توی iOS از MobileVLCKit 3.7 استفاده میکنه و توی اندروید از libvlc-android 3.7. هر دو از یه خانوادهان،libvlc 3، پس موتور دو طرف یه جور رفتار میکنه. نسخه ۴ هنوز آلفا هست و فعلا دست بهش نزدم. هزینه هم داره البته، حدود ۴۰ مگ به اپ iOS اضافه میکنه و حدود ۲۵ مگ برای هر ABI توی اندروید.
برای پل بین جاوااسکریپت و نیتیو سه تا گزینه داشتم: Fabric codegen، Expo Modules API و Nitro Modules. میخواستم Swift و Kotlin خالص باشه، سرعت JSI داشته باشه و اپهای بدون Expo هم بتونن استفادهاش کنن. Nitro همه اینها رو داشت. یه spec تایپاسکریپتی مینویسم و Nitro کدهای تایپ شده Swift و Kotlin رو ازش میسازه، اینطوری دو تا پلتفرم نمیتونن خیلی از هم دور بشن.
چیزی که من خیلی خیلی دوستش دارم getter های همزمان یا همون synchronous هست. player.currentTime رو که میخونید، همون لحظه مقدار رو دارید، نه Promise ی، نه await ی. برای نوار پیشرفت پلیر عالیه. ولی بگما، Nitro هنوز به 1.0.0 نرسیده و فقط روی معماری جدید کار میکنه.
یه تصمیم مهم دیگه هم این بود که پلیر یه آبجکت جداست و ویو فقط نشونش میده. یعنی یه پلیر رو چند تا ویو میتونن نشون بدن و وقتی تمام صفحه میکنید فایل دوباره لود نمیشه. همون مشکلی که نسخه قدیمی داشت.

حداقلها: React Native 0.79 با معماری جدید، یا Expo SDK 53 با development build، iOS 16 و اندروید API 24. معماری قدیمی، Expo Go و وب پشتیبانی نمیشن.
برای پروژه بدون Expo همین نسخهها رو نصب کنید، من با هم تستشون کردم:
yarn add [email protected] [email protected] cd ios && pod install
اگر Expo دارید باید development build بگیرید، چون Expo Go کد نیتیو جدید رو لود نمیکنه:
npx expo install rn-vlc-plyr react-native-nitro-modules npx expo prebuild npx expo run:android
یه فایل بسازید به اسم Player.tsx و کد زیر رو داخلش بذارید:
import { StyleSheet, Button, View } from 'react-native'; import { VlcPlayerView, useVlcPlayer, useVlcPlayerStatus } from 'rn-vlc-plyr'; export const Player = () => { const player = useVlcPlayer('https://example.com/movie.mkv', (p) => { p.loop = true; }); const status = useVlcPlayerStatus(player); return ( <View> <VlcPlayerView player={player} style={styles.video} resizeMode="contain" /> <Button title={status === 'playing' ? 'Pause' : 'Play'} onPress={() => (status === 'playing' ? player.pause() : player.play())} /> </View> ); } const styles = StyleSheet.create({ video: { width: '100%', aspectRatio: 16 / 9 }, });
خیلی کوتاه بگم: useVlcPlayer پلیر رو میسازه و موقع unmount آزادش میکنه، تابع دومش فقط یه بار قبل از اولین فایل اجرا میشه، پس loop و volume و autoPlay رو اونجا بذارید. useVlcPlayerStatus وضعیت فعلی رو میده، و VlcPlayerView هم فقط نقش صفحه نمایش رو داره. ترکها، زیرنویس بیرونی، snapshot و رویدادها توی README هست، دیگه اینجا تکرارشون نمیکنم.
اولین چیزی که هر کسی بعد از گذاشتن پلیر روی صفحه میسازه، یه نوار پیشرفت هست و یه متن که زمان پخش رو نشون بده، همون 05:12 / 47:30 معروف. چند تا چیز توی این کتابخونه کار رو راحت میکنه:
همه زمانها روی هر دو پلتفرم میلی ثانیه و عدد صحیح هستن، دیگه یه طرف ثانیه و یه طرف میلی ثانیه نیست.
موقع پخش، رویداد timeUpdate هر ۲۵۰ میلی ثانیه میاد. اگر فقط ثانیهها رو نشون میدید، میتونید timeUpdateInterval رو بکنید 1000 که رندر الکی نداشته باشید.
بعد از هر seek دقیقا یه timeUpdate با زمان جدید میاد و بعد از stop یکی با صفر، پس نوار پیشرفت این ور اون ور نمیپره.
player.currentTime و player.isLive همزمان یا همون synchronous هستن، هر وقت بخونیدشون همون لحظه جواب دارید.
یه نکته هم در مورد فرمت بگم. اگر فیلم یک ساعت یا بیشتر باشه زمان رو hh:mm:ss نشون میدم و اگر کمتر باشه mm:ss. ملاک هم مدت کل فیلم هست نه زمان فعلی، چون اگر زمان فعلی ملاک باشه، یه فیلم دو ساعته اولش 05:12 نشون میده و یهو میشه 01:00:00، متن پهنتر میشه و همه چیزِ کنارش تکون میخوره. تابع formatVlcTime خود کتابخونه بر اساس خودِ زمان تصمیم میگیره، برای همین اینجا یه تابع کوچیک خودم نوشتم. یه فایل بسازید به اسم PlayingTime.tsx و کد زیر رو داخلش بذارید (اسلایدرش هم @react-native-community/slider هست):
import Slider from '@react-native-community/slider'; import { useState } from 'react'; import { Text, View } from 'react-native'; import { useVlcPlayerEvent, type VlcPlayer } from 'rn-vlc-plyr'; const ONE_HOUR = 60 * 60 * 1000; const pad = (value: number) => String(value).padStart(2, '0'); const formatTime = (ms: number, duration: number) => { const totalSeconds = Math.floor(ms / 1000); const hours = Math.floor(totalSeconds / 3600); const minutes = Math.floor((totalSeconds % 3600) / 60); const seconds = totalSeconds % 60; return duration >= ONE_HOUR ? `${pad(hours)}:${pad(minutes)}:${pad(seconds)}` : `${pad(minutes)}:${pad(seconds)}`; } type PlayingTimeProps = { player: VlcPlayer; }; export const PlayingTime = ({ player }: { player: VlcPlayer }) => { const [time, setTime] = useState({ currentTime: 0, duration: 0 }); useVlcPlayerEvent(player, 'timeUpdate', setTime); if (player.isLive) { return <Text>LIVE</Text>; } return ( <View> <Slider minimumValue={0} maximumValue={Math.max(time.duration, 1)} value={time.currentTime} onSlidingComplete={(value) => player.seek(value)} /> <Text> {formatTime(time.currentTime, time.duration)} / {formatTime(time.duration, time.duration)} </Text> </View> ); }
اگر duration صفر باشه یعنی یا فایل هنوز لود نشده یا پخش زنده هست، برای همین isLive رو جدا چک کردم که جای زمان، LIVE نشون بده.

یه نکته هم بگم که سکته نکنید: اولین باری که زیرنویس نشون داده میشه، VLC یه کش فونت میسازه که روی نصب تازه ممکنه بیشتر از ۱۵ ثانیه طول بکشه. اپ هنگ نکرده، داره کش میسازه.
نصبش کنید، عجیبترین فایل MKV که دارید رو باهاش پخش کنید و بهم بگید چی شد. اگر مشکلی بود توی گیتهاب issue باز کنید یا همین زیر کامنت بذارید، دربست در خدمتم. اگر هم چیزی رو درست کردید PR بدید، خیلی خوشحال میشم.
امیدوارم به دردتون بخوره، شاد و موفق باشید.