Tiles de configurações rápidas (Quick Settings) para Android para controle de áudio: troca de dispositivo de saída e acesso ao painel de volume.
Este aplicativo adiciona dois tiles personalizados às Configurações Rápidas do Android. O tile Audio Output abre o seletor nativo de dispositivo de saída de áudio; o tile Volume Panel abre o painel de volume do sistema. Cada tile pode ser adicionado de forma independente — use um, os dois, ou nenhum.
- 🎧 Tile "Audio Output": acesso rápido ao seletor de dispositivo de saída de áudio
- 🔊 Tile "Volume Panel": acesso direto ao painel de volume do sistema (mídia, notificações, alarme)
- 📌 Funciona como widget na home screen (ex: Nothing Phone) — ambos os tiles respondem ao toque simples
- 🔄 Integração com o sistema nativo do Android
- 🌐 Suporte a português brasileiro e inglês
- 📱 Compatível com Android 11+ (API 30+), compilado com API 36
- ⚡ Leve e sem consumo de bateria em segundo plano
- Android 11 (API 30) ou superior
- Android Studio (para compilação)
- Clone o repositório:
git clone https://github.com/weslley75/AudioOutputSwitcher.git
cd AudioOutputSwitcher- Compile o projeto:
./gradlew assembleRelease- O APK será gerado em
app/build/outputs/apk/release/
- Instale o APK no seu dispositivo Android
- Abra as Configurações Rápidas (deslize duas vezes para baixo na barra de status)
- Toque no ícone de editar (lápis)
- Encontre "Audio Output" e/ou "Volume Panel" na lista de tiles disponíveis
- Arraste o(s) tile(s) para a área de tiles ativos
Tile "Audio Output"
- Deslize para baixo para abrir as Configurações Rápidas
- Toque no tile para abrir o seletor de dispositivo de saída de áudio
- Selecione o dispositivo desejado no diálogo que abrir
Tile "Volume Panel"
- Deslize para baixo para abrir as Configurações Rápidas
- Toque no tile para abrir o painel de volume do sistema
- Ajuste volumes de mídia, notificações, alarme e outros
O aplicativo é composto por:
- AudioOutputTileService: Tile de troca de dispositivo de saída de áudio; comunica-se com o SystemUI via broadcast para abrir o diálogo nativo
- VolumePanelTileService: Tile de painel de volume; abre o painel de volume do sistema no toque simples
- VolumePanelActivity: Activity transparente acionada pelo long press do tile "Audio Output", abre o painel de volume
- TileServiceExt: Extension function compartilhada que encapsula
startActivityAndCollapsecom suporte a Android 14+ - AudioOutputFallback: Fallback em cascata — se o broadcast for bloqueado pela ROM, tenta Painel de Volume e depois Configurações de Som
- Recursos localizados: Suporte a inglês e português (Brasil)
O projeto usa GitHub Actions para:
- ✅ Build automático em cada push/PR
- ✅ Testes automatizados
- ✅ Release automático quando você criar uma tag
v* - ✅ APK debug e release disponíveis nos artifacts e releases
- ✅ Dependabot configurado para atualizar dependências automaticamente
Para criar um release:
git tag v1.0.1
git push origin v1.0.1# Compilar e instalar versão debug
./gradlew installDebug
# Executar testes unitários
./gradlew test
# Executar testes instrumentados
./gradlew connectedAndroidTest
# Limpar projeto
./gradlew cleanapp/src/main/
├── java/br/com/wasystems/audiooutputswitcher/
│ ├── AudioOutputTileService.kt # Tile de troca de dispositivo de saída
│ ├── VolumePanelTileService.kt # Tile de painel de volume
│ ├── VolumePanelActivity.kt # Activity de long press (painel de volume)
│ ├── AudioOutputFallback.kt # Fallback em cascata
│ └── TileServiceExt.kt # Extension: startActivityAndCollapse
├── res/
│ ├── values/strings.xml # Strings em inglês
│ ├── values-pt-rBR/strings.xml # Strings em português
│ ├── drawable/ic_audio_output.xml # Ícone do tile Audio Output
│ └── drawable/ic_volume_panel.xml # Ícone do tile Volume Panel
└── AndroidManifest.xml
Contribuições são bem-vindas! Sinta-se à vontade para:
- Fazer fork do projeto
- Criar uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abrir um Pull Request
Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.
- Requer Android 11 ou superior (minSdk 30)
- Pode não funcionar em algumas ROMs customizadas que modificam o SystemUI
O tile não aparece nas configurações rápidas:
- Verifique se você está usando Android 11 ou superior
- Reinicie o dispositivo após a instalação
O diálogo não abre:
- Verifique se há dispositivos de áudio conectados
- Tente reproduzir algum áudio antes de usar o tile
Se você encontrar algum problema ou tiver sugestões, por favor abra uma issue.
Desenvolvido com ❤️ por WA Systems