Fichário OnSong^®

O formato de arquivo OnSong^® Binder é como o OnSong move uma música, um conjunto ou um livro inteiro entre bibliotecas. Como o OnSong^® Archive, ele carrega tudo o 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 comuns. Isso o torna legível, inspecionável e capaz de carregar a mídia de que uma música depende ao lado da própria música de forma agnóstica em relação à plataforma.

O formato de arquivo OnSong^® Binder tem uma extensão de arquivo de .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. Toda propriedade que o OnSong conhece sobre ele, na mesma forma que a API web do OnSong usa.
• Seu arquivo, se tiver um. Um anexo mantém seu nome de arquivo original, então um PDF ou um 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 com exatamente a mesma forma.

Essa estrutura se repete o tempo todo: um conjunto contém músicas, uma música contém anexos, e cada um é uma pasta com seu próprio manifesto ao lado de seus próprios arquivos. Um binder contendo um livro de duzentas músicas tem o mesmo formato que um contendo um único gráfico.

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

O Que Ele Carrega

• Músicas — o gráfico de acordes e tudo anexado a ele.
• Conjuntos — as músicas em sua ordem, com o próprio arranjo do conjunto.
• Livros — uma coleção inteira.
• Anexos — PDFs, imagens, áudio e qualquer outro arquivo associado a uma música. Você pode optar por incluir apenas os anexos que estão realmente em uso em vez de todas as versões já adicionadas.

Binder Ou Archive?

Ambos fazem um ciclo completo 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 recentes do OnSong — e quando você quiser um arquivo que possa abrir e examinar.

Importando E Exportando

Os binders são importados da mesma forma que qualquer outro arquivo: abra um de Arquivos, Mail, AirDrop ou um serviço em nuvem e escolha OnSong. Importar um binder que contém um conjunto recria o conjunto e todas as músicas 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 a outro uma música ou um conjunto, então o mesmo formato que fica em seu aplicativo Arquivos é o que viaja pela rede.

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