نحوه استفاده
- لینک ویدیوی یوتیوب یا شناسه ۱۱ نویسه‌ای آن را جای‌گذاری کنید.
- زمان شروع و پایان و گزینه‌های پخش موردنظر را تنظیم کنید.
- حالت واکنش‌گرا یا اندازه ثابت را انتخاب کنید و یک عنوان توصیفی تعیین کنید.
- HTML را کپی کنید و در صفحه یا بلوک HTML سایت‌ساز خود جای‌گذاری کنید. برای آزمایش از «نمایش پیش‌نمایش» استفاده کنید.
نحوه کار
این کد از پخش‌کننده استاندارد iframe یوتیوب استفاده می‌کند. گزینه‌ها به‌صورت پارامترهای URL به آدرس پخش‌کننده اضافه می‌شوند: start و end (ثانیه)، autoplay، mute، loop همراه با playlist، controls=0، cc_load_policy=1 برای زیرنویس، cc_lang_pref برای زبان زیرنویس و hl برای زبان پخش‌کننده. حالت حریم خصوصی پیشرفته آدرس را به youtube-nocookie.com تغییر می‌دهد.
برخی گزینه‌ها محدودیت‌هایی دارند که یوتیوب یا مرورگرها تعیین کرده‌اند. پخش خودکار فقط وقتی ویدیو بی‌صدا باشد کار می‌کند، بنابراین ابزار با autoplay مقدار mute=1 را اضافه می‌کند. تکرار یک ویدیوی تکی نیاز دارد پارامتر playlist برابر با همان شناسه ویدیو باشد که ابزار آن را اضافه می‌کند. زیرنویس فقط در صورتی نمایش داده می‌شود که ویدیو زیرنویس داشته باشد. ویدیوهایی که صاحبان آن‌ها جاسازی را غیرفعال کرده باشند، در پخش‌کننده خطا نشان می‌دهند.
حالت واکنش‌گرا iframe را درون جعبه‌ای با aspect-ratio: 16 / 9 و width: 100% قرار می‌دهد تا با صفحه مقیاس شود بدون استفاده از ترفند قدیمی padding-bottom. حالت ثابت ویژگی‌های width و height را می‌نویسد. بارگذاری تنبل پخش‌کننده را تا نزدیک‌شدن به بخش قابل مشاهده صفحه به تأخیر می‌اندازد.
نمونه‌ها
جاسازی واکنش‌گرا و سازگار با حریم خصوصی
تنظیمات پیش‌فرض: youtube-nocookie.com، حالت واکنش‌گرا ۱۶:۹ و بارگذاری تنبل. قطعه کد را در هر صفحه HTML قرار دهید.
تکرار به‌سبک پس‌زمینه
پخش خودکار، تکرار و بدون کنترل‌ها، …/embed/ID?autoplay=1&mute=1&loop=1&playlist=ID&controls=0 را ایجاد می‌کنند.
پخش فقط یک بخش
شروع از ۱:۰۰ و توقف در ۲:۳۰ نتیجه start=60&end=150 را می‌دهد؛ بنابراین پخش‌کننده فقط همان بخش را پخش می‌کند.
پرسش‌های متداول
چرا ویدیوی جاسازی‌شده من با صدا به‌طور خودکار پخش نمی‌شود؟
مرورگرها پخش خودکار با صدا را مسدود می‌کنند. پخش خودکار به mute=1 نیاز دارد که ابزار به‌صورت خودکار اضافه می‌کند؛ برخی مرورگرها یا تنظیمات هنوز آن را مسدود می‌کنند.
حالت حفظ حریم خصوصی پیشرفته چه می‌کند؟
پخش‌کننده را از youtube-nocookie.com بارگیری می‌کند. طبق اعلام یوتیوب، اطلاعات بازدیدکنندگان برای شخصی‌سازی ذخیره نمی‌شود مگر اینکه ویدیو را پخش کنند.
چرا برای تکرار به playlist= نیاز دارم؟
پارامتر loop یوتیوب فقط با یک playlist کار می‌کند. تنظیم playlist روی همان شناسه ویدیو باعث تکرار یک ویدیو می‌شود.
آیا کد تولیدشده در وردپرس کار می‌کند؟
بله. آن را در یک بلوک HTML سفارشی جای‌گذاری کنید. برخی سایت‌سازها به دلایل امنیتی iframeها را حذف می‌کنند؛ در این صورت از بلوک ویدیوی خودشان استفاده کنید.
حریم خصوصی
کد Embed در مرورگر شما ساخته می‌شود و هیچ چیزی به جایی ارسال نمی‌شود. فقط در صورتی که روی «نمایش پیش‌نمایش» کلیک کنید، مرورگر شما پخش‌کننده را از YouTube (یا youtube-nocookie.com) بارگیری می‌کند.