ملف OnSong^®

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

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

ما بداخله

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

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

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

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

ما الذي يحمله

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

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

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

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

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

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

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

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

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