Manual del Usuario
Carpeta OnSong®
El formato de archivo OnSong® Binder es cómo OnSong mueve una canción, un set o un libro completo entre bibliotecas. Como el Archivo OnSong®, contiene todo lo necesario para reconstruir el contenido en otro lugar — el texto de la canción, adjuntos, estilos, configuración, transposición y anotaciones — pero donde un archivo es un blob opaco único, un binder es una carpeta de archivos ordinarios. Esto lo hace legible, inspectable y capaz de llevar los medios de los que una canción depende junto con la canción misma de manera independiente de la plataforma.
El formato de archivo OnSong® Binder tiene una extensión de archivo de .onsongbinder o .binder, y un tipo MIME de application/onsong-binder.
Qué Hay Adentro
Un binder es un archivo ZIP. Descomprime uno y encontrarás una carpeta nombrada según el identificador del elemento, que contiene:
manifest.json— el elemento mismo, serializado. Cada propiedad que OnSong conoce sobre él, con la misma forma que usa la API web de OnSong.- Su archivo, si tiene uno. Un adjunto mantiene su nombre de archivo original, por lo que un PDF o un MP3 dentro de un binder es simplemente ese PDF o MP3.
- Carpetas para sus elementos secundarios, nombradas según lo que sean —
songs,attachments— cada una conteniendo más carpetas de exactamente la misma forma.
Esa estructura se repite hasta el final: un set contiene canciones, una canción contiene adjuntos, y cada uno es una carpeta con su propio manifest junto a sus propios archivos. Un binder que contiene un libro de doscientas canciones tiene el mismo formato que uno que contiene un solo tema.
Dentro de un manifest, las referencias a elementos secundarios se marcan con un prefijo $binder., por lo que un lector puede distinguir la diferencia entre un valor que pertenece al elemento y uno que apunta a una carpeta junto a él.
Qué Lleva
- Canciones — la tabla de acordes y todo lo adjunto a ella.
- Sets — las canciones en su orden, con el arreglo propio del set.
- Libros — una colección completa.
- Adjuntos — PDFs, imágenes, audio y cualquier otro archivo asociado con una canción. Puedes elegir incluir solo los adjuntos que se usan realmente en lugar de cada versión jamás agregada.
¿Binder O Archivo?
Ambos transportan el contenido de una biblioteca fielmente, por lo que la elección se trata de lo que necesitas del archivo:
- Archivo OnSong® es el formato más antiguo, y es lo que debes usar para compatibilidad con versiones anteriores de OnSong.
- OnSong® Binder es el actual. Úsalo para compartir con versiones más nuevas de OnSong — y cuando quieras un archivo que puedas abrir e inspeccionar.
Importar Y Exportar
Los binders se importan como cualquier otro archivo: abre uno desde Archivos, Correo, AirDrop o un servicio en la nube y elige OnSong. Importar un binder que contiene un set recrea el set y cada canción en él; importar uno que contiene una sola canción añade esa canción.
Para crear uno, usa Compartir y elige OnSong Binder como formato.
Los binders también son lo que OnSong Connect envía entre dispositivos cuando un dispositivo le pide a otro una canción o un set, por lo que el mismo formato que vive en tu aplicación Archivos es el que viaja por la red.
Porque un binder es un ZIP de JSON plano y archivos de medios ordinarios, es el formato correcto al que recurrir cuando necesitas ver qué OnSong realmente almacenó — o cuando algo necesita leer tu contenido y no es OnSong.