TalkBack — o que é, gestos de controle e configuração no Android

O que é o TalkBack?

TalkBack é um leitor de tela para Android, desenvolvido pelo Google e parte do Android Accessibility Suite. Ele fornece feedback por voz e controle por gestos para usuários com deficiência visual. O TalkBack funciona em smartphones, tablets, Smart TVs e dispositivos vestíveis com Wear OS.

O TalkBack apareceu pela primeira vez no Android 1.6 (Donut) em 2009. Inicialmente era um projeto separado, mas com o lançamento do Android 4.0 (Ice Cream Sandwich) tornou-se parte do Android Accessibility Suite — um conjunto de serviços que também inclui Switch Access e Select to Speak. A partir do Android 10, o TalkBack vem pré-instalado em todos os dispositivos com serviços do Google Play, incluindo dispositivos de parceiros — Samsung, Xiaomi, Oppo e outros.

O TalkBack suporta mais de 30 idiomas com vários mecanismos de voz: Google Text-to-Speech, Samsung TTS e de terceiros. Para o português, o Google TTS fornece pronúncia natural e entonação correta. O usuário pode ajustar a velocidade da fala, o tom e selecionar o gênero da voz nas configurações do TalkBack.

Como funciona o TalkBack?

O TalkBack funciona com base no AccessibilityService — um mecanismo do sistema no Android que permite que os aplicativos recebam informações sobre o estado da interface e interajam programaticamente com ela. Quando o TalkBack está ativado, ele intercepta todos os eventos de toque e os transforma em gestos especiais de leitor de tela.

Foco de acessibilidade

O elemento-chave do funcionamento do TalkBack é o foco de acessibilidade. Diferentemente do foco de entrada padrão, que aparece como um destaque de campo de texto, o foco de acessibilidade é exibido como uma moldura amarela ao redor do elemento e é invisível para usuários sem TalkBack. Quando o foco de acessibilidade chega a um elemento, o TalkBack narra seu conteúdo, tipo e estado.

O usuário move o foco de acessibilidade usando gestos: deslizar para a direita — próximo elemento, deslizar para a esquerda — elemento anterior. Os elementos são percorridos na ordem definida pelo AccessibilityNodeInfo — a árvore de acessibilidade que o Android constrói para cada tela. O desenvolvedor pode influenciar a ordem por meio das propriedades accessibilityTraversalBefore e accessibilityTraversalAfter, o que é especialmente importante para telas complexas com layouts personalizados.

AccessibilityNodeInfo e a árvore de acessibilidade

Cada View na tela é representada por um nó na árvore de acessibilidade — um objeto AccessibilityNodeInfo. Este objeto contém: o texto do elemento (contentDescription ou texto da view), tipo do elemento (botão, caixa de seleção, campo de entrada), estado (ativado/desativado/selecionado), posição na tela e uma lista de ações disponíveis. O TalkBack percorre esta árvore e narra cada nó na ordem de percurso.

Se uma View não tiver conteúdo de texto (por exemplo, um ImageView sem descrição), ela se torna invisível para o TalkBack — o usuário não saberá de sua existência. Para resolver isso, o desenvolvedor define contentDescription — uma descrição textual que o TalkBack fala em vez do silêncio. O Android também suporta stateDescription para elementos com estado mutável (marcado/desmarcado) e hintText para campos de entrada com dicas.

Gestos de controle do TalkBack

O TalkBack transforma gestos padrão do Android em gestos especiais de leitor de tela. A maioria das operações é realizada com um ou dois dedos, enquanto os gestos com três dedos são reservados para ações globais.

O gesto de deslizar cima-esquerda (deslize em forma de L) abre o menu global do TalkBack, onde o usuário pode alterar a velocidade da fala, ativar a cortina de tela, iniciar um tutorial ou abrir as configurações. O TalkBack também suporta um menu de contexto para elementos: deslizar cima-direita abre uma lista de ações disponíveis para o elemento atual (por exemplo, “copiar”, “colar” para um campo de texto ou “excluir” para uma mensagem de chat).

TalkBack no desenvolvimento móvel

O Android fornece uma API rica para configuração de acessibilidade. O nível básico é o contentDescription, mas para um suporte de qualidade ao TalkBack é necessário trabalhar com AccessibilityNodeInfo, AccessibilityDelegate e LiveRegion.

ContentDescription e atributos importantes

O atributo android:contentDescription define a descrição textual do elemento para o TalkBack. É obrigatório para ImageView, ImageButton, FloatingActionButton e qualquer View personalizada sem conteúdo de texto. Para elementos padrão (TextView, Button), o contentDescription é opcional — o TalkBack lerá o texto automaticamente.

val avatarView = ImageView(this)
avatarView.contentDescription = "Avatar do usuário"
avatarView.importantForAccessibility =
    IMPORTANT_FOR_ACCESSIBILITY_YES

val playButton = ImageButton(this)
playButton.contentDescription = "Reproduzir vídeo"

val progressBar = ProgressBar(this)
progressBar.importantForAccessibility =
    IMPORTANT_FOR_ACCESSIBILITY_NO

A flag importantForAccessibility controla a visibilidade do elemento para o TalkBack. O valor NO oculta o elemento da árvore de acessibilidade — útil para imagens decorativas, indicadores e fundos personalizados. O valor YES inclui forçosamente o elemento no percurso mesmo que não tenha texto. É importante não abusar do NO: ocultar elementos semanticamente importantes torna o aplicativo inacessível para usuários do TalkBack.

AccessibilityDelegate e ações personalizadas

Para Views personalizadas que não usam manipuladores de clique padrão, é necessário sobrescrever o AccessibilityDelegate — uma classe que lida com eventos de acessibilidade. O delegado permite definir descrições personalizadas, tipos de elemento e listas de ações disponíveis que o TalkBack oferecerá ao usuário por meio do menu de contexto.

class CustomButtonDelegate : View.AccessibilityDelegate() {
    override fun onInitializeAccessibilityNodeInfo(
        host: View, info: AccessibilityNodeInfoCompat
    ) {
        super.onInitializeAccessibilityNodeInfo(host, info)
        info.text = "Botão personalizado"
        info.className = Button::class.java.name
        info.addAction(
            AccessibilityNodeInfoCompat.AccessibilityActionCompat(
                R.id.custom_action, "Compartilhar"
            )
        )
    }

    override fun performAccessibilityAction(
        host: View, action: Int, args: Bundle?
    ): Boolean {
        if (action == R.id.custom_action) {
            shareContent()
            return true
        }
        return super.performAccessibilityAction(host, action, args)
    }
}

No exemplo, o delegado informa ao TalkBack que o elemento é um botão (className = Button) e fornece uma ação personalizada “Compartilhar” que aparecerá no menu de contexto do TalkBack. O método performAccessibilityAction lida com a invocação desta ação. Sem um delegado, o TalkBack trataria a View personalizada como uma área simples não interativa, e o usuário não poderia interagir com ela.

Configurar acessibilidade para o TalkBack

O suporte completo ao TalkBack inclui não apenas contentDescription, mas também gerenciamento de foco, LiveRegion para atualizações dinâmicas, testes com o leitor de tela ativado e adaptação para diferentes versões do Android.

LiveRegion para conteúdo dinâmico

Quando o conteúdo da tela muda sem uma ação explícita do usuário (por exemplo, uma notificação aparece para uma nova mensagem ou um contador de curtidas é atualizado), o TalkBack deve receber uma notificação. Para isso, usa-se o atributo android:accessibilityLiveRegion para uma View em XML ou o método setAccessibilityLiveRegion() em código. O valor polite adiciona o anúncio após a narração atual terminar, enquanto assertive o interrompe imediatamente.

val statusText = TextView(this)
statusText.accessibilityLiveRegion =
    View.ACCESSIBILITY_LIVE_REGION_POLITE

// Quando o texto for atualizado, o TalkBack anunciará
// automaticamente a mudança
statusText.text = "Nova mensagem de Ana"

// Para notificações críticas — assertive
errorBanner.accessibilityLiveRegion =
    View.ACCESSIBILITY_LIVE_REGION_ASSERTIVE

LiveRegion é o equivalente no Android do UIAccessibility.post no iOS. Use polite para a maioria das atualizações (novas mensagens, atualizações de status) e assertive apenas para erros críticos (pagamento falhou, perda de conexão). O uso excessivo de assertive cria uma experiência negativa para o usuário — o TalkBack interromperá constantemente a narração atual.

Agrupamento e provedores de acessibilidade

Para telas complexas onde várias Views formam uma única unidade lógica, usa-se AccessibilityNodeProvider ou focusSearch para sobrescrever a navegação. Por exemplo, um calendário personalizado com 42 células (6 semanas × 7 dias) não deve forçar o usuário a percorrer todos os 42 itens para chegar ao próximo bloco. O desenvolvedor pode agrupar as células em unidades lógicas: mês → semana → dia.

Para Jetpack Compose, o modificador .semantics {} fornece uma API semelhante: contentDescription, liveRegion, stateDescription, disabled e customActions. O Compose também suporta mergeDescendants para mesclar semânticas filhas em uma, simplificando o agrupamento de elementos sem configuração manual de accessibilityDelegate para cada View.

Button(
    onClick = { sendMessage() },
    modifier = Modifier.semantics {
        contentDescription("Enviar mensagem")
        stateDescription("Pronto para enviar")
    }
) {
    Icon(Icons.Filled.Send, "Enviar")
}

O teste do TalkBack é feito usando um dispositivo físico ou emulador com o serviço ativado. Recomenda-se percorrer os cenários principais do usuário com a tela desligada (Screen Curtain) — isso simula uma ausência total de feedback visual. O Android também fornece o Accessibility Scanner — uma ferramenta para detecção automática de problemas de acessibilidade, que destaca elementos sem contentDescription, áreas de toque muito pequenas e baixo contraste.