macOS 설치 가이드

이 가이드는 macOS 시스템에 Sokuji를 설치하는 방법을 안내합니다. Sokuji는 향상된 오디오 처리 기능을 위한 가상 오디오 드라이버가 포함된 서명 및 공증된 .pkg 설치 프로그램으로 제공됩니다.

설치 단계

공식 GitHub 릴리스 페이지를 방문하여 macOS용 Sokuji 최신 버전을 다운로드하세요.

팁: 어떤 버전을 다운로드해야 할지 모르시겠나요? Apple 메뉴() → "이 Mac에 관하여"를 클릭하여 칩 유형을 확인하세요. "Apple M1/M2/M3/M4"가 표시되면 arm64 버전을, "Intel"이 표시되면 x64 버전을 선택하세요.

버전 0.46.5부터 PKG 설치 프로그램은 서명 및 공증되어 있어 macOS에서 추가 단계 없이 열 수 있습니다.

Sokuji와 가상 오디오 드라이버를 설치합니다.

다운로드 폴더에서 다운로드한 .pkg 파일을 찾습니다 (예: Sokuji-x.x.x-arm64.pkg 또는 Sokuji-x.x.x-x64.pkg)
PKG 파일을 더블 클릭하여 설치를 시작합니다
macOS 설치 프로그램이 열립니다 - "계속"을 클릭하여 진행합니다
설치 세부 정보를 검토하고 "설치"를 클릭합니다
메시지가 표시되면 관리자 비밀번호를 입력합니다 (드라이버 설치에 필요)
설치가 완료될 때까지 기다립니다 (보통 1-2분)
설치가 완료되면 "닫기"를 클릭합니다

설치 프로그램이 시스템 수준 오디오 드라이버를 설치해야 하므로 관리자 비밀번호가 필요합니다. 가상 오디오 드라이버는 고급 오디오 처리 기능을 활성화합니다.

응용 프로그램 폴더에서 Sokuji를 엽니다. 보안 우회 절차는 필요하지 않습니다.

이제 Sokuji가 실행되고 있으므로 첫 사용을 위해 구성해 보겠습니다:

macOS가 메시지를 표시할 때 마이크 권한을 부여합니다
선호하는 인터페이스 언어를 선택합니다
AI 공급자(OpenAI, Google Gemini 등)를 선택합니다
선택한 공급자의 API 키를 입력합니다
번역을 위한 소스 언어와 대상 언어를 선택합니다
마이크를 선택하고, 음성 블록에서 기본 재생 장치를 스피커나 헤드폰으로 선택합니다. Sokuji 자체의 가상 오디오 장치는 여기에 표시되지 않습니다. 상대방에게 들리는 번역이 번역을 그 장치, 즉 회의 앱에서 선택하는 가상 마이크로 보냅니다
마이크와 스피커 설정을 테스트합니다

축하합니다! 이제 Sokuji를 사용할 준비가 되었습니다. 가상 오디오 드라이버가 설치되었으며 오디오 장치 목록에서 사용할 수 있습니다. 마이크 버튼을 클릭하여 실시간 번역을 시작하세요.

Sokuji가 마이크에 액세스할 수 없는 경우:

번역된 오디오가 들리지 않는 경우:

시스템 환경설정 → 사운드 → 출력을 엽니다
선호하는 출력 장치를 선택합니다
출력 볼륨이 음소거되지 않았는지 확인합니다
Sokuji의 음성 블록에서 듣고 싶은 행의 장치를 확인합니다: 내 번역은 나도 듣기(기본값은 꺼짐), 상대방의 번역은 내가 듣는 번역, 그 밖의 소리는 기본 재생 장치

Mac에 맞는 올바른 설치 프로그램을 다운로드했는지 확인하세요:

오디오 장치에 "SokujiVirtualAudio"가 표시되지 않는 경우:

먼저 Sokuji가 복구하도록 하세요: 드라이버는 설치되어 있지만 macOS가 불러오지 않았을 때 Sokuji가 시작 시 이를 알리고 복구를 제안합니다. 관리자 비밀번호를 입력하면 Sokuji가 Core Audio를 재시작하여 드라이버를 불러오며, Sokuji를 다시 시작할 필요는 없습니다
드라이버가 설치되었는지 확인합니다: ls /Library/Audio/Plug-Ins/HAL/
존재하지 않으면 Sokuji를 다시 설치해야 할 수 있습니다
존재하는데 복구로도 해결되지 않으면 CoreAudio를 재시작해 보세요: sudo killall coreaudiod, 또는 Mac을 다시 시작하세요
시스템 설정 → 사운드에서 장치가 나타나는지 확인합니다

이것은 정상이고 필요합니다: