Herramienta de comando y control (CaC)

La herramienta de comando y control (CaC) es un remitente web funcional para que los desarrolladores prueben y depuren una aplicación de recepción web.

Los desarrolladores pueden usar la herramienta de CaC para lo siguiente:

• Inicia una app receptora web en un dispositivo compatible con Cast y envía una solicitud de carga para iniciar la reproducción de contenido multimedia.
• Simula los comandos por voz que envía Asistente de Google al receptor web.
• Captura registros del registro de depuración de Cast y controla la superposición de depuración del receptor web.

Inicia la app de receptor web

Existen dos maneras de iniciar tu receptor web con la herramienta de CaC:

1. Para iniciar una nueva sesión de transmisión, haz lo siguiente:

   1. Abre la herramienta de CaC, ingresa el ID de la app del receptor web y haz clic en el botón SET APP ID.

   2. Haz clic en el botón para transmitir y selecciona un dispositivo para iniciar el receptor web en un dispositivo compatible con Cast remoto.

      

2. Para unirte a una sesión de transmisión existente, sigue estos pasos:

   1. Obtén el ID de la sesión de transmisión en ejecución con los siguientes códigos:

      Del lado del receptor web, usa el siguiente método para obtener el ID de sesión en la consola del Depurador remoto de Chrome:

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

      Para obtener el ID de sesión de un remitente web conectado, usa el siguiente método:

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

   2. Ingresa el ID de sesión en la herramienta de CaC y haz clic en el botón REANUDAR.

      

Cuando la herramienta de CaC está conectada a la app del receptor web, aparece el botón para transmitir con una forma de marco rellena. El ID de la app del receptor web y el ID de la sesión también se muestran en la parte superior de la herramienta.

Cargar medios

Carga contenido multimedia desde la app emisora o la herramienta de CaC.

App de remitente

Para iniciar la reproducción de contenido multimedia en tu receptor web, transmite la app emisora al mismo dispositivo compatible con Cast y envía una solicitud de carga desde la app emisora al receptor web.

Nota: Asegúrate de que la app emisora esté usando el mismo ID de aplicación del receptor web que el de la herramienta de CaC.

Herramienta de CAC

La herramienta de CaC también proporciona varias formas de enviar una solicitud de carga a la app de receptor web:

Cargar por entidad (transmisión de voz)

Cuando los usuarios inician la reproducción de contenido multimedia a través del Asistente de Google, este usa mensajes de comando y control (CaC) para enviar credenciales de usuario y una entidad a tu receptor web.

La herramienta de CaC simula la transmisión de voz y envía una solicitud de carga con credentials y entity.

Cargar por contenido

La herramienta de CaC también puede simular que tu app envía una solicitud de carga con Content ID o Content Url.

Nota: Te sugerimos que uses entity en tu implementación para las apps de remitente y receptor web. Para obtener más información, consulta Sugerencia: Carga contenido multimedia mediante contentId, contentUrl y la entidad.

Cuando se inicia una reproducción multimedia, la herramienta de CaC recibe mensajes de estado de medios de tu app receptora de Web y los muestra en la pestaña ESTADO DEL MEDIO.

Solicitud de carga personalizada

Si deseas probar tu app receptora con tus propios objetos Load Request, usa el campo Solicitud de carga personalizada en la pestaña CARGAR MEDIOS. Primero, selecciona el tipo de solicitud de los botones de selección Seleccionar tipo de solicitud y, luego, copia y pega o crea tu propio objeto JSON.

Nota: El editor admite el uso de la clave Tab para las sangrías y el formato.

Prueba los comandos por voz

La herramienta de CaC también simula comandos por voz que envía Asistente de Google a tu app de receptor web. Puedes probar si los comandos multimedia que admite tu app funcionan correctamente. Los comandos de contenido multimedia no compatibles deben manejarse con el tipo de error y los motivos de error adecuados.

Inspecciona y controla el registro de depuración de Cast

Si tu app receptora web habilita el registro de depuración de Cast, la herramienta de CaC captura los mensajes de registro y controla la superposición de depuración del receptor web.

Usa los siguientes botones para controlar el receptor web y los mensajes de registro:

• ID de app del receptor web
  • Clear Cache and Stop Web Receiver: vuelve a cargar la app del receptor web y deja de transmitir contenido.
• Superposición de depuración del receptor web
  • Mostrar: Activa o desactiva la superposición de depuración en el receptor web.
  • Borrar: Borra los mensajes de registro en la superposición de depuración del receptor web.
• Controles de mensajes de registro
  • Insertar mensaje: Inserta comentarios o divisores en el área de registro.
  • Descargar registro: Guarda mensajes de registro.
  • Borrar registro: Borra los mensajes del registro en el área de registro.
• Mensajes de registro
  • Etiquetas personalizadas: haz clic en la casilla de verificación para filtrar los mensajes de registro.

Las siguientes etiquetas pueden aparecer en Etiquetas personalizadas. La herramienta CaC las agrega para mostrar y filtrar los registros o mensajes importantes relacionados con la sesión de depuración:

• MEDIA: Mensajes que se enviaron correctamente a través del espacio de nombres de medios
• MEDIA-ERROR: se produjo un error durante el envío o en respuesta a mensajes enviados a través del espacio de nombres de medios.
• CAC: Mensajes enviados correctamente mediante el espacio de nombres de CAC
• CAC-ERROR: Se produjo un error durante el envío o en respuesta a mensajes enviados a través del espacio de nombres CAC.
• REPRODUCCIÓN: Registro que muestra el resultado cuando se hace clic en el botón Qué está sonando en la herramienta de CaC
• USER: Registro que muestra el mensaje personalizado que ingresó el usuario con el botón Insertar mensaje en la herramienta de CaC

Prueba Cast Cast Connect

Para probar Cast Connect, sigue estos pasos antes de establecer una sesión:

1. Ingresa el ID de la app receptora asociado al receptor compatible con Cast Connect y haz clic en Establecer el ID de la app.
2. Haz clic en el botón Show Android TV Options.
3. Marca la casilla de verificación androidReceiverCompatible. Si tu receptor no requiere que se configure Launch Credentials, o deseas probar lo que sucede en caso de que no esté configurado, puedes detenerte aquí y continuar con el paso 5.
4. Ingresa Launch Credentials y haz clic en el botón Configurar credenciales de inicio para establecer las credenciales de inicio de la sesión de Cast Connect (opcional).
5. Para iniciar una sesión de transmisión, haz clic en el ícono para transmitir ubicado en el encabezado o en el menú para transmitir de tu navegador Chrome.

Tu aplicación de Android TV ahora debería iniciarse en tu dispositivo.

Nota: La herramienta de CaC no puede recuperar ningún registro de tu dispositivo Android TV. A fin de depurar tu app para Android TV y ver los registros relevantes, usa adb a través de tu terminal o de Android Studio, como lo harías normalmente para acceder a los registros y depurar tu app.