Descarga Android WebCast - Descarga del código fuente Android WebCast

Android WebCast

Otro código fuente

v05.01.00

Descargar

Transmisión web

Aplicación de Android para extraer URL de vídeo (archivo/transmisión) de sitios web y verlos en otro lugar (reproductor de vídeo interno/externo, Google Chromecast, ExoAirPlayer).

Capturas de pantalla..

Transmisión web

Recorrido

BrowserActivity se muestra cuando se inicia la aplicación e incluye:
- un navegador web muy básico
  - barra de direcciones
  - WebView
- iconos de la barra de acciones:
  - alternar marcador
    - agregar/eliminar la URL del sitio web actual hacia/desde la lista de marcadores guardados persistentemente
- elementos del menú de la barra de acciones:
  - Marcadores
    - cajón abierto a la izquierda: Marcadores
  - Vídeos
    - cajón abierto a la derecha: Vídeos
  - Ajustes
    - abrir SettingsActivity
  - Salida
    - cierre toda la interfaz de usuario y salga de la aplicación
- cajón de la izquierda: Marcadores
  - contiene una lista persistente de:
    - URL de sitios web que se han guardado mediante el icono de alternancia de marcador
    - URL de vídeos que se han guardado a través del cajón de vídeos
  - haga clic en un elemento de la lista para:
    - abrir la URL del sitio web en WebView
    - ver URL del vídeo
      - SettingsActivity determina la acción particular que se realizará
  - Haga clic largo en un elemento de la lista para:
    - rebautizar
    - borrar
- cajón de la derecha: vídeos
  - contiene una lista transitoria de URL de videos que se han encontrado en la página web que está actualmente cargada en WebView
    - esta lista se borra cada vez que WebView navega a una nueva página web
  - haga clic en un elemento de la lista para:
    - agregue la URL del video a la lista de marcadores guardados persistentemente
    - ver URL del vídeo
      - SettingsActivity determina la acción particular que se realizará
  - Haga clic largo en un elemento de la lista para:
    - borrar
SettingsActivity se inicia desde el menú de la barra de acciones en BrowserActivity e incluye:
- Reproductor de video para seleccionar si desea ver videos usando...
  - interno con remitente Chromecast
    - iniciar VideoActivity
  - externo
    - iniciar el selector de actividad con una intención implícita
      - acción
        android.intent.action.VIEW
      - datos
        URL del vídeo
      - tipo
        tipo mime para formato de vídeo
      - extras
        referUrl
        (Cadena) URL de referencia
        utilizado por ExoAirPlayer
  - Remitente de ExoAirPlayer
    - iniciar ExoAirPlayerSenderActivity
  - Configuración de proxy HLS
    - iniciar el selector de actividad con una intención implícita
      - acción
        android.intent.action.VIEW
      - datos
        http://webcast-reloaded.surge.sh/proxy.html#/watch/${base64_video}/referer/${base64_referer}
      - tipo
        "texto/html"
    - iniciar HlsProxyConfigurationActivity
      - solo cuando no hay ninguna actividad que tenga un filtro de intención coincidente
        lo cual nunca debería suceder, ya que cualquier navegador web estándar debería ofrecer manejar este Intent
VideoActivity se inicia cuando se mira la URL de un video usando el reproductor de video interno e incluye:
- exojugador
  - muestra un ícono en la esquina inferior derecha de la barra de herramientas de controles de video para activar o desactivar el modo de pantalla completa
- Remitente de Chromecast
  - muestra un ícono de transmisión en la barra de acción cuando se detecta al menos un Google Chromecast en la LAN
  - cuando está conectado a un Chromecast
    - Las URL de vídeo se comunican a la aplicación del receptor que se ejecuta en Chromecast.
    - la aplicación del receptor Chromecast carga la URL del vídeo en un reproductor de vídeo HTML5 integrado
      - La transferencia de datos de vídeo se produce directamente entre el Chromecast y el servidor que aloja la URL del vídeo.
      - La transferencia no se efectuaría por cualquiera de los siguientes eventos:
        VideoActivity detenida
        BrowserActivity detenida
        Se cerró la aplicación WebCast
        Dispositivo Android apagado
- lista de URL de vídeos
  - haga clic en un elemento de la lista para:
    - reproducir URL del vídeo
      - si está conectado a un Chromecast:
        en Chromecast
      - de lo contrario:
        en Android, en ExoPlayer
        todas las solicitudes HTTP incluyen la URL de referencia
ExoAirPlayerSenderActivity se inicia cuando se mira la URL de un video usando el remitente ExoAirPlayer e incluye:
- WebView que carga una sola página web
  - La URL de la página web depende de la versión de Android.
    - Android 5.0 y más reciente
      - versión que usa ES6+ javascript moderno
    - Android 4.x y anteriores
      - versión que utiliza javascript compatible con ES5
  - El hash de URL contiene:
    - #/watch/${base64_video}/referer/${base64_referer}
- La página web lee datos del hash de URL y rellena previamente los campos:
  - URL del vídeo
  - URL de referencia
- La página web lee datos de las cookies y rellena previamente los campos:
  - anfitrión
  - puerto
  - https
- proporciona una interfaz de usuario básica para controlar cualquier aplicación del receptor ExoAirPlayer a la que se pueda acceder a través de la red
HlsProxyConfigurationActivity se inicia cuando se mira la URL de un video usando la configuración HLS-Proxy en un dispositivo sin ningún navegador web disponible e incluye:
- WebView que carga una página web compatible con ES5
  - El hash de URL contiene:
    - #/watch/${base64_video}/referer/${base64_referer}
- La página web lee datos del hash de URL y rellena previamente los campos:
  - URL del vídeo
  - URL de referencia
- La página web lee datos de las cookies y rellena previamente los campos:
  - anfitrión
  - puerto
  - https
- Al hacer clic en el botón Cargar reproductor se realizan las siguientes tareas:
  - configura una nueva URL de video que redirige el manifiesto HLS a través de HLS-Proxy
  - redirige WebView a otra página web compatible con ES5 que proporciona destinos de punto final opcionales para el manifiesto HLS proxy
    - Página web ES6 para el remitente ExoAirPlayer
    - Página web de ES5 para el remitente de Chromecast
      - en WebView en Android 4.x y versiones anteriores:
        La funcionalidad del reproductor de video no funciona.
      - en WebView en Android 5.0 y posteriores:
        La funcionalidad del reproductor de video funciona.
        La funcionalidad del remitente de Chromecast no funciona

Advertencias importantes

algunas URL de video pueden reproducirse en WebCast y ExoAirPlayer, pero no pueden reproducirse en Chromecast u otros reproductores de video externos
- Esto puede ocurrir cuando la URL de un video está alojada en un servidor que utiliza el encabezado de solicitud HTTP Referer para restringir el acceso, lo cual es una estrategia común.
  - WebCast y ExoAirPlayer tienen la funcionalidad de configurar el valor de este encabezado para cada URL de video única.
  - Las aplicaciones del receptor Chromecast no pueden cambiar el valor de este encabezado porque están restringidas por políticas de seguridad estándar del navegador.
    - las especificaciones para XHR y fetch prohíben cambiar ciertos encabezados de solicitud HTTP, incluido Referer
    - la aplicación del receptor WebCast Chromecast
      - intenta cambiar el valor de este encabezado
      - revela en la consola del depurador remoto que este intento genera la advertencia:
        Se negó a establecer un encabezado "referente" inseguro
  - otros reproductores de vídeo externos necesitarían:
    - lea la referUrl adicional en la intención inicial
    - configurar su biblioteca de cliente HTTP para cambiar el valor de este encabezado
  - HLS-Proxy proporciona una cómoda solución alternativa de uso general
    - configuración para la integración con WebCast:
      1. instalar HLS-Proxy
        npm install --global "@warren-bank/hls-proxy"
      2. instalar WebMonkey
        aplicación para abrir la configuración de HLS-Proxy
      3. en WebMonkey
        instalar el script de usuario recargado por WebCast
        agrega funcionalidad mejorada a la página web compatible con ES5 que proporciona configuración de HLS-Proxy
        habilita un botón etiquetado: Iniciar aplicación
        al hacer clic:
        iniciar el selector de actividad con una intención implícita
        acción
        android.intent.action.VIEW
        datos
        URL de manifiesto HLS proxy
        tipo
        "aplicación/x-mpegurl"
      4. en WebCast
        Configuración > Reproductor de vídeo > Configuración de HLS-Proxy
    - uso:
      1. ejecutar proxy HLS
        hlsd --port 8080 --req-insecure --useragent "Chrome/90"
      2. en WebCast
        navegar por WebView interno a una página que tenga la transmisión de video HLS deseada
        abre el cajón de vídeos (a la derecha)
        haga clic en la URL para ver la transmisión de video HLS deseada
        haga clic en: Ver
        Se iniciará un selector de actividad.
        WebMonkey se incluirá en la lista de aplicaciones que contienen una actividad coincidente.
        haga clic en: WebMonkey
      3. en WebMonkey
        configure la ubicación de su instancia en ejecución de HLS-Proxy:
        anfitrión
        puerto
        https
        haga clic en: Iniciar aplicación
        Se iniciará un selector de actividad.
        WebCast se incluirá en la lista de aplicaciones que contienen una actividad coincidente.
        haga clic en: Reproductor de vídeo WebCast
      4. en WebCast
        haga clic en Ícono de remitente de Chromecast para transmitir la transmisión de video HLS proxy a un dispositivo Chromecast
el componente WebView del sistema Android es totalmente responsable de la experiencia del navegador web
- Este componente tiene una historia complicada.
- sin entrar en detalles:
  - en versiones de Android < 5.0
    - el componente WebView está integrado en el firmware
      - no se puede actualizar
      - hace un mal trabajo al cargar páginas web modernas, ya que el lenguaje javascript (ES6+) y la especificación html (HTML5) han cambiado significativamente
  - en versiones de Android >= 5.0
    - el componente WebView es una aplicación independiente
      - se puede actualizar
  - en versiones de Android >= 7.0
    - el componente WebView es reemplazado por un componente del navegador web Google Chrome, cuando está instalado y habilitado
      - se puede actualizar

Organización del repositorio de Git

ramas rancias
- 01-fundación
  - colección de pequeñas aplicaciones para desarrollar y probar funciones experimentales
- 02-webcast-httpcliente
  - utilizó una biblioteca de cliente HTTP externa: Apache HttpClient
  - usó el encabezado de respuesta Content-Type para detectar archivos de video
- 03-webcast-okhttp
  - utilizó una biblioteca de cliente HTTP externa: okhttp
  - usó el encabezado de respuesta Content-Type para detectar archivos de video
- 04-nombre-de-archivo-webcast
  - utiliza WebView para descargar todas las solicitudes HTTP
  - utiliza expresiones regulares para detectar extensiones de archivos asociadas con formatos de video en solicitudes de URL
sucursales activas
- 05-webcast-nombre-archivo-media3
  - utiliza WebView para descargar todas las solicitudes HTTP
  - utiliza expresiones regulares para detectar extensiones de archivos asociadas con formatos de video en solicitudes de URL
  - se basa en la rama 04-webcast-filename y migra de ExoPlayer a AndroidX Media3
- 00-aplicación-receptor-chromecast
  - Aplicación del receptor WebCast Chromecast
- páginas-gh
  - Aplicación del receptor WebCast Chromecast
    - el HEAD de esta rama siempre debe hacer referencia/alias el HEAD de la rama 00-chromecast-receiver-app
  - alojado por páginas de GitHub

Aspectos destacados del código fuente

identificación de URL de vídeo en solicitudes HTTP salientes
- BrowserWebViewClient
  - expresiones regulares para detectar archivos de video
La misma metodología implementada por una extensión del navegador web.
- Extensión de Chromium "recargada por WebCast"
  - expresiones regulares para detectar archivos de video