ملف 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 — كل منها يحتوي على مجلدات إضافية بنفس الشكل تمامًا.

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

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

ما الذي يحمله

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

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

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

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

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

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

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

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

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