TrackAudio
1.3.0-beta.3
الجيل القادم من عميل Audio-For-VATSIM ATC لأنظمة التشغيل macOS وLinux وWindows.
راجع الإصدارات لمعرفة أحدث الإصدارات، وتذكر أن الإصدارات التجريبية قد تكون غير مستقرة. يرجى الإبلاغ عن أي مشاكل على جيثب.
يعد TrackAudio ببساطة الإصدار التالي من VectorAudio، باستخدام مجموعة مختلفة من التقنيات. لم تعد VectorAudio تتم صيانتها ودعمها، لذا يجب عليك التبديل إلى TrackAudio في أقرب وقت ممكن.
يتمتع نظام macOS بأذونات صارمة حول مدخلات لوحة المفاتيح الخلفية. يجب أن يطالبك TrackAudio عند التشغيل لأول مرة بطلب أذونات مراقبة الإدخال. في بعض الأحيان، عند تحديث التطبيق، سيتراجع هذا الإعداد عن نفسه. في هذه الحالة، يرجى الانتقال إلى الإعدادات -> الخصوصية والأمان -> مراقبة الإدخال وإضافة TrackAudio إلى القائمة (قم بإزالته إذا كان موجودًا بالفعل). يعد هذا مطلوبًا تمامًا لأنه بخلاف ذلك، لن تعمل ميزة "الضغط والتحدث" عندما لا تكون النافذة قيد التركيز (إذا كنت تستخدم الضغط على لوحة المفاتيح للتحدث، فإن الضغط والتحدث بعصا التحكم لا يتطلب هذا الإذن)
تنشأ هذه المشكلة لأن نظام الضغط والتحدث لم يتمكن من تحديد اسم المفتاح الذي حاولت ربطه. سيظل المفتاح يعمل كضغط وتحدث عادي. ومع ذلك، لتمكيننا من دعم المفتاح الذي حددته، يرجى فتح مشكلة GitHub. قم بتضمين نظام التشغيل الذي تستخدمه، ونسخة من ملف trackaudio.log الخاص بك (راجع الأسئلة الشائعة أدناه لمعرفة موقع الملف)، والاسم الفعلي للمفتاح الذي تنوي ربطه.
تحدث هذه المشكلة نظرًا لأن بعض أذرع التحكم ترسل أمرًا ثابتًا للأسفل. لمعالجة هذه المشكلة، قمنا بتنفيذ طريقة لتعطيل الضغط على مفتاح عصا التحكم مؤقتًا أثناء تحديد مفتاح الضغط والتحدث على لوحة المفاتيح. لاستخدام هذه الميزة، انقر بزر الماوس الأيمن فوق الزر "Set new PTT" في مربع حوار الإعدادات بدلاً من النقر فوقه بزر الماوس الأيسر. سيؤدي هذا إلى منع مستمع المفاتيح من تسجيل مدخلات عصا التحكم أثناء ضبط مفتاح الضغط والتحدث.
على نظام التشغيل MacOS: ~/Library/Application Support/trackaudio على Linux: ~/.local/state/trackaudio على نظام التشغيل Windows: %LocalAppData%trackaudio
اطلب من FE تحديد المحطة في قاعدة بيانات AFV. وفقًا لدليل AFV FE، يجب تحديد جميع المحطات في قاعدة البيانات. يدعم TrackAudio إنشاء محطة مخصصة إذا قمت بتسجيل الدخول باستخدام DEL أو GND أو TWR الذي لا يحتوي على تعريف للمحطة. سيقوم بعد ذلك بوضع جهاز إرسال واستقبال في مركز الرؤية الخاص بك في عميل وحدة التحكم الخاصة بك.
نعم! قام @KingfuChan بتحديث البرنامج الإضافي RDF لـ EuroScope ليشمل دعم TrackAudio. ابحث عن البرنامج المساعد في هذا الريبو.
نعم، ولكن فقط إذا قمت بإضافة تردد عن طريق إشارة النداء (يجب تحديده في قاعدة البيانات). يتم تمكين HF Squelch افتراضيًا
نعم، باستخدام القائمة الموجودة على اليمين، ومع ذلك، سيؤدي ذلك إلى إنشاء جهاز إرسال واستقبال واحد فقط (هوائي) في مركز الرؤية الخاص بك في عميل atc الخاص بك. وهذا يعني أنك لن تحصل على نفس التغطية الراديوية التي تحصل عليها المحطات المحددة في قاعدة البيانات.
عندما تنقر بزر الماوس الأيمن فوق XCA على التردد الذي تستمع إليه، وإذا قمت بتسجيل الدخول كـ ATC، فسيتم اقتران جميع أجهزة الإرسال والاستقبال لهذا التردد. وهذا يعني أن جميع عمليات الإرسال التي يستقبلها جهاز إرسال واستقبال في تلك القائمة سيتم إعادة إرسالها أيضًا بواسطة جميع أجهزة الإرسال والاستقبال الأخرى. وهذا يسمح للطيارين في أجزاء مختلفة من المجال الجوي الخاص بك بسماع بعضهم البعض، حيث أنهم قد يستخدمون جهاز إرسال واستقبال مختلف. بشكل عام، يجب أن تستخدم XC في كل مرة تتحكم فيها.
عندما نقرت بالزر الأيسر على XCA، فإنك تقوم بتنشيط "الازدواج المتقاطع". هذا هو نفس النقر على "XC" في AFV لنظام التشغيل Windows، ويسمح لك بالاقتران عبر الترددات، مما يعني أنه يمكنك الانضمام إلى مجموعات متعددة من أجهزة الإرسال والاستقبال بغض النظر عن التردد. ومع ذلك، انتبه، فقد تتسبب في تداخل الراديو عن طريق تمكين هذا. على سبيل المثال، إذا كان لديك تردد XCA يحتوي على جهاز إرسال واستقبال بالقرب من حدود vAcc مجاور مع تردد آخر يقع في الطرف الآخر من قطاعك، بعيدًا عن تلك الحدود مع vAcc المجاور، فسوف تقوم فجأة بتوسيع تغطية هذا التردد الثاني إلى الحدود مع جارك. هذه الميزة مفيدة في الغالب لمواضع نسبة النقر إلى الظهور، عند إعادة تجميع القطاعات الكبيرة معًا.
نعم! الق نظرة في الويكي. يقدم TrackAudio WebSocket وHTTP SDK. إذا كنت بحاجة إلى ميزات إضافية، يرجى فتح مشكلة مع طلب تفصيلي، ويسعدني النظر فيها دون أي ضمانات.
لكي يعمل TrackAudio، يتطلب ما يلي:
يكون اتصال HTTPS (المنفذ 443) بنقطة النهاية Raw.githubusercontent.com ممكنًا
يكون اتصال HTTPS (المنفذ 443) بنقطة النهاية voice1.vatsim.net ممكنًا
يكون اتصال HTTPS (المنفذ 443) بنقطة النهاية slurper.vatsim.net ممكنًا
يكون اتصال UDP ثنائي الاتجاه ممكنًا تجاه خوادم vatsim
تأكد من أن برنامج مكافحة الفيروسات أو جدار الحماية أو أي وحدة تحكم أخرى في الشبكة تسمح بالوصول إلى نقاط النهاية هذه.
لكي يعمل SDK
يكون منفذ TCP المحلي 49080 مفتوحًا لكل من HTTP وWebSocket
يجب أيضًا مزامنة تاريخ ووقت نظامك بشكل صحيح ليعكس الوقت الحالي الفعلي (بغض النظر عن المناطق الزمنية).
عند الطلب، يمكنك تمكين التسجيل المطول للواجهة الخلفية والذي قد يوفر بعض معلومات تصحيح الأخطاء المفيدة. للقيام بذلك، قم بإنشاء ملف فارغ يسمى Verbose.enable في المجلد حيث يتم تخزين ملف التكوين والسجل.
اقرأ هذه الوثيقة بالكامل أولاً. إذا لم تتمكن من العثور على إجابة لمشكلتك، فيرجى فتح مشكلة على GitHub، وإرفاق الأسطر ذات الصلة من ملف afv.log الذي يجب أن يكون في نفس المجلد مثل الملف القابل للتنفيذ.
يتوفر TrackAudio في AUR ويمكن تثبيته باستخدام مساعد AUR المفضل لديك، على سبيل المثال:
yay -S trackaudio-bin
paru -S trackaudio-bin
يتم حزم TrackAudio كملف .deb ويجب تشغيله دون أي إجراءات محددة.
قم بتنزيل أحدث إصدار على صفحة الإصدار وقم بتشغيل .deb. إذا لم يتم فتحه، فقد ترغب في التأكد من أن لديه الإذن للتشغيل كملف قابل للتنفيذ عن طريق تشغيل chmod +x على ملف .deb.
ملاحظة: سيؤدي هذا إلى تثبيت libafv_native.so في /usr/lib، وهي مكتبة مطلوبة لتشغيل TrackAudio.
قم بتنزيل أحدث إصدار من صفحة الإصدار وقم بتثبيت التطبيق في مجلد التطبيقات لديك.
يتوفر TrackAudio في نسختين، أحدهما لـ Apple Silicon (arm64) والآخر لأجهزة Intel Mac (x64).
وبدلاً من ذلك، يمكن تثبيت TrackAudio باستخدام Homebrew. قم بتشغيل الأوامر التالية لتثبيت Homebrew Tap أولاً ثم Homebrew Cask. بهذه الطريقة تتم ترقية التطبيق عند تشغيل brew upgrade .
# أضف صنبور Tapbrew flymia/homebrew-trackaudio# قم بتثبيت تثبيت caskbrew --cask Trackaudio
اعتمادًا على نظامك، سيقوم الصندوق بتثبيت إصدار ARM أو الإصدار x86_64.
قم بتنزيل وتثبيت Visual Studio c++ Redistributable، وهو أحد متطلبات تشغيل TrackAudio
قم بتنزيل أحدث إصدار على صفحة الإصدار وقم بتشغيل الملف القابل للتنفيذ. يجب أن يؤدي هذا إلى تثبيت TrackAudio.
يعتمد TrackAudio على AFV-Native وSFML (لمعالجة الإدخال).
مطلوب cmake لبناء المشروع. سيتم تنزيل التبعيات من خلال vcpkg في وقت الإنشاء. راجع vcpkg.json لمزيد من التفاصيل.
في Linux، الحزم التالية مطلوبة: build-essentials libx11-dev libxrandr-dev libxcursor-dev libxi-dev libudev-dev libgl1-mesa-dev pkg-config ، قد تحتاج أيضًا إلى حزم إضافية لتمكين الواجهات الخلفية الصوتية المختلفة، مثل مثل Alsa أو JACK أو PulseAudio.
على نظام التشغيل macOS، تكون أدوات XCode Command Line وCMake وHomebrew مطلوبة، كما يلزم توفر حزمة البيرة التالية: pkg-config
في نظام التشغيل Windows، يلزم وجود Visual Studio (إصدار المجتمع جيد) مع تثبيت Desktop development with C++ .
إذا لم يكن cmake-js مثبتًا بالفعل، فقم بتشغيل npm install -g cmake-js . بالنسبة للبناء الأول قم بتشغيل ما يلي:
تحديث الوحدة الفرعية لـ git --init --الواجهة الخلفية البعيدة/vcpkg تحديث الوحدة الفرعية لـ git --init --remote backend/extern/afv-native بناء تشغيل npm: الواجهة الخلفية تثبيت npm تشغيل npm ديف
تتطلب الإصدارات اللاحقة فقط الأمر npm run dev إذا كنت ترغب فقط في تعديل الواجهة الأمامية. سيتطلب إنشاء الواجهة الخلفية لـ C++ تشغيل npm run build:backend .
سيتم تجميع TrackAudio تلقائيًا كملف .dmg على أنظمة التشغيل macOs، و.deb على نظام Linux، ومثبت .exe على نظام التشغيل Windows. للحزمة، قم بتشغيل الأمر المناسب للنظام الأساسي المطلوب.
| منصة | يأمر |
|---|---|
| لينكس | npm run build:linux |
| ماك | npm run build:mac |
| ويندوز | npm run build:win |
إذا كنت ترغب في المساعدة في المشروع، فنحن نرحب بك دائمًا لفتح علاقات عامة. ؟
