Ficheiro OnSong^®

O formato de ficheiro OnSong^® Binder é como o OnSong move uma canção, um conjunto, ou um livro inteiro entre bibliotecas. Tal como o OnSong^® Archive, contém tudo o que é necessário para reconstruir o conteúdo noutro local — o texto da canção, anexos, estilos, definições, transposição e anotações — mas enquanto um arquivo é um único blob opaco, um binder é uma pasta de ficheiros ordinários. Isto o torna legível, inspecionável, e capaz de transportar a média de que uma canção depende juntamente com a própria canção de forma independente da 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 item em si, serializado. Todas as propriedades 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 itens subordinados, com o nome do que são — songs, attachments — cada uma contendo mais pastas da exatamente mesma estrutura.

Essa estrutura repete-se até ao fim: um conjunto contém canções, uma canção 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 canções é o mesmo formato de um que contém um único gráfico.

Dentro de um manifesto, as referências a itens subordinados são marcadas com um prefixo $binder., para que um leitor possa distinguir entre um valor que pertence ao item e um que aponta para uma pasta ao lado dele.

O Que Contém

• Canções — o gráfico de acordes e tudo o que está anexado a ele.
• Conjuntos — as canções na sua ordem, com o arranjo do conjunto.
• Livros — uma coleção completa.
• Anexos — PDFs, imagens, áudio e qualquer outro ficheiro associado a uma canção. Pode optar por incluir apenas os anexos que estão efetivamente em uso, em vez de todas as versões já adicionadas.

Binder Ou Archive?

Ambos regressam fielmente ao conteúdo de uma biblioteca, portanto a escolha é sobre o que necessita do ficheiro:

• OnSong^® Archive é o formato mais antigo, e é o que deve usar para compatibilidade com versões anteriores do OnSong.
• OnSong^® Binder é o atual. Use-o para partilhar com versões mais recentes do OnSong — e quando quiser um ficheiro que possa abrir e examinar.

Importação E Exportação

Os binders importam-se da forma como qualquer outro ficheiro o faz: abra um a partir de Ficheiros, Correio, AirDrop ou um serviço na cloud e escolha OnSong. A importação de um binder que contém um conjunto recria o conjunto e todas as canções nele; a importação de um que contém uma única canção adiciona essa canção.

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

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

Como um binder é um ZIP de JSON simples e ficheiros de média ordinários, é o formato correto a escolher quando necessita de ver o que o OnSong realmente armazenou — ou quando algo precisa de ler o seu conteúdo e não é OnSong.