Pasta OnSong^®

O formato de arquivo OnSong^® Binder é como o OnSong move uma música, um conjunto ou um livro inteiro entre bibliotecas. Como o Arquivo OnSong^®, ele contém 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 único e opaco, um binder é uma pasta de arquivos comuns. Isso o torna legível, inspecionável e capaz de carregar a mídia da qual uma música depende junto com a 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 Está 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 próprio item, serializado. Cada 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, portanto 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 da mesma forma.

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

Dentro de um manifesto, referências a filhos são marcadas com um prefixo $binder., para que um leitor possa diferenciar entre um valor que pertence ao item e 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 arranjo do próprio 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 cada versão já adicionada.

Binder Ou Arquivo?

Ambos fazem viagem de ida e volta do conteúdo de uma biblioteca fielmente, então a escolha é sobre o que você precisa do arquivo:

• Arquivo OnSong^® é 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ê deseja um arquivo que possa abrir e ver dentro.

Importando E Exportando

Os binders importam da mesma forma que qualquer outro arquivo: abra um do Arquivos, Mail, AirDrop ou um serviço de 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 Compartilhar e escolha OnSong Binder como o 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, portanto o mesmo formato que fica em seu aplicativo Arquivos é aquele que viaja pela rede.

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