ملف OnSong^® Binder

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

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

ما بداخله

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

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

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

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

ما الذي يحمله

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

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

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

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

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

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

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

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

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