Picture-in-Picture (PiP)

1O que é o Picture-in-Picture?#

O PiP permite que seu app continue mostrando conteúdo em uma pequena janela flutuante quando o usuário pressiona Home ou troca de app.

Perfeito para:

• Apps de streaming de vídeo (estilo YouTube)
• Sites de esportes / eventos ao vivo
• Apps web de videoconferência
• Sites de visualizadores de música
• Plataformas de vídeos educacionais

2Ative no gerador#

Na Etapa 2 (Configurações de exibição):

1. Role até 'Opções de exibição'
2. Ative 'Picture-in-Picture (PiP)'
3. Gere seu APK

Exige Android 8.0 (API 26) ou superior. Dispositivos mais antigos ignoram essa configuração sem problemas.

3Como funciona#

Quando o PiP está ativado:

1. O usuário está assistindo a um vídeo / usando seu app
2. O usuário pressiona o botão Home
3. O app encolhe para uma pequena janela flutuante
4. O usuário pode usar outros apps enquanto assiste
5. Tocar na janela PiP volta ao app em tela cheia

A janela PiP mostra o que o WebView estava exibindo naquele momento.

4Otimização do site (opcional)#

Seu site pode detectar o modo PiP e otimizar a visualização. Quando a janela encolhe, você pode querer esconder menus e mostrar apenas o vídeo.

// Detect PiP mode in your website JS (resize fires on window, never on document):
window.addEventListener('resize', function() {
  if (window.innerWidth < 300) {
    // PiP mode - show only video
    document.querySelector('.navbar').style.display = 'none';
    document.querySelector('video').style.width = '100%';
  } else {
    // Full mode - restore UI
    document.querySelector('.navbar').style.display = 'block';
  }
});

5Limitações#

⚠️ Somente Android 8.0+ (API 26)

⚠️ Alguns dispositivos podem não suportar PiP (por exemplo, a edição Android Go)

⚠️ O tamanho da janela PiP é controlado pelo Android, não pelo seu app

✅ Funciona tanto com vídeo quanto com conteúdo que não é vídeo

✅ Nenhuma alteração no site é necessária - funciona direto