ملف OnSong^®

صيغة ملف OnSong^® Binder هي الطريقة التي ينقل بها OnSong أغنية أو مجموعة أو كتابًا كاملاً بين المكتبات. مثل OnSong^® Archive فإنها تحمل كل شيء مطلوب لإعادة بناء المحتوى في مكان آخر — نص الأغنية والمرفقات والأنماط والإعدادات والنقل والملاحظات — لكن حيث أن الأرشيف عبارة عن كتلة معتمة واحدة، فإن ملف Binder عبارة عن مجلد من الملفات العادية. هذا يجعله قابلاً للقراءة والفحص وقادرًا على حمل الوسائط التي تعتمد عليها الأغنية بجانب الأغنية نفسها بطريقة مستقلة عن النظام الأساسي.

صيغة ملف OnSong^® Binder لها امتداد ملف إما .onsongbinder أو .binder، ونوع MIME من application/onsong-binder.

ما بداخله

ملف Binder عبارة عن أرشيف ZIP. قم بفك ضغطه وستجد مجلدًا باسم معرّف العنصر، يحتوي على:

• manifest.json — العنصر نفسه، مسلسل. كل خاصية يعرفها OnSong عنه، بنفس الشكل الذي يستخدمه OnSong web API.
• ملفه، إن كان يملك واحدًا. يحتفظ المرفق باسم الملف الأصلي، لذا فإن ملف PDF أو MP3 داخل ملف Binder هو فقط ذلك الملف PDF أو MP3.
• مجلدات لعناصره الفرعية، مسماة حسب نوعها — songs و attachments — كل منها يحتوي على مجلدات إضافية بنفس الشكل تمامًا.

يتكرر هذا الهيكل في جميع أنحاء: المجموعة تحتوي على أغانٍ، والأغنية تحتوي على مرفقات، وكل واحدة عبارة عن مجلد به ملف manifest خاص به بجانب ملفاته الخاصة. ملف Binder يحتوي على كتاب من مائتي أغنية له نفس الصيغة كما هو الحال مع ملف يحتوي على مخطط واحد.

داخل manifest، تتم وضع علامة على المراجع للعناصر الفرعية بواسطة بادئة $binder.، بحيث يمكن للقارئ معرفة الفرق بين قيمة تنتمي إلى العنصر وواحدة تشير إلى مجلد بجانبها.

ما الذي يحمله

• الأغانيPB — مخطط الوتر وكل شيء مرفق به.
• المجموعات — الأغانيPB بترتيبها، مع ترتيب المجموعة الخاص بها.
• الكتب — مجموعة كاملة.
• المرفقات — ملفات PDF والصور والصوت وأي ملف آخر مرتبط بالأغنية. يمكنك اختيار تضمين المرفقات المستخدمة فقط بدلاً من كل إصدار تمت إضافته.

ملف Binder أو Archive؟

يقوم كلاهما بعملية الذهاب والعودة لمحتويات المكتبة بأمانة، لذا فإن الاختيار يتعلق بما تحتاجه من الملف:

• OnSong^® Archive هي الصيغة الأقدم، وهي ما يجب استخدامه للتوافق مع الإصدارات السابقة من OnSong.
• OnSong^® Binder هي الصيغة الحالية. استخدمها للمشاركة مع الإصدارات الأحدث من OnSong — وعندما تريد ملفًا يمكنك فتحه والنظر بداخله.

الاستيراد والتصدير

يتم استيراد ملفات Binder بنفس طريقة استيراد أي ملف آخر: افتح واحدًا من Files أو Mail أو AirDrop أو خدمة سحابية واختر OnSong. استيراد ملف Binder يحتوي على مجموعة يعيد إنشاء المجموعة وكل أغنية بها؛ استيراد واحد يحتوي على أغنية واحدة يضيف تلك الأغنية.

لإنشاء واحد، استخدم Share واختر OnSong Binder كالصيغة.

ملفات Binder هي أيضًا ما يرسله OnSong Connect بين الأجهزة عندما يطلب جهاز واحد من جهاز آخر أغنية أو مجموعة، لذا فإن نفس الصيغة الموجودة في تطبيق Files الخاص بك هي التي تتنقل عبر الشبكة.

لأن ملف Binder عبارة عن ZIP يحتوي على JSON عادي وملفات وسائط عادية، فإنه الصيغة الصحيحة التي يجب استخدامها عندما تحتاج إلى رؤية ما قام OnSong بتخزينه فعلاً — أو عندما يحتاج شيء ما إلى قراءة محتواك وليس OnSong.