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 jika arsip adalah satu blob yang tidak transparan, binder adalah folder berisi file biasa. Ini membuatnya dapat dibaca, dapat diinspeksi, dan mampu membawa media yang dibutuhkan lagu bersama lagu itu sendiri dengan cara yang tidak bergantung pada platform.

Format file OnSong^® Binder memiliki ekstensi file .onsongbinder atau .binder, dan tipe MIME application/onsong-binder.

Apa Isinya

Binder adalah arsip ZIP. Jika Anda membuka salah satu, Anda akan menemukan folder bernama sesuai dengan pengidental item, berisi:

• manifest.json — item itu sendiri, terserialisasi. Setiap properti yang diketahui OnSong tentangnya, dalam bentuk yang sama dengan yang digunakan OnSong web API.
• 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, diberi nama sesuai dengan apa yang mereka adalah — songs, attachments — masing-masing menyimpan lebih banyak folder dengan bentuk yang sama persis.

Struktur itu berulang sampai ke bawah: satu set berisi lagu-lagu, satu lagu berisi lampiran, dan masing-masing adalah folder dengan manifest-nya sendiri di samping file-filenya sendiri. Binder yang menyimpan buku berisi dua ratus lagu memiliki format yang sama dengan binder yang menyimpan satu chart.

Di dalam manifest, referensi ke anak-anak ditandai dengan awalan $binder., sehingga pembaca dapat membedakan antara nilai yang milik item dan nilai yang menunjuk ke folder di sebelahnya.

Apa yang Dibawanya

• Lagu — chord chart dan semua yang terpasang padanya.
• Set — lagu-lagu dalam urutan mereka, dengan pengaturan set itu sendiri.
• Buku — seluruh koleksi.
• Lampiran — PDF, gambar, audio, dan file lainnya yang terkait dengan lagu. Anda dapat memilih untuk menyertakan hanya lampiran yang benar-benar digunakan daripada setiap versi yang pernah ditambahkan.

Binder Atau Arsip?

Keduanya melakukan round-trip konten perpustakaan dengan setia, jadi pilihan bergantung pada apa yang Anda butuhkan dari file:

• OnSong^® Archive adalah format yang lebih lama, dan harus digunakan untuk kompatibilitas dengan versi OnSong sebelumnya.
• OnSong^® Binder adalah yang sekarang. Gunakan untuk berbagi dengan versi OnSong yang lebih baru — dan ketika Anda menginginkan file yang dapat Anda buka dan lihat isinya.

Mengimpor dan Mengekspor

Binder diimpor seperti file lainnya: buka salah satu dari Files, Mail, AirDrop, atau layanan cloud dan pilih OnSong. Mengimpor binder yang menyimpan set akan membuat kembali set dan setiap lagu di dalamnya; mengimpor binder yang menyimpan satu lagu menambahkan lagu itu.

Untuk membuat satu, gunakan Bagikan dan pilih OnSong Binder sebagai format.

Binder juga apa yang OnSong Connect kirimkan antar perangkat ketika satu perangkat meminta perangkat lain untuk lagu atau set, sehingga format yang sama yang berada di aplikasi Files Anda adalah yang bepergian melalui jaringan.

Karena binder adalah ZIP berisi 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.