Ativação por voz
Diagrama de steps
Usuário opta-in por voz em Settings
UsuárioSwitch master default OFF. Ativar surfaces os toggles secundários (talk mode, hot word, debug record).
App pede permissão de mic
AppDiálogo de permissão da plataforma. Negado significa que os toggles voltam pra OFF; revisitar Settings pra tentar de novo.
Usuário fala a wake word
Usuário"Ei Koder" ou hot phrase configurada. Ring buffer pré-wake é estritamente local — nunca sai do device.
SDK detecta o wake
SDKopenWakeWord (default) ou Porcupine (fallback) flippa a captura de áudio pra talk mode.
App entra em talk mode
AppChrome visual flippa pro estado talk-mode; mic fica aberto até timeout idle ou barge-in parar.
Usuário diz "deixa pra lá"
UsuárioApp sai do talk mode; mic volta pro standby buffer da wake-word.
Pitfalls comuns
- Streamar o ring buffer pré-wake pro servidor — viola o contrato de privacidade; o buffer tem que ser local-only.
- Talk mode default-on — surpreende o usuário, drena bateria, quebra a postura de consent.
- Subir debugRecord enabled em build não-dev — captura áudio real sem opt-in explícito.