Panduan Pengguna
Pengikat OnSong®
Format file OnSong® Binder adalah cara OnSong memindahkan sebuah 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 tidak tembus, pengikat adalah folder berisi file biasa. Hal ini membuatnya dapat dibaca, dapat diperiksa, dan mampu membawa media yang digunakan lagu bersama lagu itu sendiri dengan cara yang netral terhadap platform.
Format file OnSong® Binder memiliki ekstensi file .onsongbinder atau .binder, dan jenis MIME application/onsong-binder.
Apa yang Di Dalamnya
Pengikat adalah arsip ZIP. Buka kemasan dan Anda akan menemukan folder yang dinamai sesuai pengidentifikasi item, berisi:
manifest.json— item itu sendiri, terserialisasi. Setiap properti yang diketahui OnSong tentangnya, dalam bentuk yang sama yang digunakan OnSong web API.- File-nya, jika memiliki satu. Lampiran menyimpan nama file aslinya, jadi PDF atau MP3 di dalam pengikat hanyalah PDF atau MP3 itu saja.
- Folder untuk anak-anaknya, dinamai sesuai apa mereka —
songs,attachments— masing-masing menampung lebih banyak folder dengan bentuk yang persis sama.
Struktur itu terulang sepanjang jalan: satu set berisi lagu, lagu berisi lampiran, dan masing-masing adalah folder dengan manifesnya sendiri di samping file-filenya sendiri. Pengikat yang menampung buku dua ratus lagu adalah format yang sama dengan satu yang menampung satu diagram saja.
Di dalam manifes, referensi ke anak-anak ditandai dengan awalan $binder., jadi pembaca dapat membedakan nilai yang dimiliki item dan nilai yang menunjuk ke folder di sebelahnya.
Apa yang Dibawanya
- Lagu — diagram akord dan semua yang terpasang padanya.
- Set — lagu-lagu sesuai urutannya, 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 hanya menyertakan lampiran yang benar-benar digunakan daripada setiap versi yang pernah ditambahkan.
Pengikat Atau Arsip?
Keduanya melakukan perjalanan bolak-balik konten perpustakaan dengan setia, jadi pilihannya adalah tentang 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 Anda buka dan lihat ke dalamnya.
Mengimpor dan Mengekspor
Pengikat mengimpor seperti file lainnya: buka satu dari Files, Mail, AirDrop, atau layanan cloud dan pilih OnSong. Mengimpor pengikat yang menampung satu set menciptakan kembali set dan setiap lagu di dalamnya; mengimpor satu yang menampung satu lagu tunggal menambahkan lagu itu.
Untuk membuat satu, gunakan Bagikan dan pilih OnSong Binder sebagai formatnya.
Pengikat juga yang dikirim OnSong Connect antar perangkat ketika satu perangkat meminta yang lain untuk lagu atau set, jadi format yang sama yang ada di aplikasi Files Anda adalah 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.