video.js یک کتابخانه متن باز جاوااسکریپت برای پخش ویدیو و صدا توی صفحه های وب هست. روی تگ استاندارد video یه پلیر یکدست با کنترل ها، زیرنویس و امکان شخصی سازی می ذاره. اگه می خوای ظاهر و رفتار پخش ویدیو روی همه مرورگرها یکسان باشه، گزینه خوبیه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
video.js یکی از قدیمی ترین و شناخته شده ترین پلیرهای متن باز وب هست. مشکلی که حل می کنه رو ساده می شه گفت: تگ video خام هر مرورگر ظاهر و کنترل های خودش رو داره و امکاناتش هم محدوده. video.js یه لایه پلیر روی همین تگ می ذاره و کنترل ها، ظاهر و رفتار رو بین مرورگرها یکدست می کنه. زیرنویس، تغییر سرعت پخش، تمام صفحه و تم دلخواه از کارهای معمولشه و با افزونه ها می شه امکانات بیشتری بهش داد.
یه نکته درباره خود این بسته هست که نباید ازش رد بشی. طبق توضیح رسمی منبع، این بسته الان به @videojs/html و @videojs/react اشاره می کنه و برای الگوهای قدیمی نسخه قبلی، خطای کددار برمی گردونه. یعنی اگه پروژه ات با روش های قدیمی video.js نوشته شده، ممکنه بعد از ارتقا به این خطاها بخوری. ما جزئیات دقیق تغییرها رو از خودمون حدس نمی زنیم. پیش از ارتقای سایت زنده، مستندات رسمی رو بخون و اول روی یه نسخه آزمایشی امتحانش کن.
برای کی مناسبه؟ برای سایت های آموزشی، فروشگاه های فایل و دوره، سایت های خبری و هر پروژه ای که ویدیو رو خودش میزبانی می کنه و پلیرش باید از مرورگر مستقل باشه. اگه پروژه ات با React نوشته شده، اشاره این بسته به @videojs/react برات مهمه. توی وردپرس معمولا از طریق قالب، افزونه سفارشی یا اضافه کردن اسکریپت به صفحه ازش استفاده می شه. ولی اگه فقط یه ویدیوی ساده می خوای نشون بدی، خود تگ video کافیه و لازم نیست کتابخانه اضافه کنی. اگه هم ویدیوهات روی آپارات هستن و با embed نشون داده می شن، پلیر خودشون رو دارن و به video.js نیازی نداری.
توی شرایط ایران یه نکته عملی هم هست: فایل های کتابخانه رو از هاست خودت لود کن، نه از CDN خارجی. وقتی اینترنت بین الملل مشکل داره، پلیری که اسکریپتش از بیرون می آد اصلا اجرا نمی شه و صفحه ات بدون ویدیو می مونه. خود ویدیوها هم بهتره روی سرور یا هاست داخلی باشن. نسخه های رسمی و بدون تغییر video.js توی مخزن داخلی ما هم در دسترسه، پس برای روزهای محدودیت می تونی همین جا برداری و روی هاست خودت بذاری.
راهنمای استفاده
برای استفاده از video.js اول ببین پروژه ات ساده ست یا با فریم ورک ساخته شده. قدم های کلی اینا هستن:
فایل های کتابخانه رو از همین صفحه بگیر و روی هاست خودت آپلود کن تا به CDN خارجی وابسته نباشی.
فایل استایل و فایل جاوااسکریپت رو با کد آماده پایین همین صفحه به صفحه ات اضافه کن.
توی HTML یه تگ video بذار، یه شناسه بهش بده و فایل ویدیو رو با تگ source معرفی کن.
پلیر رو با همون شناسه راه اندازی کن و تنظیم های دلخواه مثل کنترل ها، تصویر پوستر و ابعاد رو بده.
اگه چند ویدیو توی یه صفحه داری، برای هر کدوم یه شناسه جدا بذار.
اگه با React کار می کنی، به جای استفاده مستقیم سراغ @videojs/react برو. برای HTML ساده هم @videojs/html معرفی شده.
اگه کد قدیمی داری و خطای کددار گرفتی، متن خطا رو دقیق بخون. بسته همین خطاها رو برای الگوهای نسخه قبلی برمی گردونه تا بفهمی کجای کد باید عوض بشه.
بعد از راه اندازی، ویدیو رو توی چند مرورگر و روی یه گوشی واقعی امتحان کن. اگه فایل ها رو از هاست داخلی می دی، سرعت بارگذاری رو هم چک کن.
نشانی مستقیم فایل اصلی 7.10.2https://mirror.wbweb.ir/npm/video.js@7.10.2/dist/alt/video.core.min.js
پرسشهای رایج
یه کتابخانه متن باز جاوااسکریپته که پخش ویدیو و صدا رو توی صفحه وب مدیریت می کنه. روی تگ video مرورگر یه پلیر با کنترل های یکدست می ذاره. ظاهرش رو می تونی تغییر بدی و با افزونه ها هم امکاناتی مثل زیرنویس بهش اضافه کنی. برای سایت هایی که ویدیو رو خودشون میزبانی می کنن کاربردیه.
مجوزش از نوع Apache هست و استفاده تجاری معمولا باهاش مشکلی نداره. فقط باید شرط های مجوز رو رعایت کنی، مثل حفظ اطلاعات حق نشر و اعلامیه ها. اگه پروژه ات حساسه یا قرارداد خاصی داری، متن کامل مجوز رو خودت هم بخون و مطمئن شو.
طبق توضیح رسمی منبع، این بسته برای الگوهای قدیمی نسخه قبلی خطای کددار برمی گردونه و به @videojs/html و @videojs/react اشاره می کنه. یعنی احتمالا باید کدت رو با روش جدید هماهنگ کنی. متن خطا رو دقیق بخون و کنارش مستندات رسمی رو باز کن تا بفهمی کدوم بخش باید عوض بشه.
راه معمول اینه که فایل های کتابخانه رو توی قالب یا یه افزونه سفارشی صدا بزنی و بعدش تگ video رو توی صفحه یا نوشته بذاری. فایل ها رو روی هاست خودت نگه دار تا بدون CDN خارجی هم کار کنه. قبل از دست زدن به قالب سایت زنده، همه چیز رو روی یه نسخه آزمایشی امتحان کن.
خود کتابخانه بله، به شرط اینکه فایل هاش رو از هاست داخلی لود کنی و ویدیوها هم روی سرور داخلی باشن. اگه اسکریپت رو از CDN خارجی صدا بزنی، موقع قطعی اینترنت بین الملل پلیر اجرا نمی شه و صفحه بدون ویدیو می مونه.
Swiper یه کتابخانه متن باز جاوااسکریپت و CSS برای ساخت اسلایدر و کاروسل لمسی توی سایت و اپ وبه. مجوزش MIT هست و به jQuery نیاز نداره. برای بنر صفحه اول، گالری تصویر، لیست محصول و هر جایی که محتوا باید بچرخه به کار میاد. نسخه رسمی و بدون تغییرش رو می تونی از همین مخزن برداری.
slick-carousel یه کتابخانه جاوااسکریپت برای ساخت اسلایدر و کاروسل توی صفحه های وبه که روی jQuery سوار می شه. با اون می تونی تصویر، کارت محصول یا نقل قول رو کنار هم بچرخونی، تعداد اسلایدهای هر نمایش رو برای موبایل و دسکتاپ جدا تنظیم کنی و با کشیدن انگشت ورق بزنی. سازنده اش Ken Wheeler و مجوزش MIT هست.
@videojs/html یه بسته npm از خانواده Video.js برای ساخت پلیر ویدیو و صداست که با custom element های استاندارد مرورگر کار می کنه. پلیر و اسکین آماده رو توی صفحه HTML ساده یا پروژه Vue و Svelte می ذاری و ظاهر و کنترل ها رو خودت تعیین می کنی. مجوزش Apache هست.
Splide (با نام بسته @splidejs/splide) یه کتابخانه جاوااسکریپت سبک برای ساخت اسلایدر و کروسله. به کتابخانه دیگه ای وابسته نیست، با کیبورد و صفحه خوان سازگاره و برای بنر صفحه اصلی، لیست محصولات، گالری تصاویر و نظرات مشتری ها به کار می ره. مجوزش MIT هست و تو وردپرس و پروژه های HTML ساده راحت اجرا می شه.
@vidstack/cdn نسخه آماده مرورگر پلیر Vidstack توی یه بسته npm هست. با اون بدون React، Vue و باندلر، فقط با چند تگ script و link، می تونی یه پلیر ویدیو و صدای مدرن با کنترل های آماده و قابل شخصی سازی توی سایتت راه بندازی.
videojs-contrib-ads یه بسته npm برای پلیرهای video.js هست که کارهای مشترک تبلیغات ویدیویی رو انجام می ده: مدیریت وضعیت پخش قبل، وسط و بعد از ویدیو و هماهنگی بین تبلیغ و محتوای اصلی. خودش تبلیغی نشون نمی ده و فقط پایه ای برای افزونه های تبلیغاتیه.
آخرین نسخه
۷.۵.۲
نسخهها
۹
بهروزرسانی
چیزی که لازم دارید اینجا نیست؟
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخههای رسمی آن به مخزن اضافه میشود.