مسار الاستيراد

يقوم الاستيراد بتحويل مجلد الملفات إلى إدخال كتالوج دون تعديل بايت من الملفات. هذه الصفحة هي المسار الذي يقف وراء التدفق الموضح في دليل الاستخدام.

المسح

تُراقب المجلدات المراقبة عبر أحداث نظام الملفات في المنصة، وتُمهل ثم يُعاد مسحها عند التغيير؛ وتصالح عمليات المسح مع قائمة المرشحات الموجودة بدل البدء من جديد. يصنّف الماسح مجلدًا كإصدار واحد (صوت مباشرة بداخله، أو مجلدات فرعية بشكل أقراص مثل CD1/CD2)، أو يدخل فيه كمجموعة. تُصنّف الملفات حسب الامتداد إلى صوت، وأعمال فنية، ومستندات، ثم يُفحص الصوت: codec المهم هو ما يجده FFmpeg في البايتات، لا امتداد الملف. تُستبعد المجلدات التي تحتوي علامات تنزيل جزئي حتى ينتهي التنزيل.

تحوّل CUE sheet صورة صوتية واحدة إلى قائمة مسارات. يتعامل المحلل مع pregaps وpostgaps، والمؤدين وISRCs لكل مسار، وتخطيطات CUE ذات الصورة أحادية الملف وذات ملف لكل مسار. تتحول حدود المسارات من CUE frames (1/75 من الثانية) إلى مواضع عينات دقيقة، تصبح لاحقًا نوافذ البايت والعينة التي يستخدمها التشغيل.

مشاريع البيانات الفوقية

يخزن كل مرشح مسودة واحدة من البيانات الفوقية القابلة للتحرير ومنشأ اختياري. ويمكن أن تكون المسودة فارغة، أو ملأها مباشرة، أو ملؤها من إصدار خارجي، أو ملؤها من لقطة سريعة مخزنة لعلامة الملف. تسجل السجلات المنشأ حيث بدأت المسودة الحالية؛ ولا تمحو التحرير لاحقا. لا يوجد مصدر للمدخل المباشر والمسودة الملغاة.

يعرض أعلى موضع للبيانات الفوقية إما المسودة، أو متصفح البحث عبر الإنترنت، أو متصفح وسوم الملفات. فتح أو إغلاق متصفح لا يعيد كتابة المسودة. تطبيقing مصدر يستبدل المسودة، ومصدرها، وغطاء المصدر المختار في معاملة قاعدة بيانات واحدة مع الاحتفاظ بأدوار الملف، CUE ربط، وتخصيص الأقراص، وغيرها من قرارات رسم الخرائط.

البحث عبر الإنترنت

البحث عبر الإنترنت هو المسار الوحيد الذي يقوم بعملية تحديد الهوية، وهو يحسب معرّف القرص من سجل القطع أو ورقة CUE، ويتعرف على رموز الأعمدة المتوازية ونص الفهرس باستخدام OCR، ويستفسر عن MusicBrainz وDiscogs، ويطابق النتائج.

لإعداد مصدر البيانات الوصفية الافتراضي ثلاث قيم. ينشئ بلا مسودة فارغة ولا يبدأ أي عمل على البيانات الوصفية. تقرأ وسوم الملفات لقطة الوسوم وتطبقها. يفتح البحث عبر الإنترنت سير العمل عبر الإنترنت. ويختار وضع البحث عبر الإنترنت الافتراضي بين تلقائي، الذي يضع استخراج الأدلة واستعلامات المزوّدين والمطابقة في الطابور، والبحث يدويًا، الذي لا يبدأ التعرّف. يستخدم فتح البحث عبر الإنترنت لأي مرشح الوضع المحدد، ولا يعيد الوضع التلقائي تشغيل عملية نشطة أو مكتملة.

وسوم الملفات

وسوم الملفات تقرأ العلامات الصوتية المدمجة و CUE البيانات الوصفية بكسل ما لم تكن هي الافتراضية المحددة لمرشح تم اكتشافه حديثا. تخزن الصورة المسبقة لقطة سريعة مختومة بتوليد المسح للمرشح، ومراجعة تحرير الملف، وملفات الصوت الملاحظة. تطبيق استبدال المسودة من تلك الصورة السريعة بالضبط. الاستيراد يستهلك نفس الصورة السريعة ويفشل قبل أن تكتب المكتبة إذا تغيرت ختمه أو ملاحظاته؛ فهو لا يقرأ إجابة مختلفة.

ولا يقوم الإدخال المباشر بأي إدخال/إخراج للبيانات الفوقية. ويمكن تحرير حقول إصدار المسودة الفارغة وتتبعها فورا، وتصبح قابلة للاستيراد عندما يتم التحقق من صحة الحقول المطلوبة والتخطيطات. ولا تعامل القائمة المرشحة المنشأ المفقود على أنه خطأ أو طلب للاهتمام.

المصادر

يُستعلم MusicBrainz بلا حساب، بوتيرة صارمة قدرها طلب واحد في الثانية. يصادق Discogs برمز المستخدم الشخصي من keyring، بوتيرة وإعادة محاولة داخل حدود معدله، ويُبلّغ عن الرمز المرفوض كذلك حتى تستطيع الواجهة تعليمه بدل أن تفشل عمليات البحث بصمت. تُخبأ الردود لكل جلسة، ويُؤرشف JSON الخام للمصدر الفائز في قاعدة البيانات لإعادة تفسير لاحقة.

التثبيت

تأكيد استيراد يعمل، بالترتيب:

1. Decode verification: يُفك ترميز كل مسار من البداية إلى النهاية؛ والنسخة الصوتية التي لا يمكن فك ترميزها بالكامل تفشل الاستيراد قبل كتابة أي شيء (يمكن تعطيل ذلك براية إعداد).
2. تحليل الجهارة: يُقاس الجهارة المتكاملة وtrue peak لكل مسار ولكل ألبوم أثناء مرور فك الترميز نفسه، ويُخزنان لاستخدام replay-gain.
3. Cover selection: يُعاد رسم الفن المختار (بعيد، أو صورة مجلد، أو مضمن) إلى صورة عرض مصغرة؛ ويبقى الأصل بين ملفات الإصدار إذا جاء من المجلد.
4. كتابة ذرية: يُثبت الإصدار، والمسارات، والاعتمادات، والهويات، والصيغ، والمقاطع، والملفات، والغلاف في معاملة واحدة. لا توجد حالة نصف مستوردة.

ينتهي الإصدار وهو يشير إلى ملفات المستخدم في مكانها. إذا اختار المستخدم إدارة سحابية، يحدث الرفع بعد التثبيت كانتقال تخزين، وتبقى بايتات الملفات الأصلية مصدر الحقيقة طوال الوقت؛ لا يُحذف أو يُعدّل أي شيء أعطاه المستخدم لـ bae.

التعرف على النسخ الصوتية

يسجل كل إصدار content hash على بنية مجلده المستورد (المسارات النسبية والأحجام، مستقلًا عن الموقع). تستخدمه إعادة المسح لتعليم المجلدات الموجودة أصلًا في المكتبة، وتستخدمه إعادة استيراد النسخة نفسها لإيجاد إصدارها السابق واستبداله بدل تكراره.