ข้ามไปที่เนื้อหา

การตั้งค่า PortAudio (ไมโครโฟน)

ฟีเจอร์ การแปลสด ใช้แพ็กเกจ Python sounddevice ซึ่งอาศัยไลบรารี C PortAudio ในการเข้าถึงอุปกรณ์ไมโครโฟนในทุกระบบปฏิบัติการ ผู้ใช้ส่วนใหญ่จำเป็นต้องติดตั้งการพึ่งพาระดับระบบนี้

Windows

โดยปกติ wheel ที่คอมไพล์ล่วงหน้าสำหรับ sounddevice และ PyAudio จะรวมไบนารี PortAudio ไว้ใน Windows การติดตั้งทั่วทั้งระบบด้วยตนเองมักไม่จำเป็น หากคุณพบข้อผิดพลาด โปรดตรวจสอบว่าไดรเวอร์เสียงของคุณเป็นเวอร์ชันล่าสุด

macOS

ใช้ Homebrew เพื่อติดตั้ง PortAudio:

brew install portaudio

Linux

ชื่อแพ็กเกจขึ้นอยู่กับการแจกจ่ายของคุณ แพ็กเกจการพัฒนา (มักลงท้ายด้วย -dev หรือ -devel) ต้องได้รับการติดตั้งเพื่อให้ Python สามารถสร้างการผูก C ได้หากไม่มี wheel ที่คอมไพล์ล่วงหน้า

sudo apt-get install portaudio19-dev

sudo dnf install portaudio-devel

sudo pacman -S portaudio

การแก้ไขปัญหา

หากแอปพลิเคชันยังคงรายงานว่าไม่สามารถเข้าถึงไมโครโฟนได้หลังจากการติดตั้ง:

  1. ตรวจสอบให้แน่ใจว่าแอปพลิเคชันเทอร์มินัล (หรือสภาพแวดล้อมเดสก์ท็อป) ของคุณได้รับอนุญาตให้เข้าถึงไมโครโฟน (โดยเฉพาะใน macOS)
  2. รีสตาร์ทแอปพลิเคชัน (หรือเทอร์มินัล/เซิร์ฟเวอร์ MCP) เพื่อให้รับเส้นทางไลบรารีใหม่