Chromecast / تلویزیون هوشمند

1پشتیبانی از Chromecast چیست؟#

پشتیبانی از Chromecast به کاربران اجازه می‌دهد ویدیو/صدا را از اپلیکیشن شما روی تلویزیون یا نمایشگر هوشمند پخش کنند. اپلیکیشن یک پل JavaScript فراهم می‌کند که وب‌سایت شما می‌تواند برای شروع پخش آن را فراخوانی کند.

عالی برای:

• وب‌سایت‌های پخش ویدیو
• پلتفرم‌های موسیقی
• گالری‌های عکس
• ابزارهای ارائه
• اپلیکیشن‌های کنترل تابلوهای دیجیتال

2چگونه کار می‌کند#

اپلیکیشن ساخته‌شده یک پل JavaScript (window.WebToApk) را در WebView شما تزریق می‌کند. وب‌سایت شما می‌تواند این پل را فراخوانی کند تا پخش بومی اندروید را راه بیندازد.

جریان کار:

1. کاربر روی دکمه «Cast» در وب‌سایت شما می‌زند
2. کد JS شما فراخوانی می‌کند window.WebToApk.castMedia(url)
3. اندروید انتخابگر بومی اشتراک‌گذاری/پخش رسانه را باز می‌کند
4. کاربر دستگاه Chromecast خود را انتخاب می‌کند
5. رسانه روی تلویزیون پخش می‌شود

3افزودن دکمه پخش روی تلویزیون به وب‌سایت شما#

یک دکمه Cast به وب‌سایت خود اضافه کنید که پل JS را فراخوانی کند:

<!-- Add a Cast button -->
<button id="castBtn" onclick="castToTV()">
  📺 Cast to TV
</button>

<script>
function castToTV() {
  var videoUrl = document.querySelector('video')?.src
    || 'https://yoursite.com/video.mp4';
  
  if (window.WebToApk && window.WebToApk.castMedia) {
    window.WebToApk.castMedia(videoUrl);
  } else {
    alert('Casting is only available in the app');
  }
}
</script>

4انواع رسانه پشتیبانی‌شده#

پل پخش از انواع رسانه زیر پشتیبانی می‌کند:

✅ نشانی‌های مستقیم ویدیو (MP4، WebM)
✅ نشانی‌های صوتی (MP3، AAC، OGG)
✅ پخش زنده HLS (.m3u8)
✅ پخش زنده DASH (.mpd)

⚠️ محتوای دارای محافظت DRM به راه‌اندازی بیشتر اپلیکیشن گیرنده Chromecast نیاز دارد

⚠️ صفحات وب (HTML) را نمی‌توان مستقیم پخش کرد - فقط نشانی‌های رسانه

5تشخیص محیط اپلیکیشن#

وب‌سایت شما می‌تواند تشخیص دهد که داخل اپلیکیشن ساخته‌شده اجرا می‌شود یا نه، تا دکمه پخش را نشان دهد یا پنهان کند:

// Check if running inside WebToApk app
if (window.WebToApk) {
  // Running in the app — show cast button
  document.getElementById('castBtn')
    .style.display = 'block';
} else {
  // Running in a browser — hide cast button
  document.getElementById('castBtn')
    .style.display = 'none';
}

6جایگزین برای مرورگر#

اگر وب‌سایت شما از یک مرورگر معمولی هم باز می‌شود، شیء window.WebToApk وجود نخواهد داشت. همیشه قبل از فراخوانی بررسی کنید:

✅ از تشخیص قابلیت استفاده کنید: if (window.WebToApk)
✅ برای کاربران مرورگر یک پیام جایگزین نمایش دهید
✅ نمایش بنر «اپلیکیشن ما را برای پخش روی تلویزیون دانلود کنید» را در نظر بگیرید