إعداد PortAudio (ميكروفون)¶
تستخدم ميزة الترجمة المباشرة حزمة sounddevice في بايثون، والتي تعتمد على مكتبة C الخاصة بـ PortAudio للوصول إلى أجهزة الميكروفون عبر جميع أنظمة التشغيل. يحتاج معظم المستخدمين إلى تثبيت هذه التبعية على مستوى النظام.
Windows¶
عادةً ما تقوم العجلات المترجمة مسبقًا لـ sounddevice و PyAudio بتجميع مكتبة PortAudio الثنائية على Windows. لا يلزم التثبيت اليدوي على مستوى النظام عادةً. إذا واجهت أخطاء، فتأكد من تحديث برامج تشغيل الصوت لديك.
macOS¶
استخدم Homebrew لتثبيت PortAudio:
Linux¶
يعتمد اسم الحزمة على توزيعتك. يجب تثبيت حزمة التطوير (التي تنتهي عادةً بـ -dev أو -devel) حتى تتمكن بايثون من بناء روابط C إذا لم تكن هناك عجلة مترجمة مسبقًا متاحة.
استكشاف الأخطاء وإصلاحها¶
إذا استمر التطبيق في الإبلاغ عن عدم إمكانية الوصول إلى الميكروفون بعد التثبيت:
- تأكد من أن تطبيق الطرفية (أو بيئة سطح المكتب) لديه إذن للوصول إلى الميكروفون (خاصة في macOS).
- أعد تشغيل التطبيق (أو الخادم الطرفي/MCP) حتى يلتقط مسار المكتبة الجديد.