EarLLM One — Construir e Manter

Visão Geral

Construa, mantenha e expanda o projeto EarLLM One para Android — um aplicativo Kotlin/Compose que conecta fones de ouvido Bluetooth a um LLM através de um pipeline de voz.

Quando Usar Esta Habilidade

• Quando o usuário mencionar "earllm" ou tópicos relacionados
• Quando o usuário mencionar "earbudllm" ou tópicos relacionados
• Quando o usuário mencionar "earbud app" ou tópicos relacionados
• Quando o usuário mencionar "voice pipeline kotlin" ou tópicos relacionados
• Quando o usuário mencionar "bluetooth audio android" ou tópicos relacionados
• Quando o usuário mencionar "sco microphone" ou tópicos relacionados

Não Use Esta Habilidade Quando

• A tarefa não estiver relacionada à construção do earllm
• Uma ferramenta mais simples e específica puder lidar com a solicitação
• O usuário precisar de assistência de propósito geral sem conhecimento de domínio

Como Funciona

EarLLM One é um aplicativo Android multimódulo (Kotlin + Jetpack Compose) que captura voz de fones de ouvido Bluetooth, a transcreve, envia para um LLM e reproduz a resposta de volta.

Localização do Projeto

C:\Users\renat\earbudllm

Gráfico de Dependência de Módulos

app ──→ voice ──→ audio ──→ core-logging
  │       │
  ├──→ bluetooth ──→ core-logging
  └──→ llm ──→ core-logging

Módulos e Arquivos Chave

Configuração de Build

• SDK: minSdk 26, targetSdk 34, compileSdk 34
• Ferramentas de Build: AGP 8.2.2, Kotlin 1.9.22, Gradle 8.5
• Compose BOM: 2024.02.00
• Dependências Chave: OkHttp, AndroidX Security (EncryptedSharedPreferences), DataStore, Media

Hardware Alvo

Fatos Técnicos Críticos

Estes são fatos verificados a partir de documentação oficial e testes de dispositivo. Trate-os como verdade absoluta ao tomar decisões:

1. Bluetooth SCO é limitado a entrada mono de 8kHz na maioria dos dispositivos. Alguns suportam mSBC de 16kHz. BLE Audio (Android 12+, TYPE_BLE_HEADSET = 26) suporta até estéreo de 32kHz. Sempre prefira BLE Audio quando disponível.

2. startBluetoothSco() foi depreciado desde o Android 12 (API 31). Use AudioManager.setCommunicationDevice(AudioDeviceInfo) e clearCommunicationDevice() em vez disso. O projeto já implementa ambos os caminhos em AudioRouteController.kt.

3. Samsung One UI 7/8 tem um bug conhecido de corrupção HFP onde a reprodução A2DP corrompe o link SCO. O aplicativo lida com isso com detecção de silêncio e fallback automático para o microfone integrado do telefone.

4. Os controles de toque do Redmi Buds 6 Pro devem ser definidos como "Padrão" (Reproduzir/Pausar) no aplicativo companheiro Xiaomi Earbuds. Se definidos como ANC ou funções personalizadas, os eventos são tratados internamente pelos fones de ouvido e nunca chegam ao Android.

5. Android 14+ requer a permissão FOREGROUND_SERVICE_MICROPHONE e foregroundServiceType="microphone" na declaração do serviço. RECORD_AUDIO deve ser concedido antes de startForeground().

6. A fonte de áudio VOICE_COMMUNICATION habilita AEC (Cancelamento de Eco Acústico), que é crítico para evitar que a saída de áudio TTS retorne para a entrada do microfone STT. Nunca altere esta fonte sem entender as implicações do eco.

7. Nunca reproduza TTS (A2DP) enquanto grava simultaneamente via SCO. A sequência correta é: parar a reprodução → mudar para HFP → gravar → mudar para A2DP → reproduzir resposta.

Fluxo de Dados

Toque no botão do headset
  → MediaSession (HeadsetButtonController)
  → TapAction.RECORD_TOGGLE
  → VoicePipeline.toggleRecording()
  → VoiceCaptureController captura PCM (16kHz mono)
  → stopRecording() retorna ByteArray
  → SpeechToTextController.transcribe(pcmData)

…