macOS 권한
요약
Whisperer가 통화를 듣고, 단축키에 반응하고, 스크린샷을 읽으려면 세 가지 macOS 시스템 권한이 필요합니다: 마이크(Microphone), 화면 기록(Screen Recording), 손쉬운 사용(Accessibility). 각 권한은 저마다의 역할을 맡고 있으며, 하나라도 빠지면 일부 기능은 아예 켜지지 않습니다.
가장 중요한 규칙: "화면 기록" 권한이 없으면 상대방의 목소리를 들을 수 없습니다. macOS는 시스템 오디오(통화 중 상대방의 목소리)를 오직 화면 기록 메커니즘을 통해서만 앱에 전달합니다. 반면 마이크는 오직 본인의 목소리만 처리합니다.
언제 사용하나요
- 클라이언트를 처음 실행해 권한 마법사가 열릴 때.
- 스크립트에
[Me]줄만 나타나고[Other]는 비어 있을 때. - 전역 단축키가 작동하지 않을 때(예: 푸시투토크).
- macOS를 업데이트하거나, 앱을 재설치하거나, 새 Mac으로 옮긴 후.
세 가지 권한과 각각이 중요한 이유
| 권한 | 시스템 이름 | 필요한 이유 |
|---|---|---|
| 마이크 | Microphone | 본인 목소리를 캡처합니다. 스크립트에 [Me]로 표시됩니다. |
| 화면 기록 | Screen Recording | 시스템 오디오 — 상대방의 목소리 — 와 스크린샷을 캡처합니다. 스크립트의 [Other]에 해당합니다. 이 권한이 없으면 상대방의 목소리가 들리지 않습니다. |
| 손쉬운 사용 | Accessibility | 전역 단축키: 푸시투토크, 오버레이 표시/숨기기, 지식 베이스 검색, 스크린샷, 텍스트 입력. |
단계별 안내
- 권한 마법사를 실행합니다. 처음 시작할 때 권한이 하나라도 누락되어 있으면 Whisperer가 마법사(PermissionWizard)를 자동으로 엽니다. 마법사는 세 가지 권한 각각의 상태와 시스템 설정으로 바로 이동하는 버튼을 보여줍니다. 안내를 따르세요 — 이것이 가장 쉬운 방법입니다.
- 개인정보 보호 설정을 엽니다. 수동으로 진행하는 경우: Apple 메뉴 → 시스템 설정 → 개인정보 보호 및 보안.
- 마이크 권한을 부여합니다. 마이크 섹션을 열고 Whisperer 옆의 토글을 켭니다. 이렇게 하면 본인 목소리 캡처가 활성화됩니다.
- 화면 기록 권한을 부여합니다. 화면 기록 섹션을 열고 Whisperer 옆의 토글을 켭니다. 이것이 가장 중요한 권한입니다: 시스템 오디오(상대방의 목소리)와 스크린샷을 모두 제공하기 때문입니다. macOS가 권한 적용을 위해 앱을 재시작하라고 요청할 수 있습니다 — 재시작하세요.
- 손쉬운 사용 권한을 부여합니다. 손쉬운 사용 섹션을 열고 Whisperer 옆의 토글을 켭니다. 이렇게 하면 전역 단축키가 활성화됩니다.
- Whisperer를 재시작합니다. 권한을 부여한 후(특히 "화면 기록") 변경 사항이 적용되도록 앱을 종료했다가 다시 엽니다.
- 확인합니다. 체험 세션을 시작하고 스크립트에 두 역할 —
[Me]와[Other]— 이 모두 나타나는지, 단축키가 작동하는지 확인합니다.
스크린샷
📸 [스크린샷: 처음 시작 시의 권한 마법사(PermissionWizard) — 세 가지 권한의 상태]
📸 [스크린샷: 시스템 설정 → 개인정보 보호 및 보안 → 화면 기록에서 Whisperer 토글이 켜져 있는 모습]
📸 [스크린샷: Whisperer 토글이 켜진 마이크 섹션과 손쉬운 사용 섹션]
흔한 실수
- 마이크 권한만 부여한 경우. 가장 흔한 상황입니다: 스크립트에
[Me]는 나타나지만[Other]는 나타나지 않습니다. 원인은 "화면 기록" 권한을 부여하지 않았기 때문입니다. 이 권한이 없으면 시스템 오디오를 사용할 수 없습니다. - 권한을 부여했는데도 작동하지 않는 경우. macOS는 권한 상태를 캐시합니다. 토글을 켠 후에는 앱을 재시작해야 합니다. 그래도 해결되지 않으면 macOS 권한 문제를 참고하세요.
- 단축키가 작동하지 않는 경우. 손쉬운 사용 권한을 부여하지 않았습니다. 이 권한이 없으면 전역 키가 가로채지지 않습니다.
- 스크린샷이 없거나 비전 기능이 작동하지 않는 경우. 스크린샷도 "화면 기록"을 통해 처리됩니다 — 바로 그 권한을 확인하세요.
- 목록에 Whisperer가 없는 경우. 때때로 앱이 섹션에 자동으로 나타나지 않습니다 — 이 내용은 문제 해결 문서에서 다룹니다.
모범 사례
- 처음 실행할 때 권한 마법사를 끝까지 진행하세요 — 세 가지 항목을 한 번에 모두 처리해 줍니다.
- "화면 기록" 권한을 부여한 후에는 항상 앱을 재시작하세요 — 이는 macOS의 표준 동작입니다.
- macOS 업데이트 후 무언가 "고장 난" 경우, 세 가지 토글을 모두 다시 설정하세요. OS 업데이트가 때때로 앱에 대한 신뢰를 초기화하기 때문입니다.
- 라벨링 논리를 기억하세요:
[Me]= 마이크,[Other]= 화면 기록. 이를 알면 어떤 권한을 고쳐야 하는지 빠르게 판단할 수 있습니다.