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.