OnSong^® バインダー

OnSong^® バインダーファイル形式は、OnSongが曲、セット、または書籍全体をライブラリ間で移動する方法です。OnSong^® アーカイブと同様に、別の場所でコンテンツを再構築するために必要なすべてのものを含みます。曲のテキスト、添付ファイル、スタイル、設定、移調、注釈です。ただし、アーカイブが単一の不透明なブロブであるのに対し、バインダーは通常のファイルのフォルダです。これにより、読み取り可能で検査可能であり、曲が依存するメディアをプラットフォーム非依存の方法で曲自体と一緒に含めることができます。

OnSong^® バインダーファイル形式のファイル拡張子は.onsongbinderまたは.binderで、MIMEタイプはapplication/onsong-binderです。

内部構成

バインダーはZIPアーカイブです。展開すると、アイテムの識別子にちなんで名付けられたフォルダが見つかり、その中に以下が含まれます:

• manifest.json — アイテム自体、シリアル化されたもの。OnSongが認識しているすべてのプロパティが、OnSong web APIが使用するのと同じ形式です。
• そのファイル(存在する場合)。 添付ファイルは元のファイル名を保持するため、バインダー内のPDFまたはMP3はそのままPDFまたはMP3です。
• その子フォルダ — songs、attachmentsなど、それぞれが同じ形状のより多くのフォルダを保持しています。

この構造は全体にわたって繰り返されます。セットは曲を含み、曲は添付ファイルを含みます。各フォルダには、その横にあるマニフェストと独自のファイルがあります。200曲の書籍を保持するバインダーは、単一のチャートを保持するバインダーと同じ形式です。

マニフェスト内で、子への参照は$binder.接頭辞でマークされているため、読み取り手はアイテムに属する値と、その横のフォルダを指す値の違いを区別できます。

含まれるもの

• 曲 — コードチャートおよび添付されたすべてのもの。
• セット — セットの順序での曲。セット自身の編成。
• 書籍 — コレクション全体。
• 添付ファイル — PDF、画像、音声、および曲に関連するその他のファイル。実際に使用されている添付ファイルのみを含めるか、追加されたすべてのバージョンを含めるかを選択できます。

バインダーまたはアーカイブ?

どちらもライブラリのコンテンツを忠実にラウンドトリップするため、選択はファイルに必要な内容についてです:

• OnSong^® アーカイブ はより古い形式で、OnSongの以前のバージョンとの互換性のために使用するものです。
• OnSong^® バインダー は現在のものです。新しいバージョンのOnSongとの共有に使用してください。また、開いて内部を見ることができるファイルが必要な場合に使用してください。

インポートとエクスポート

バインダーは他のファイルと同じようにインポートされます。ファイル、メール、AirDrop、またはクラウドサービスから開いて、OnSongを選択します。セットを保持するバインダーをインポートすると、セットとその中のすべての曲が再作成されます。単一の曲を保持するバインダーをインポートすると、その曲が追加されます。

バインダーを作成するには、共有を使用して、形式としてOnSong バインダーを選択します。

バインダーは、あるデバイスが別のデバイスに曲またはセットを要求するときにOnSong Connectがデバイス間で送信するものでもあるため、ファイルアプリに存在する同じ形式がネットワークを介して移動するものです。

バインダーはプレーンなJSONと通常のメディアファイルのZIPであるため、OnSongが実際に保存したものを見る必要がある場合、または何かがあなたのコンテンツを読む必要があり、それがOnSongではない場合に選択する正しい形式です。