Panduan Pengguna
Binder OnSong®
Format file OnSong® Binder adalah cara OnSong memindahkan satu lagu, satu set, atau seluruh buku antar perpustakaan. Seperti OnSong® Archive, format ini membawa semua yang diperlukan untuk membangun kembali konten di tempat lain — teks lagu, lampiran, gaya, pengaturan, transposisi, dan anotasi — tetapi di mana arsip adalah satu blob yang buram, binder adalah folder berisi file-file biasa. Hal ini membuatnya dapat dibaca, dapat diperiksa, dan dapat membawa media yang bergantung pada lagu bersama lagu itu sendiri dengan cara yang agnostik terhadap platform.
Format file OnSong® Binder memiliki ekstensi file .onsongbinder atau .binder, dan tipe MIME application/onsong-binder.
Apa yang Ada Di Dalamnya
Binder adalah arsip ZIP. Ekstrak satu dan Anda akan menemukan folder yang dinamai sesuai identifikator item, berisi:
manifest.json— item itu sendiri, terserialisasi. Setiap properti yang diketahui OnSong, dalam bentuk yang sama yang digunakan API web OnSong.- File-nya, jika ada. Lampiran mempertahankan nama file aslinya, jadi PDF atau MP3 di dalam binder hanyalah PDF atau MP3 itu.
- Folder untuk anak-anaknya, dinamai sesuai dengan apa mereka —
songs,attachments— masing-masing berisi folder dengan bentuk yang sama persis.
Struktur itu berulang sampai ke bawah: set berisi lagu, lagu berisi lampiran, dan masing-masing adalah folder dengan manifestnya sendiri di samping file-filenya sendiri. Binder yang menyimpan buku dua ratus lagu memiliki format yang sama dengan yang menyimpan satu chart.
Di dalam manifest, referensi ke anak-anak ditandai dengan awalan $binder., jadi pembaca dapat membedakan antara nilai yang milik item dan nilai yang menunjuk ke folder di sebelahnya.
Apa yang Dibawanya
- Lagu-lagu — chord chart dan semua yang terlampir padanya.
- Set-set — lagu-lagu dalam urutan mereka, dengan pengaturan set itu sendiri.
- Buku-buku — seluruh koleksi.
- Lampiran-lampiran — PDF, gambar, audio, dan file lain apa pun yang terkait dengan lagu. Anda dapat memilih untuk hanya menyertakan lampiran yang benar-benar digunakan daripada setiap versi yang pernah ditambahkan.
Binder atau Arsip?
Keduanya melakukan perjalanan pulang pergi konten perpustakaan dengan setia, jadi pilihan tergantung pada apa yang Anda butuhkan dari file:
- OnSong® Archive adalah format yang lebih lama, dan itulah yang harus digunakan untuk kompatibilitas dengan versi OnSong sebelumnya.
- OnSong® Binder adalah yang terbaru. Gunakan untuk berbagi dengan versi OnSong yang lebih baru — dan ketika Anda menginginkan file yang dapat dibuka dan diperiksa.
Mengimpor dan Mengekspor
Binder diimpor dengan cara yang sama seperti file lainnya: buka dari Files, Mail, AirDrop, atau layanan cloud dan pilih OnSong. Mengimpor binder yang menyimpan set akan membuat ulang set dan setiap lagu di dalamnya; mengimpor yang menyimpan satu lagu menambahkan lagu itu.
Untuk membuat satu, gunakan Bagikan dan pilih OnSong Binder sebagai format.
Binder juga adalah apa yang OnSong Connect kirimkan antar perangkat ketika satu perangkat meminta perangkat lain untuk lagu atau set, jadi format yang sama yang berada di aplikasi Files Anda adalah yang bepergian di jaringan.
Karena binder adalah ZIP dari JSON biasa dan file media biasa, ini adalah format yang tepat untuk digunakan ketika Anda perlu melihat apa yang sebenarnya disimpan OnSong — atau ketika sesuatu perlu membaca konten Anda dan bukan OnSong.