ملف OnSong^®

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

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

ما بالداخل

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

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

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

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

ما تحمله

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

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

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

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

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

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

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

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

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