کتابخانه
@clappr/player بسته npm پلیر Clappr هست؛ یه پلیر مدیای قابل توسعه برای وب که تیم Globo ساخته و با مجوز BSD-3-Clause منتشر شده. باهاش ویدیو و صدا رو توی صفحه سایتت پخش می کنی و قابلیت هاش رو با افزونه گسترش می دی. فایل های پلیر هم می تونن روی هاست خودت بمونن.
نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز BSD-3-Clause؛ هش هر فایل با منبع بررسی شده است.
۳٫۵ مگابایت· ۸ فایل· انتشار
SHA-256: b68877e27fd1fe70904b104283a02db9f05d27e3618dfb86a134c6490d266620
@clappr/player بسته npm پلیر Clappr هست؛ یه پلیر مدیای قابل توسعه برای وب که تیم Globo ساخته. ایده اصلیش ساده ست: یه هسته که پخش ویدیو و صدا رو توی مرورگر انجام می ده و بقیه قابلیت ها رو با افزونه بهش اضافه می کنی. اگه تا حالا برای پخش یه ویدیو به یه سرویس بیرونی وابسته بودی و با کندی یا قطعی اینترنت بین الملل صفحه ات نصفه مونده، این کتابخونه به کارت میاد.
مشکلی که حل می کنه اینه که پلیر دست خودته. فایل های جاوااسکریپت پلیر کنار بقیه فایل های سایت روی هاست خودت می شینن و ویدیوها هم می تونن از سرور یا فضای ذخیره سازی خودت پخش بشن. یعنی نه CDN خارجی لازم داری، نه صفحه ای که از یه سرویس بیرونی لود بشه. برای سایت های آموزشی، فروشگاه هایی که ویدیوی معرفی محصول دارن، سایت های خبری و پرتال های سازمانی که می خوان ظاهر پلیر با برندشون بخونه، گزینه خوبیه.
پلیر قالب های رایج ویدیو رو پخش می کنه و پخش زنده و استریم تطبیقی مثل HLS هم جزو کاربردهای شناخته شده اشه، البته بسته به نسخه و افزونه ای که استفاده می کنی. اینکه دقیقا چه قالبی روی چه مرورگری پخش بشه، به خود مرورگر و تنظیمات سرور هم بستگی داره. قبل از اینکه روی سایت اصلی بذاری، یه نمونه از ویدیوهای واقعی خودت رو روی چند مرورگر و موبایل امتحان کن.
جاهایی هم هست که لازم نیست سراغش بری. اگه فقط یه ویدیوی کوتاه می خوای نشون بدی، تگ video خود HTML کافیه و پلیر اضافه فقط حجم صفحه رو بالا می بره. اگه دنبال یه افزونه وردپرس با پیشخوان و تنظیمات گرافیکی هستی هم، باید بدونی که این یه کتابخونه جاوااسکریپته، نه افزونه وردپرس. باید خودت توی قالب یا یه فایل اسکریپت لودش کنی یا از یه توسعه دهنده کمک بگیری. برای نیازهای خاص مثل محافظت پیشرفته از محتوا هم فقط به همین کتابخونه تکیه نکن و اول مستندات و افزونه های موجودش رو بررسی کن.
نسخه های رسمی و بدون تغییر @clappr/player توی مخزن داخلی ما هم در دسترسه. پس وقتی دسترسی به npm یا CDN های خارجی مختل شد، می تونی از همین جا برداری. فقط موقع انتخاب نسخه حواست باشه با افزونه های جانبی ای که استفاده می کنی هماهنگ باشه.
استفاده از پلیر توی یه صفحه معمولی چند قدم بیشتر نیست:
اگه پروژه ات با ابزاری مثل webpack یا Vite ساخته می شه، بسته رو با npm نصب کن و توی کدت import کن. توی وردپرس هم بهترین کار اینه که اسکریپت رو با wp_enqueue_script از طریق قالب یا یه افزونه کوچک سفارشی لود کنی و بعدش توی برگه یا نوشته، یه بلوک HTML سفارشی با همون div بذاری.
آخرش صفحه رو روی چند مرورگر و موبایل تست کن و ببین ویدیو از مسیر هاست خودت درست بالا میاد یا نه.
تگ video فقط پخش ساده رو بهت می ده و ظاهرش بین مرورگرها فرق می کنه. Clappr یه پلیر کامل روی همین پخش می سازه؛ ظاهرش یکدسته، با افزونه قابل گسترشه و برای پخش زنده و استریم هم می شه ازش استفاده کرد. اگه فقط یه ویدیوی ساده داری، تگ خود HTML کافیه.
مجوز BSD-3-Clause یه مجوز آزاده و معمولا استفاده تجاری رو اجازه می ده. شرطش اینه که اطلاعیه کپی رایت و متن مجوز رو حفظ کنی. برای اطمینان کامل، متن خود مجوز رو که همراه بسته هست یه بار بخون و اگه سوالی داشتی، از یه متخصص حقوقی بپرس.
نه، یه کتابخونه جاوااسکریپته و پیشخوان یا تنظیمات گرافیکی وردپرس نداره. توی وردپرس باید فایلش رو با قالب یا یه افزونه سفارشی لود کنی و یه div براش توی برگه بذاری. اگه با این کارها آشنا نیستی، برای یه توسعه دهنده کار سنگینی نیست و راحت انجامش می ده.
اگه فایل های پلیر و خود ویدیو روی هاست داخلی باشن، بله. ولی اگه اسکریپت از CDN خارجی لود بشه یا ویدیو روی سرویس بیرونی باشه، با قطعی مشکل پیدا می کنی. افزونه های جانبی رو هم قبل از استفاده چک کن که به آدرس خارجی وابسته نباشن.
نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.