← العودة الى التوثيق

دليل تثبيت macOS

سيرشدك هذا الدليل خلال تثبيت Sokuji على انظمة macOS. يتوفر Sokuji كمثبت .pkg موقّع وموثّق من Apple يتضمن برنامج تشغيل صوت افتراضي لقدرات معالجة صوت محسنة.

تحميل لنظام macOS

متطلبات النظام

  • ⁦macOS 13 (Ventura)⁩ أو أحدث (منذ ⁦v0.42.2⁩؛ على macOS 12 واصل استخدام ⁦v0.42.1⁩)
  • معالج Apple Silicon (M1/M2/M3/M4) او Intel (x86_64)
  • 4 جيجابايت رام كحد ادنى (8 جيجابايت موصى بها)
  • 200 ميجابايت مساحة قرص متاحة
  • صلاحيات المسؤول (مطلوبة لتثبيت برنامج تشغيل الصوت الافتراضي)
  • اتصال بالانترنت لخدمات الترجمة بالذكاء الاصطناعي
  • ميكروفون ومكبرات صوت/سماعات

خطوات التثبيت

الخطوة 1: تحميل Sokuji

قم بزيارة صفحة الاصدارات الرسمية على GitHub لتحميل احدث اصدار من Sokuji لنظام macOS.

تحميل مثبت PKG

  • Sokuji-x.x.x-arm64.pkg - لاجهزة Mac بمعالج Apple Silicon (M1/M2/M3/M4)
  • Sokuji-x.x.x-x64.pkg - لاجهزة Mac بمعالج Intel
  • يتضمن كل مثبت تطبيق Sokuji وبرنامج تشغيل الصوت الافتراضي
  • حجم الملف حوالي 150-200 ميجابايت

نصيحة: غير متاكد من الاصدار المناسب؟ انقر على قائمة Apple () ← "حول هذا الـ Mac" للتحقق من نوع المعالج. اذا رايت "Apple M1/M2/M3/M4"، اختر اصدار arm64. اذا رايت "Intel"، اختر اصدار x64.

منذ الإصدار 0.46.5 أصبح مثبت PKG موقّعا وموثّقا، لذا يفتحه macOS دون خطوات إضافية.

الخطوة 2: تثبيت PKG

ثبّت Sokuji وبرنامج تشغيل الصوت الافتراضي.

عملية التثبيت

  1. حدد موقع ملف .pkg المحمل في مجلد التنزيلات (مثل Sokuji-x.x.x-arm64.pkg او Sokuji-x.x.x-x64.pkg)
  2. انقر نقرا مزدوجا على ملف PKG لبدء التثبيت
  3. سيفتح مثبت macOS - انقر على "متابعة" للمتابعة
  4. راجع تفاصيل التثبيت وانقر على "تثبيت"
  5. ادخل كلمة مرور المسؤول عند المطالبة (مطلوبة لتثبيت برنامج التشغيل)
  6. انتظر حتى يكتمل التثبيت (عادة 1-2 دقيقة)
  7. انقر على "اغلاق" عند انتهاء التثبيت

ما يتم تثبيته

  • Sokuji.app - يتم تثبيته في /Applications
  • SokujiVirtualAudio.driver - برنامج تشغيل الصوت الافتراضي يتم تثبيته في /Library/Audio/Plug-Ins/HAL
  • سيقوم المثبت تلقائيا باعادة تشغيل CoreAudio لتحميل برنامج التشغيل
كلمة مرور المسؤول مطلوبة لان المثبت يحتاج الى تثبيت برنامج تشغيل صوت على مستوى النظام. يمكّن برنامج تشغيل الصوت الافتراضي ميزات معالجة الصوت المتقدمة.

الخطوة 3: التشغيل الاول

افتح Sokuji من مجلد التطبيقات. لا حاجة إلى أي خطوات أمان إضافية.

الخطوة 4: تكوين Sokuji

الآن بعد تشغيل Sokuji، لنقم بتكوينه للاستخدام الاول:

الاعداد الاولي

  1. امنح اذونات الميكروفون عندما يطلب macOS ذلك
  2. حدد لغة الواجهة المفضلة لديك
  3. اختر مزود الذكاء الاصطناعي (OpenAI، Google Gemini، الخ.)
  4. ادخل مفتاح API للمزود المحدد
  5. حدد لغات المصدر والهدف للترجمة
  6. اختر الميكروفون، وفي قسم الكلام اختر مكبرات الصوت أو السماعات كـ جهاز التشغيل الافتراضي. لا يعرض Sokuji هناك جهاز الصوت الافتراضي الخاص به: الترجمة التي يسمعها الطرف الآخر ترسل ترجمتك إليه، فهو الميكروفون الافتراضي الذي تختاره في تطبيق الاجتماعات
  7. اختبر اعداد الميكروفون ومكبرات الصوت
تهانينا! Sokuji جاهز الآن للاستخدام. تم تثبيت برنامج تشغيل الصوت الافتراضي وهو متاح في قائمة اجهزة الصوت. انقر على زر الميكروفون لبدء الترجمة في الوقت الفعلي.

استكشاف الاخطاء واصلاحها

الميكروفون لا يعمل

اذا لم يتمكن Sokuji من الوصول الى الميكروفون:
  1. افتح تفضيلات النظام ← الامان والخصوصية ← الخصوصية
  2. حدد الميكروفون من الشريط الجانبي الايسر
  3. تاكد من ان Sokuji محدد في القائمة
  4. اذا لم يكن مدرجا، اعد تشغيل Sokuji وامنح الاذن عند المطالبة

لا يوجد اخراج صوتي

اذا لم تتمكن من سماع الصوت المترجم:
  1. افتح تفضيلات النظام ← الصوت ← الاخراج
  2. حدد جهاز الاخراج المفضل لديك
  3. تحقق من ان حجم الاخراج غير مكتوم
  4. في قسم الكلام في Sokuji، تحقق من جهاز الصف الذي تتوقع سماعه: أسمعها أنا أيضًا لترجمتك أنت (متوقف افتراضيًا)، والترجمة التي أسمعها لترجمة الطرف الآخر، وجهاز التشغيل الافتراضي لكل ما عدا ذلك

التطبيق يتعطل على اجهزة Mac بمعالج Intel او مشاكل في الاداء

تاكد من تحميل المثبت الصحيح لجهاز Mac الخاص بك:
  • Apple Silicon (M1/M2/M3/M4): استخدم Sokuji-x.x.x-arm64.pkg
  • Intel: استخدم Sokuji-x.x.x-x64.pkg
  • تحقق من نوع المعالج: قائمة Apple () ← "حول هذا الـ Mac"
  • اذا استخدمت المثبت الخاطئ، حمل الاصدار الصحيح من صفحة الاصدارات
  • اذا استمرت الاعطال مع المثبت الصحيح، تحقق من Console.app لسجلات الاعطال وابلغ عنها على GitHub

برنامج تشغيل الصوت الافتراضي لا يظهر

اذا لم ترَ "SokujiVirtualAudio" في اجهزة الصوت:
  1. دع Sokuji يصلحه أولًا: عندما يكون برنامج التشغيل مثبتًا لكن macOS لم يحمّله، يخبرك Sokuji بذلك عند بدء التشغيل ويعرض عليك إصلاح. أدخل كلمة مرور المسؤول، فيعيد Sokuji تشغيل Core Audio لتحميل برنامج التشغيل، دون الحاجة إلى إعادة تشغيل Sokuji
  2. تحقق مما اذا كان برنامج التشغيل مثبتا: ls /Library/Audio/Plug-Ins/HAL/
  3. اذا لم يكن موجودا، قد تحتاج الى اعادة تثبيت Sokuji
  4. اذا كان موجودا ولم يُجدِ الإصلاح، حاول اعادة تشغيل CoreAudio: sudo killall coreaudiod، أو أعد تشغيل جهاز Mac
  5. تحقق من إعدادات النظام ← الصوت لمعرفة ما اذا كان الجهاز يظهر

التثبيت يتطلب كلمة مرور المسؤول

هذا طبيعي ومطلوب:
  • يحتاج مثبت PKG الى تثبيت برنامج تشغيل صوت على مستوى النظام
  • تتطلب برامج تشغيل الصوت على مستوى النظام صلاحيات المسؤول للتثبيت
  • ادخل كلمة المرور عند المطالبة - هذا آمن ومتوقع
  • اذا لم يكن لديك صلاحيات المسؤول، اتصل بمسؤول النظام