Pasta OnSong^®

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

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

O Que Há Dentro

Um binder é um arquivo ZIP. Descompacte um e você encontrará uma pasta nomeada de acordo com o identificador do item, contendo:

• manifest.json — o item em si, serializado. Cada propriedade que o OnSong conhece sobre ele, na mesma forma que a API web do OnSong usa.
• Seu arquivo, se houver um. Um anexo mantém seu nome de arquivo original, portanto um PDF ou MP3 dentro de um binder é apenas esse PDF ou MP3.
• Pastas para seus filhos, nomeadas de acordo com o que são — songs, attachments — cada uma contendo mais pastas da mesma forma exata.

Essa estrutura se repete até o final: um set contém músicas, uma música contém anexos, e cada um é uma pasta com seu próprio manifest ao lado de seus próprios arquivos. Um binder que contém um livro de duzentas músicas está no mesmo formato que um contendo um único chart.

Dentro de um manifest, referências aos filhos são marcadas com um prefixo $binder., portanto um leitor pode diferenciar um valor que pertence ao item de um que aponta para uma pasta ao lado dele.

O Que Ele Carrega

• Músicas — o chord chart e tudo que está anexado a ele.
• Sets — as músicas em sua ordem, com o arranjo do próprio set.
• Livros — uma coleção inteira.
• Anexos — PDFs, imagens, áudio e qualquer outro arquivo associado a uma música. Você 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 uma viagem de ida e volta do conteúdo de uma biblioteca fielmente, portanto a escolha é sobre o que você precisa do arquivo:

• 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 compartilhar com versões mais novas do OnSong — e quando você quer um arquivo que possa abrir e examinar.

Importando E Exportando

Os binders importam como qualquer outro arquivo faz: abra um do Files, Mail, AirDrop ou um serviço em nuvem e escolha OnSong. Importar um binder que contém um set recria o set e cada música nele; importar um que contém uma única música adiciona essa música.

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

Os binders também são o que OnSong Connect envia entre dispositivos quando um dispositivo pede ao outro uma música ou um set, portanto o mesmo formato que existe no seu aplicativo Files é aquele que viaja pela rede.

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