Panduan Pengguna
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 di mana arsip adalah satu blob buram, binder adalah folder dari file biasa. Ini membuatnya dapat dibaca, dapat diperiksa, dan dapat membawa media yang dibutuhkan lagu di samping lagu itu sendiri dengan cara yang tidak tergantung pada platform.
Format file OnSong® Binder memiliki ekstensi file .onsongbinder atau .binder, dan tipe MIME application/onsong-binder.
Yang Ada Di Dalamnya
Binder adalah arsip ZIP. Buka zip dan Anda akan menemukan folder yang dinamai sesuai dengan pengidentifikasi item, berisi:
manifest.json— item itu sendiri, terserialisasi. Setiap properti yang OnSong ketahui tentangnya, dalam bentuk yang sama yang digunakan OnSong web API.- Filenya, jika ada. Lampiran mempertahankan nama file aslinya, jadi PDF atau MP3 di dalam binder hanyalah PDF atau MP3 itu.
- Folder untuk anaknya, dinamai sesuai dengan apa mereka —
songs,attachments— masing-masing memuat folder dengan bentuk yang sama persis.
Struktur itu berulang sampai ke bawah: satu set berisi lagu, lagu berisi lampiran, dan masing-masing adalah folder dengan manifest-nya sendiri di samping filenya. Binder yang menyimpan buku dua ratus lagu memiliki format yang sama dengan yang menyimpan satu chart tunggal.
Di dalam manifest, referensi ke anak ditandai dengan awalan $binder., jadi pembaca dapat membedakan antara nilai yang milik item dan nilai yang menunjuk ke folder di sebelahnya.
Yang Dibawanya
- Lagu — chord chart dan semua yang terlampir padanya.
- Set — lagu dalam urutan mereka, dengan pengaturan set 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 tentang apa yang Anda butuhkan dari file:
- OnSong® Archive adalah format yang lebih lama, dan 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 di dalamnya.
Impor Dan Ekspor
Binder diimpor seperti file lainnya: buka satu dari Files, Mail, AirDrop, atau layanan cloud dan pilih OnSong. Mengimpor binder yang menyimpan satu set akan membuat ulang set dan setiap lagu di dalamnya; mengimpor satu yang menyimpan lagu tunggal menambahkan lagu itu.
Untuk membuat satu, gunakan Bagikan dan pilih OnSong Binder sebagai formatnya.
Binder juga apa yang OnSong Connect kirim antar perangkat ketika satu perangkat meminta lagu atau set dari perangkat lain, jadi format yang sama yang berada di aplikasi Files Anda adalah yang bepergian melalui 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 benar-benar disimpan OnSong — atau ketika sesuatu perlu membaca konten Anda dan bukan OnSong.