ملزمة OnSong^®

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

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

ما بداخله

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

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

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

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

ما الذي يحمله

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

مجلد أم أرشيف؟

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

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

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

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

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

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

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