Chromecast / التلفزيون الذكي

1ما هو دعم Chromecast؟#

يتيح دعم Chromecast للمستخدمين بث الفيديو/الصوت من تطبيقك إلى تلفزيون أو شاشة ذكية. يوفر التطبيق جسر JavaScript يمكن لموقعك استدعاؤه لبدء البث.

مثالي لـ:

• مواقع بث الفيديو
• منصات الموسيقى
• معارض الصور
• أدوات العروض التقديمية
• تطبيقات التحكم في اللافتات الرقمية

2كيف يعمل#

يحقن التطبيق المُنشأ جسر JavaScript (window.WebToApk) في WebView الخاص بك. يمكن لموقعك استدعاء هذا الجسر لتشغيل البث الأصلي في Android.

المسار:

1. يضغط المستخدم زر «بث» في موقعك
2. ينفّذ كود JS الخاص بك الاستدعاء window.WebToApk.castMedia(url)
3. يفتح Android نافذة اختيار المشاركة/البث الأصلية للوسائط
4. يختار المستخدم جهاز Chromecast الخاص به
5. تُعرض الوسائط على التلفزيون

3أضف زر البث إلى موقعك#

أضف زر «بث» إلى موقعك يستدعي جسر 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)
✅ وفّر رسالة بديلة لمستخدمي المتصفح
✅ فكّر في عرض شريط «نزّل تطبيقنا للبث»