کتابخانه
videojs-contrib-ads یه بسته npm برای پلیرهای video.js هست که کارهای مشترک تبلیغات ویدیویی رو انجام می ده: مدیریت وضعیت پخش قبل، وسط و بعد از ویدیو و هماهنگی بین تبلیغ و محتوای اصلی. خودش تبلیغی نشون نمی ده و فقط پایه ای برای افزونه های تبلیغاتیه.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز Apache-2.0؛ هش هر فایل با منبع بررسی شده است.
۶۳۰ کیلوبایت· ۴۳ فایل· انتشار
SHA-256: ad2d77b2cd7915291574050a8dc0cbadaf09f260ff6467fba39a3018fcf382c0
videojs-contrib-ads یه فریم ورک کوچیک برای پلیر video.js هست. هر کسی بخواد تو این پلیر تبلیغ ویدیویی بذاره، با یه سری دردسر تکراری روبه رو می شه. تبلیغ باید قبل از ویدیو پخش بشه، بعدش پلیر دقیقاً به همون نقطه از محتوا برگرده، اگه تبلیغ دیر لود شد ویدیو اصلی معطل نمونه و اگه منبع ویدیو عوض شد همه چیز از نو شروع بشه. این بسته برای تبلیغ قبل، وسط و بعد از ویدیو وضعیت های مشخص داره و همین منطق مشترک رو یه جا جمع کرده تا هر افزونه تبلیغاتی مجبور نباشه همه اینا رو از صفر بنویسه.
یه نکته رو از همون اول جدی بگیر: videojs-contrib-ads خودش هیچ تبلیغی لود یا نمایش نمی ده و سرور تبلیغاتی هم صدا نمی زنه. فقط چارچوب، وضعیت ها و رویدادها رو فراهم می کنه. افزونه تبلیغاتی، مثل افزونه های اتصال به Google IMA، روی این بسته سوار می شه و کار اصلی رو اون انجام می ده. پس اگه فقط می خوای یه بنر ساده کنار ویدیو بذاری، به این کتابخونه نیازی نداری.
برای کی مناسبه؟ برای توسعه دهنده ای که تو سایت وردپرسی یا پروژه اختصاصی پلیر video.js داره و می خواد قبل، وسط یا بعد از ویدیو تبلیغ نشون بده. یا برای کسی که می خواد افزونه تبلیغاتی خودش رو بنویسه، مثلاً برای اتصال به یه شبکه تبلیغاتی داخلی. اگه فقط یه پلیر ساده و بدون کدنویسی می خوای، این بسته به کارت نمی آد.
یه نکته مهم برای سایت های ایرانی: بعضی سرویس های تبلیغاتی خارجی ممکنه از داخل ایران در دسترس نباشن. قبل از اینکه پروژه رو روی اون ها بنا کنی، دسترسی رو تست کن. رفتار پلیر رو هم برای وقتی که تبلیغ لود نمی شه بررسی کن.
موقع انتخاب به دو چیز نگاه کن: سازگاری با نسخه video.js سایتت (مستندات پروژه رو ببین) و اینکه افزونه تبلیغاتی ات واقعاً روی همین بسته ساخته شده باشه. مجوزش Apache هست و استفاده تجاری با رعایت شرایط مجوز آزاده. نسخه های رسمی و بدون تغییر این بسته تو مخزن داخلی ما هم در دسترسه، برای روزهایی که اینترنت بین الملل درست کار نمی کنه.
روش استفاده به این بستگی داره که پروژه ات چطور ساخته شده. مراحل کلی این هاست:
یه تست رو حتماً انجام بده: آدرس تبلیغ رو عمداً خراب کن یا اینترنت رو کند کن و ببین ویدیو اصلی بعد از تموم شدن زمان انتظار خودش پخش می شه یا نه. تو شبکه های ناپایدار، بیشترین مشکل بازدیدکننده ها همین جاست.
نه. این بسته فقط زیرساخت مشترک رو فراهم می کنه: وضعیت های پخش، رویدادها و برگشت به محتوای اصلی. گرفتن تبلیغ از سرور تبلیغاتی و نمایش دادنش کار افزونه ای هست که روی این بسته ساخته می شه، مثل افزونه های اتصال به Google IMA.
نه، چون این بسته یه افزونه برای video.js هست و بدون اون کاری نمی کنه. اول باید پلیر video.js تو صفحه باشه، بعدش این کتابخونه و آخر سر افزونه تبلیغاتی. ترتیب لود شدن فایل ها هم مهمه، پس اگه جابه جا بشن معمولاً خطا می گیری.
افزونه وردپرس نیست و یه کتابخونه جاوااسکریپته. باید فایل ها رو از طریق قالب یا یه افزونه سفارشی، مثلاً با wp_enqueue_script، تو صفحه هایی که پلیر دارن لود کنی و بعدش کد فعال سازی رو بنویسی. ترتیب لود رو هم رعایت کن: اول video.js، بعد این بسته، بعدش افزونه تبلیغاتی.
بله، این مجوز معمولاً استفاده تجاری و تغییر کد رو اجازه می ده، به شرط اینکه اعلان کپی رایت و متن مجوز رو حفظ کنی. برای جزئیات دقیق، متن کامل مجوزی که همراه بسته اومده رو بخون. اگه پروژه ات حساسیت حقوقی داره، قبل از انتشار یه بار شرایطش رو دقیق بررسی کن.
این بسته برای همین حالت زمان انتظار داره. اگه تبلیغ تو مدت تعیین شده آماده نشه، پلیر منتظر نمی مونه و ویدیو اصلی رو پخش می کنه. مقدار timeout رو با توجه به کیفیت اینترنت کاربرهات تنظیم کن و بعدش تست کن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.