ملف OnSong^®

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

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

ما بداخلها

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

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

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

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

ما يحمله

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

ملزمة أم أرشيف؟

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

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

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

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

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

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

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