Permissões de Microfone e Screen Recording no Mac

O Hedy no Mac precisa de duas permissões para funcionar por completo: Microphone (captura sua voz) e Screen Recording (captura o áudio de outros apps, como Zoom, Teams ou Meet durante reuniões virtuais). Ambas ficam em System Settings > Privacy & Security, e ambas podem ser redefinidas após grandes atualizações do macOS.

O Que Cada Permissão Habilita

Permissão	O Que Captura	Sem Ela
Microphone	Sua voz pelo microfone selecionado	O Hedy não consegue gravar nenhum áudio
Screen Recording	O áudio de outros apps tocando no seu Mac (os outros participantes em uma videochamada)	O Hedy grava apenas sua voz — o outro lado das reuniões virtuais fica ausente

Screen Recording parece uma permissão não relacionada — o Hedy não tira screenshots nem grava sua tela. Essa é apenas a permissão guarda-chuva que a Apple usa para qualquer app que captura áudio de outros apps no macOS. O Hedy implementa isso com um CoreAudio process tap, mas a permissão visível para o usuário ainda é chamada de “Screen Recording.”

Concedendo Permissão de Microphone

Abra System Settings
Clique em Privacy & Security na barra lateral
Clique em Microphone
Encontre Hedy na lista e ative o toggle

Se o Hedy não estiver na lista, abra o Hedy e tente iniciar uma sessão — o macOS solicitará a permissão na primeira vez que o Hedy tentar usar o microfone. Se nenhum prompt aparecer, force o encerramento e reabra o Hedy.

Quando a permissão de microfone está ausente, o Hedy mostra: “Microphone permission denied. Please grant Microphone permission in System Settings > Privacy & Security.” com um botão Open Settings que leva você diretamente até lá.

Concedendo Permissão de Screen Recording

Abra System Settings
Clique em Privacy & Security na barra lateral
Clique em Screen Recording
Encontre Hedy na lista e ative o toggle

O Hedy detectará a concessão de permissão automaticamente — você não precisa reiniciar o app para que ela tenha efeito. Se a captura ainda falhar depois de conceder a permissão, sair e reabrir o Hedy é um próximo passo razoável.

Quando a permissão de Screen Recording está ausente no início da sessão, o Hedy mostra: “Screen Recording permission denied. Please grant Screen Recording permission in System Settings > Privacy & Security.” com um botão que abre diretamente o painel correto de Settings.

Se o Hedy ainda não estiver na lista, inicie uma sessão — o Hedy solicita a permissão no início da sessão, e o macOS exibirá o prompt então.

O Que Acontece Se as Permissões Forem Negadas

O Hedy degrada de forma controlada em vez de se recusar a rodar:

Microphone apenas, sem Screen Recording: o Hedy mostrará a caixa de diálogo de permissão de Screen Recording e oferecerá continuar apenas com o microfone. As sessões funcionam, mas apenas sua voz é capturada. Isso é aceitável para trabalho solo ou reuniões presenciais — mas, para videochamadas, você perderá o outro lado.
Sem Microphone: as sessões não conseguem iniciar. O Hedy direcionará você para conceder a permissão.
Nenhum hardware de microfone detectado: o Hedy mostra “No Microphone Detected” com a mensagem “Please connect a microphone or headset to your Mac and try again.” Isso geralmente significa que o microfone integrado do Mac está desativado ou que um microfone removível foi desconectado.
Falha de captura mesmo com permissões concedidas: se o plugin de áudio do macOS não conseguir iniciar a captura (raro), o Hedy mostra “Failed to start audio capture on macOS” com a observação “System audio unavailable - only your microphone will be recorded.” Isso é diferente de uma permissão negada.

Quando as Permissões São Redefinidas

A Apple redefine permissões de apps periodicamente. Os gatilhos mais comuns são:

Grandes atualizações do macOS (por exemplo, de Sonoma para Sequoia)
Reinstalar o Hedy ou movê-lo entre volumes
Algumas auditorias de segurança do macOS (raro, mas acontece — a Apple introduziu prompts semanais de Screen Recording no Sequoia)

Se o Hedy estava capturando reuniões virtuais perfeitamente ontem e não está hoje, revise os dois toggles antes de investigar qualquer outra coisa.

Outras Permissões do macOS Que o Hedy Pode Solicitar

Dependendo dos recursos que você usa, o Hedy também pode pedir:

Camera — apenas quando você está compartilhando screenshots de diagnóstico com o suporte
Photo Library — apenas ao compartilhar arquivos de mídia em tickets de suporte
Local Network — para alguns recursos de conectividade

Essas são opcionais. Você pode deixá-las desativadas sem afetar gravação ou transcrição.