Strumento Command and Control (CaC)

Lo strumento Command and Control (CaC) è un mittente web funzionale che consente agli sviluppatori di testare ed eseguire il debug di un'applicazione Ricevitore web.

Gli sviluppatori possono utilizzare lo strumento CaC per:

• Avvia un'app Ricevitore web su un dispositivo compatibile con Google Cast e invia una richiesta di caricamento per avviare la riproduzione di contenuti multimediali.
• Simula i comandi vocali inviati dall'Assistente Google al Ricevitore web.
• Acquisisci i log da Cast Debug Logger e controlla l'overlay di debug del ricevitore web.

Avvia l'app Ricevitore web

Esistono due modi per lanciare il Ricevitore web con lo strumento CaC:

1. Per avviare una nuova sessione di trasmissione:

   1. Apri lo strumento CaC, inserisci l'ID app web Receiver e fai clic sul pulsante SET APP ID (Imposta ID app).

   2. Fai clic sul pulsante Trasmetti e seleziona un dispositivo per avviare il Ricevitore web su un dispositivo remoto supportato.

      

2. Per partecipare a una sessione di trasmissione esistente:

   1. Recupera l'ID sessione di trasmissione in esecuzione utilizzando i seguenti codici:

      Dal lato ricevitore web, utilizza il seguente metodo per ottenere l'ID sessione nella console Debugger remoto di Chrome:

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;
      

      In alternativa, per ottenere l'ID sessione da un mittente web collegato, utilizza il metodo seguente:

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();
      

   2. Inserisci l'ID sessione nello strumento CaC e fai clic sul pulsante RESUME.

      

Quando lo strumento CaC è connesso all'app Web Receiver, il pulsante Trasmetti appare con una forma a frame pieno. Nella parte superiore dello strumento vengono visualizzati anche l'ID app e l'ID sessione ricevitore web.

Carica elemento multimediale

Carica contenuti multimediali dall'app del mittente o dallo strumento CaC.

App mittente

Per avviare la riproduzione dei contenuti multimediali sul tuo ricevitore web, trasmetti l'app del mittente allo stesso dispositivo compatibile con Google Cast e invia una richiesta di caricamento dalla tua app del mittente al ricevitore web.

Nota: assicurati che l'app del mittente utilizzi lo stesso ID applicazione del ricevitore web di lo strumento CaC.

Strumento CaC

Lo strumento CaC fornisce inoltre diversi modi per inviare una richiesta di carico all'app Web Receiver:

Carica per entità (trasmissione vocale)

Quando gli utenti avviano la riproduzione di contenuti multimediali tramite l'Assistente Google, l'Assistente Google utilizza i messaggi Command e Control (CaC) per inviare le credenziali e l'entità dell'utente al Ricevitore web.

Lo strumento CaC simula la trasmissione vocale e invia una richiesta di carico con credentials e entity.

Carica per contenuto

Lo strumento CaC può anche simulare la tua app inviando una richiesta di carico con Content ID o Content Url.

Nota: ti consigliamo di utilizzare entity nella tua implementazione sia per le app di mittenti sia per quelle di Ricevitore web. Per saperne di più, consulta Suggerimento: caricamento di contenuti multimediali utilizzando contentId, contentUrl ed entità.

Quando inizia la riproduzione di contenuti multimediali, lo strumento CaC riceve messaggi relativi allo stato dei contenuti multimediali dall'app Ricevitore web e li visualizza nella scheda STATO MEDIA.

Richiesta di caricamento personalizzata

Se vuoi testare il ricevitore utilizzando oggetti Load Request, utilizza il campo Richiesta di caricamento personalizzata nella scheda CARICA MEDIA. Per prima cosa, seleziona il tipo di richiesta dai pulsanti di opzione Seleziona tipo di richiesta, quindi copia e incolla oppure crea il tuo oggetto JSON.

Nota: l'editor supporta l'utilizzo della chiave Tab per il rientro e la formattazione.

Testare i comandi vocali

Lo strumento CaC simula anche i comandi vocali inviati dall'Assistente Google alla tua app Web Receiver. Puoi testare se i comandi multimediali supportati dalla tua app funzionano correttamente. I comandi multimediali non supportati devono essere gestiti con il tipo di errore e i motivi di errore appropriati.

Ispeziona e controlla il logger debug Cast

Se l'app Web Receiver attiva Cast Debug Logger, lo strumento CaC acquisisce i messaggi di log e controlla l'overlay di debug di Web Receiver.

Utilizza i seguenti pulsanti per controllare il ricevitore web e i messaggi di log:

• ID app ricevitore web
  • Svuota la cache e interrompi il ricevitore web. Ricarica l'app Ricevitore web e interrompi la trasmissione.
• Overlay di debug del ricevitore web
  • Mostra: attiva/disattiva l'overlay di debug sul Ricevitore web
  • Cancella: cancella i messaggi di log nell'overlay di debug del ricevitore web
• Log dei controlli dei messaggi
  • Inserisci messaggio: inserisci commenti o divisori nell'area di log
  • Scarica log: salva i messaggi di log
  • Cancella log: cancella i messaggi di log nell'area di log.
• Registra messaggi
  • Tag personalizzati: fai clic sulla casella di controllo per filtrare i messaggi di log.

I seguenti tag potrebbero essere visualizzati nella sezione Tag personalizzati. Vengono aggiunti dallo strumento CaC per visualizzare e filtrare log o messaggi importanti relativi alla sessione di debug:

• MEDIA: messaggi inviati correttamente tramite lo spazio dei nomi dei contenuti multimediali.
• MEDIA-ERROR: si è verificato un errore durante l'invio o in risposta ai messaggi inviati sullo spazio dei nomi dei contenuti multimediali
• CAC: messaggi inviati correttamente nello spazio dei nomi CAC
• ERRORE CAC - Si è verificato un errore durante l'invio o in risposta ai messaggi inviati nello spazio dei nomi CAC
• IN RIPRODUZIONE. Registra il risultato quando viene fatto clic sul pulsante In riproduzione nello strumento CaC
• USER: log che consente di visualizzare il messaggio personalizzato inserito dall'utente con il pulsante Inserisci messaggio nello strumento CaC

Prova Cast Connect

Per testare Cast Connect, procedi come indicato di seguito prima di avviare una sessione:

1. Inserisci l'ID app del destinatario associato al ricevitore compatibile con Cast Connect e fai clic su Imposta ID app.
2. Fai clic sul pulsante Mostra opzioni Android TV.
3. Seleziona la casella di controllo androidReceivedrcompatible. Se il ricevitore non richiede l'impostazione di Launch Credentials o vuoi testare cosa succede se non è impostato, puoi fermarti qui e andare al passaggio 5.
4. (Facoltativo) Inserisci il Launch Credentials e fai clic sul pulsante Imposta le credenziali di lancio per impostare le credenziali di avvio per la sessione di trasmissione.
5. Avvia una sessione di trasmissione facendo clic sull'icona Trasmetti nell'intestazione o tramite il menu Trasmetti nel browser Chrome.

L'applicazione Android TV dovrebbe essere avviata sul dispositivo.

Nota: lo strumento CaC non è in grado di recuperare alcun log dal tuo dispositivo Android TV. Per eseguire il debug dell'app Android TV e visualizzare i log pertinenti, usa adb tramite il terminale o Android Studio, come faresti normalmente per accedere ai log ed eseguire il debug dell'app.