اگه تا حالا تگ video خام رو توی صفحه گذاشته باشی، می دونی که ظاهر و رفتارش از یه مرورگر به مرورگر دیگه فرق می کنه. کنترل ها شبیه هم نیستن، شخصی سازی سخته و هر قابلیت اضافه، مثل انتخاب کیفیت یا تصویر روی ویدیو، باید از صفر نوشته بشه. clappr برای همین ساخته شده: یه پلیر جاوااسکریپتی که روی امکانات استاندارد مرورگر سوار می شه و یه رابط یکدست و قابل توسعه بهت می ده. Globo، یکی از رسانه های بزرگ برزیل، این پروژه رو ساخته و با مجوز BSD-3-Clause منتشر کرده. طبق این مجوز می تونی توی پروژه های شخصی و تجاری ازش استفاده کنی، فقط باید اعلان مجوز رو حفظ کنی.
نقطه قوت clappr معماری افزونه ایه. هسته پلیر کوچیکه و بقیه چیزها، از نوار کنترل و لوگو تا انتخاب کیفیت و تصویر بندانگشتی، به شکل پلاگین اضافه می شن. بعضی پلاگین ها رو جامعه کاربرها نوشتن و خودت هم می تونی پلاگین بنویسی. توی کار روزمره با چند گزینه ساده سروکار داری: منبع ویدیو، المانی که پلیر داخلش ساخته می شه، عرض و ارتفاع، پوستر، پخش خودکار و بی صدا. بعدش می تونی به رویدادهای پلیر گوش بدی، مثلا وقتی ویدیو تموم شد یه کاری انجام بدی. برای استریم هایی مثل HLS معمولا باید سراغ پلی بک ها و پلاگین های مربوط بری. پشتیبانی دقیقش به نسخه و تنظیمات بستگی داره، پس قبل از شروع مستندات رو بخون و روی مرورگرهای هدفت تست کن.
clappr برای کی مناسبه؟ مدیر سایتی که ویدیوهای آموزشی، خبری یا معرفی محصولش رو روی هاست یا سرور فایل خودش نگه می داره و یه پلیر یکدست می خواد. توسعه دهنده ای که می خواد پلیر رو به منطق سایت وصل کنه، مثلا نقطه ای که کاربر ویدیو رو رها کرده ذخیره بشه. توی شرایط ایران یه مزیت دیگه هم داره: چون کتابخونه رو از سرور خودت می دی، به CDN خارجی وابسته نیستی و وقتی اینترنت بین الملل مشکل داره، پلیرت از کار نمی افته. اما اگه فقط می خوای ویدیوی آپارات یا یوتیوب رو جاسازی کنی، بهش نیازی نداری و همون کد امبد کافیه. اگه هم کدنویسی نمی کنی و دنبال افزونه وردپرسی با پنل تنظیمات آماده ای، clappr چنین چیزی نداره. کتابخونه است، نه افزونه.
چند نکته قبل از شروع. MP4 با کدک H.264 و صدای AAC سازگارترین انتخاب برای پخش مستقیمه. سرورت باید درخواست های بازه ای رو پشتیبانی کنه تا کاربر بتونه وسط ویدیو بپره. برای ویدیوهای بلند و سایت های پربازدید، استریم تکه تکه منطقی تره. قبل از یه کار بزرگ هم چک کن پروژه هنوز نگهداری می شه و پلاگین هایی که لازم داری باهاش سازگارن. نسخه های رسمی و بدون تغییر clappr توی مخزن داخلی ما هم در دسترسه، پس اگه دانلود از منابع خارجی کند بود یا قطع شد، می تونی از همین صفحه برش داری.
راهنمای استفاده
استفاده از clappr چند قدم ساده داره و کد آماده اش پایین همین صفحه هست.
- فایل جاوااسکریپت clappr رو دانلود کن و روی هاست خودت بذار، ترجیحا کنار بقیه فایل های سایت.
- توی صفحه یه div خالی با شناسه مشخص بساز تا جای پلیر باشه.
- اسکریپت رو قبل از کد خودت لود کن.
- یه نمونه از Player بساز و گزینه هایی مثل source، parentId، width، height و poster رو بهش بده.
- کد آماده پایین صفحه رو کپی کن و آدرس ویدیوی خودت رو جاش بذار.
اگه می خوای قابلیت اضافه کنی، فایل پلاگین رو بعد از اسکریپت اصلی لود کن و اسمش رو توی گزینه plugins بده.
اگه با وردپرس کار می کنی، اسکریپت ها رو با تابع wp_enqueue_script ثبت کن و دستی توی قالب نچسبون، تا با بقیه افزونه ها تداخل پیدا نکنه.
آخرش هم حتما روی موبایل تست کن. مرورگرها معمولا پخش خودکار رو فقط برای ویدیوی بی صدا اجازه می دن، پس اگه ویدیوت خودکار شروع نشد، اول سراغ همین مورد برو.