Chromecast / Smart TV

1Che cos'è il supporto Chromecast?#

Il supporto Chromecast permette agli utenti di trasmettere video/audio dalla tua app a una TV o a uno smart display. L'app fornisce un bridge JavaScript che il tuo sito web può chiamare per avviare la trasmissione.

Ideale per:

• Siti di video in streaming
• Piattaforme musicali
• Gallerie fotografiche
• Strumenti per presentazioni
• App di controllo per la segnaletica digitale

2Come funziona#

L'app generata inserisce un bridge JavaScript (window.WebToApk) nella tua WebView. Il tuo sito web può chiamare questo bridge per avviare il casting nativo di Android.

Flusso:

1. L'utente tocca un pulsante 'Cast' sul tuo sito web
2. Il tuo JS chiama window.WebToApk.castMedia(url)
3. Android apre il selettore nativo di condivisione/casting dei contenuti
4. L'utente seleziona il proprio dispositivo Chromecast
5. Il contenuto multimediale viene riprodotto sulla TV

3Aggiungi il pulsante Cast al tuo sito web#

Aggiungi al tuo sito web un pulsante Cast che chiama il bridge 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>

4Tipi di contenuti multimediali supportati#

Il bridge di casting supporta questi tipi di contenuti:

✅ URL video diretti (MP4, WebM)
✅ URL audio (MP3, AAC, OGG)
✅ Stream HLS (.m3u8)
✅ Stream DASH (.mpd)

⚠️ I contenuti protetti da DRM richiedono una configurazione aggiuntiva dell'app ricevitore Chromecast

⚠️ Le pagine web (HTML) non possono essere trasmesse direttamente, solo gli URL multimediali

5Rileva l'ambiente dell'app#

Il tuo sito web può rilevare se è in esecuzione dentro l'app generata, per mostrare o nascondere il pulsante Cast:

// 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';
}

6Alternativa per il browser#

Se il tuo sito web è raggiungibile anche da un normale browser, l'oggetto window.WebToApk non esisterà. Controlla sempre prima di chiamarlo:

✅ Usa il rilevamento delle funzionalità: if (window.WebToApk)
✅ Prevedi un messaggio alternativo per gli utenti del browser
✅ Valuta di mostrare un banner «Scarica la nostra app per il casting»