ملف OnSong^®

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

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

ما بالداخل

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

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

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

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

ما الذي يحمله

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

Binder أم Archive؟

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

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

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

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

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

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

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