Encadernação OnSong^®

O formato de ficheiro OnSong^® Binder é como o OnSong move uma música, um conjunto, ou um livro inteiro entre bibliotecas. Como o OnSong^® Archive, carrega tudo o que é necessário para reconstruir o conteúdo em outro lugar — o texto da música, anexos, estilos, definições, transposição e anotações — mas enquanto um arquivo é um blob opaco único, um binder é uma pasta de ficheiros ordinários. Isto torna-o legível, inspeccionável, e capaz de transportar a mídia de que uma música depende juntamente com a própria música de forma agnóstica em relação à plataforma.

O formato de ficheiro OnSong^® Binder tem uma extensão de ficheiro de .onsongbinder ou .binder, e um tipo MIME de application/onsong-binder.

O Que Está Dentro

Um binder é um arquivo ZIP. Descompacte um e encontrará uma pasta com o nome do identificador do item, contendo:

• manifest.json — o próprio item, serializado. Cada propriedade que o OnSong conhece sobre ele, na mesma forma que a API web do OnSong utiliza.
• O seu ficheiro, se tiver um. Um anexo mantém o seu nome de ficheiro original, portanto um PDF ou um MP3 dentro de um binder é apenas esse PDF ou MP3.
• Pastas para os seus filhos, nomeadas de acordo com o que são — songs, attachments — cada uma contendo mais pastas exatamente com a mesma forma.

Essa estrutura repete-se até ao fim: um conjunto contém músicas, uma música contém anexos, e cada um é uma pasta com o seu próprio manifesto ao lado dos seus próprios ficheiros. Um binder contendo um livro de duzentas músicas tem o mesmo formato que um que contém um único arranjo.

Dentro de um manifesto, referências a filhos são marcadas com um prefixo $binder., portanto um leitor pode dizer a diferença entre um valor que pertence ao item e um que aponta para uma pasta ao lado dele.

O Que Transporta

• Músicas — o arranjo de acordes e tudo o que está anexado a ele.
• Conjuntos — as músicas na sua ordem, com o próprio arranjo do conjunto.
• Livros — uma coleção inteira.
• Anexos — PDFs, imagens, áudio, e qualquer outro ficheiro associado a uma música. Pode escolher incluir apenas os anexos que estão realmente em uso em vez de cada versão já adicionada.

Binder Ou Archive?

Ambos fazem um percurso ida-e-volta do conteúdo de uma biblioteca fielmente, portanto a escolha é sobre o que precisa do ficheiro:

• OnSong^® Archive é o formato mais antigo, e é o que usar para compatibilidade com versões anteriores do OnSong.
• OnSong^® Binder é o atual. Use-o para partilhar com versões mais novas do OnSong — e quando quer um ficheiro que possa abrir e ver por dentro.

Importar E Exportar

Os binders importam da forma como qualquer outro ficheiro o faz: abra um a partir de Ficheiros, Mail, AirDrop, ou um serviço em nuvem e escolha OnSong. Importar um binder que contém um conjunto recria o conjunto e cada música nele; importar um que contém uma única música adiciona essa música.

Para criar um, use Partilhar e escolha OnSong Binder como o formato.

Os binders são também o que OnSong Connect envia entre dispositivos quando um dispositivo pede a outro uma música ou um conjunto, portanto o mesmo formato que vive na sua aplicação Ficheiros é o que viaja pela rede.

Porque um binder é um ZIP de JSON simples e ficheiros de mídia ordinários, é o formato certo para alcançar quando precisa de ver o que o OnSong realmente armazenou — ou quando algo precisa de ler o seu conteúdo e não é OnSong.