Binder OnSong^®

Format file OnSong^® Binder adalah cara OnSong memindahkan sebuah lagu, satu set, atau seluruh buku di antara 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, pengikat adalah folder berisi file biasa. Hal ini membuatnya dapat dibaca, dapat diperiksa, dan dapat membawa media yang bergantung pada lagu bersama dengan lagu itu sendiri dengan cara yang independen dari platform.

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

Isi Dalamnya

Pengikat adalah arsip ZIP. Buka satu dan Anda akan menemukan folder yang dinamai berdasarkan pengenal item, berisi:

• manifest.json — item itu sendiri, diserialisasi. 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 pengikat hanyalah PDF atau MP3 tersebut.
• Folder untuk anak-anaknya, dinamai sesuai dengan apa adanya — songs, attachments — masing-masing menampung lebih banyak folder dengan bentuk yang persis sama.

Struktur tersebut berulang sampai ke bawah: satu set berisi lagu, satu lagu berisi lampiran, dan masing-masing adalah folder dengan manifest-nya sendiri di samping file-nya sendiri. Pengikat yang menampung buku dengan dua ratus lagu memiliki format yang sama dengan pengikat yang menampung satu chart.

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

Apa yang Dibawanya

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

Pengikat Atau Arsip?

Keduanya melakukan perjalanan bolak-balik konten perpustakaan dengan setia, jadi pilihan bergantung pada apa yang Anda butuhkan dari file:

• OnSong^® Archive adalah format yang lebih lama, dan adalah format 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 Anda buka dan lihat ke dalamnya.

Mengimpor Dan Mengekspor

Pengikat diimpor seperti file lainnya: buka satu dari File, Mail, AirDrop, atau layanan cloud dan pilih OnSong. Mengimpor pengikat yang menampung satu set membuat kembali set dan setiap lagu di dalamnya; mengimpor yang menampung satu lagu menambahkan lagu tersebut.

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

Pengikat juga merupakan apa yang OnSong Connect kirimkan antar perangkat ketika satu perangkat meminta perangkat lain untuk lagu atau set, jadi format yang sama yang terdapat di aplikasi File Anda adalah format yang bepergian melalui jaringan.

Karena pengikat adalah ZIP dari JSON biasa dan file media biasa, ini adalah format yang tepat untuk digunakan ketika Anda perlu melihat apa yang benar-benar disimpan OnSong — atau ketika sesuatu perlu membaca konten Anda dan bukan OnSong.