Download Android WebCast - Download do código-fonte Android WebCast

Android WebCast

Outro código-fonte

v05.01.00

Baixar

Webcast

Aplicativo Android para extrair URLs de vídeo (arquivo/stream) de sites e assisti-los em outro lugar (player de vídeo interno/externo, Google Chromecast, ExoAirPlayer).

Capturas de tela..

Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast Webcast

Percorrer

BrowserActivity é mostrado quando o aplicativo é iniciado e inclui:
- um navegador muito básico
  - barra de endereço
  - WebView
- ícones da barra de ação:
  - alternar favorito
    - adicionar/remover URL do site atual de/para a lista de favoritos salvos persistentemente
- itens do menu da barra de ação:
  - Marcadores
    - gaveta aberta à esquerda: Favoritos
  - Vídeos
    - gaveta aberta à direita: Vídeos
  - Configurações
    - abra SettingsActivity
  - Saída
    - feche toda a UI e saia do aplicativo
- gaveta à esquerda: Favoritos
  - contém uma lista persistente de:
    - URLs de sites que foram salvos por meio do ícone de alternância de favoritos
    - URLs de vídeo que foram salvos na gaveta de vídeos
  - clique em um item da lista para:
    - abrir URL do site no WebView
    - assistir URL do vídeo
      - SettingsActivity determina a ação específica a ser executada
  - clique longamente em um item da lista para:
    - renomear
    - excluir
- gaveta à direita: Vídeos
  - contém uma lista temporária de URLs de vídeo que foram encontrados na página da web atualmente carregada no WebView
    - esta lista é limpa cada vez que o WebView navega para uma nova página da web
  - clique em um item da lista para:
    - adicione o URL do vídeo à lista de favoritos salvos persistentemente
    - assistir URL do vídeo
      - SettingsActivity determina a ação específica a ser executada
  - clique longamente em um item da lista para:
    - excluir
SettingsActivity é iniciado no menu da barra de ação em BrowserActivity e inclui:
- Video Player para selecionar se deseja assistir a vídeos usando ..
  - interno com remetente do Chromecast
    - iniciar VideoActivity
  - externo
    - iniciar o seletor de atividades com uma intenção implícita
      - Ação
        android.intent.action.VIEW
      - dados
        URL do vídeo
      - tipo
        mime-type para formato de vídeo
      - extras
        referUrl
        (String) URL do referenciador
        usado por ExoAirPlayer
  - Remetente ExoAirPlayer
    - iniciar ExoAirPlayerSenderActivity
  - Configuração do proxy HLS
    - iniciar o seletor de atividades com uma intenção implícita
      - Ação
        android.intent.action.VIEW
      - dados
        http://webcast-reloaded.surge.sh/proxy.html#/watch/${base64_video}/referer/${base64_referer}
      - tipo
        "texto/html"
    - iniciar HlsProxyConfigurationActivity
      - somente quando não há nenhuma atividade com um filtro de intenção correspondente
        o que nunca deveria acontecer, já que qualquer navegador padrão deveria se oferecer para lidar com esta intenção
VideoActivity é iniciado quando um URL de vídeo é assistido usando o player de vídeo interno e inclui:
- ExoPlayer
  - exibe um ícone no canto inferior direito da barra de ferramentas de controles de vídeo para ativar/desativar o modo de tela cheia
- Remetente do Chromecast
  - exibe um ícone de transmissão da barra de ação quando pelo menos um Google Chromecast é detectado na LAN
  - quando conectado a um Chromecast
    - URLs de vídeo são comunicados ao aplicativo receptor em execução no Chromecast
    - o aplicativo receptor do Chromecast carrega o URL do vídeo em um player de vídeo HTML5 incorporado
      - a transferência de dados de vídeo ocorre diretamente entre o Chromecast e o servidor que hospeda o URL do vídeo
      - a transferência não seria efetuada por nenhum dos seguintes eventos:
        VideoActivity interrompida
        BrowserActivity interrompida
        Aplicativo WebCast encerrado
        Dispositivo Android desligado
- lista de URLs de vídeo
  - clique em um item da lista para:
    - reproduzir URL do vídeo
      - se conectado a um Chromecast:
        no Chromecast
      - de outra forma:
        no Android, no ExoPlayer
        todas as solicitações HTTP incluem o URL do referenciador
ExoAirPlayerSenderActivity é iniciado quando um URL de vídeo é assistido usando o remetente ExoAirPlayer e inclui:
- WebView que carrega uma única página da web
  - URL da página web depende da versão do Android
    - Android 5.0 e mais recente
      - versão usando ES6+ javascript moderno
    - Android 4.xe mais antigo
      - versão usando javascript compatível com ES5
  - O hash de URL contém:
    - #/watch/${base64_video}/referer/${base64_referer}
- a página da web lê dados do hash de URL e preenche previamente os campos:
  - URL do vídeo
  - URL de referência
- a página da web lê dados de cookies e preenche previamente os campos:
  - hospedar
  - porta
  - https
- fornece uma interface de usuário básica para controlar qualquer aplicativo receptor ExoAirPlayer acessível pela rede
HlsProxyConfigurationActivity é iniciado quando um URL de vídeo é assistido usando a configuração HLS-Proxy em um dispositivo sem qualquer navegador da web disponível e inclui:
- WebView que carrega uma página da web compatível com ES5
  - O hash de URL contém:
    - #/watch/${base64_video}/referer/${base64_referer}
- a página da web lê dados do hash de URL e preenche previamente os campos:
  - URL do vídeo
  - URL de referência
- a página da web lê dados de cookies e preenche previamente os campos:
  - hospedar
  - porta
  - https
- clicar no botão Carregar Player executa as seguintes tarefas:
  - configura um novo URL de vídeo que redireciona o manifesto HLS por meio do HLS-Proxy
  - redireciona WebView para outra página da Web compatível com ES5 que fornece destinos de endpoint opcionais para o manifesto HLS com proxy
    - Página da web ES6 para remetente ExoAirPlayer
    - Página da web ES5 para remetente do Chromecast
      - no WebView no Android 4.x e versões anteriores:
        a funcionalidade do player de vídeo não funciona
      - no WebView no Android 5.0 e mais recente:
        a funcionalidade do player de vídeo funciona
        A funcionalidade de remetente do Chromecast não funciona

Advertências importantes

alguns URLs de vídeo podem ser reproduzidos no WebCast e no ExoAirPlayer, mas não podem ser reproduzidos no Chromecast ou em outros players de vídeo externos
- isso pode ocorrer quando um URL de vídeo é hospedado por um servidor que usa o cabeçalho de solicitação HTTP Referer para restringir o acesso, o que é uma estratégia comum
  - WebCast e ExoAirPlayer têm a funcionalidade de configurar o valor deste cabeçalho para cada URL de vídeo exclusivo
  - Os aplicativos receptores do Chromecast não podem alterar o valor desse cabeçalho porque são restritos pelas políticas de segurança padrão do navegador
    - as especificações para XHR e fetch proíbem a alteração de determinados cabeçalhos de solicitação HTTP, incluindo Referer
    - o aplicativo receptor WebCast Chromecast
      - tenta alterar o valor deste cabeçalho
      - revela no console do depurador remoto que esta tentativa gera o aviso:
        Recusou-se a definir o "referenciador" do cabeçalho inseguro
  - outros players de vídeo externos precisariam:
    - leia o extra referUrl no Intent inicial
    - configure sua biblioteca cliente HTTP para alterar o valor deste cabeçalho
  - O HLS-Proxy fornece uma solução alternativa conveniente de uso geral
    - configuração para integração com WebCast:
      1. instalar proxy HLS
        npm install --global "@warren-bank/hls-proxy"
      2. instalar o WebMonkey
        aplicativo para abrir a configuração HLS-Proxy
      3. em WebMonkey
        instalar script de usuário recarregado pelo WebCast
        adiciona funcionalidade aprimorada à página da web compatível com ES5 que fornece configuração HLS-Proxy
        ativa um botão chamado: Iniciar aplicativo
        quando clicado:
        iniciar o seletor de atividades com uma intenção implícita
        Ação
        android.intent.action.VIEW
        dados
        URL de manifesto HLS com proxy
        tipo
        "aplicativo/x-mpegurl"
      4. em webcast
        Configurações > Player de vídeo > Configuração do proxy HLS
    - uso:
      1. execute o proxy HLS
        hlsd --port 8080 --req-insecure --useragent "Chrome/90"
      2. em webcast
        navegue no WebView interno para uma página que tenha o fluxo de vídeo HLS desejado
        abra a gaveta de vídeos (à direita)
        clique no URL do stream de vídeo HLS desejado
        clique em: Assistir
        um seletor de atividades será iniciado
        WebMonkey será incluído na lista de aplicativos que contêm uma atividade correspondente
        clique em: WebMonkey
      3. em WebMonkey
        configure o local da sua instância em execução do HLS-Proxy:
        hospedar
        porta
        https
        clique em: Iniciar aplicativo
        um seletor de atividades será iniciado
        O WebCast será incluído na lista de aplicativos que contêm uma atividade correspondente
        clique em: Reprodutor de vídeo WebCast
      4. em webcast
        clique no Ícone do remetente do Chromecast para transmitir o stream de vídeo HLS com proxy para um dispositivo Chromecast
o componente Android System WebView é totalmente responsável pela experiência do navegador da web
- este componente tem uma história complicada
- sem entrar em detalhes:
  - em versões do Android < 5.0
    - o componente WebView está incorporado ao firmware
      - não pode ser atualizado
      - faz um péssimo trabalho ao carregar páginas da web modernas, pois a linguagem javascript (ES6+) e as especificações html (HTML5) mudaram significativamente
  - nas versões do Android >= 5.0
    - o componente WebView é um aplicativo independente
      - pode ser atualizado
  - nas versões do Android >= 7.0
    - o componente WebView é substituído por um componente do navegador Google Chrome, quando instalado e ativado
      - pode ser atualizado

Organização do repositório Git

galhos velhos
- 01-fundação
  - coleção de pequenos aplicativos para desenvolver e testar recursos experimentais
- 02-webcast-httpclient
  - usou uma biblioteca de cliente HTTP externa: Apache HttpClient
  - usou o cabeçalho de resposta Content-Type para detectar arquivos de vídeo
- 03-webcast-okhttp
  - usou uma biblioteca cliente HTTP externa: okhttp
  - usou o cabeçalho de resposta Content-Type para detectar arquivos de vídeo
- 04-webcast-nome do arquivo
  - usa WebView para baixar todas as solicitações HTTP
  - usa expressões regulares para detectar extensões de arquivo associadas a formatos de vídeo em solicitações de URL
filiais ativas
- 05-webcast-nome do arquivo-media3
  - usa WebView para baixar todas as solicitações HTTP
  - usa expressões regulares para detectar extensões de arquivo associadas a formatos de vídeo em solicitações de URL
  - baseia-se no branch 04-webcast-filename e migra do ExoPlayer para o AndroidX Media3
- 00-app receptor chromecast
  - Aplicativo receptor WebCast Chromecast
- páginas gh
  - Aplicativo receptor WebCast Chromecast
    - o HEAD deste branch deve sempre fazer referência/alias ao HEAD do branch 00-chromecast-receiver-app
  - hospedado pelas páginas do GitHub

Destaques do código-fonte

identificação de URLs de vídeo em solicitações HTTP de saída
- BrowserWebViewClient
  - regex para detectar arquivos de vídeo
mesma metodologia implementada por uma extensão de navegador da web
- Extensão do Chromium "WebCast-Reloaded"
  - regex para detectar arquivos de vídeo