OnSong^® バインダー

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

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

内部構成

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

• manifest.json — アイテム自体がシリアル化されたもの。OnSong が認識するすべてのプロパティ。OnSong ウェブ API が使用するのと同じ形式です。
• そのファイル（存在する場合）。添付ファイルは元のファイル名を保持するため、バインダー内の PDF または MP3 はそのままの PDF または MP3 です。
• その子要素用のフォルダ。それらが何であるかに従って名前が付けられます——songs、attachments——各フォルダはまったく同じ形式のフォルダをさらに含みます。

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

マニフェスト内では、子要素への参照に $binder. プレフィックスが付けられているため、リーダーはアイテムに属する値と隣のフォルダを指す値の違いを区別できます。

含まれるもの

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

バインダーそれともアーカイブ?

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

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

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

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

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

バインダーは OnSong Connect がデバイス間で送信するもので、あるデバイスが別のデバイスにソングまたはセットを要求するときに使用されます。そのため、ファイルアプリに存在する形式と、ネットワークを通過する形式は同じです。

バインダーは平文の JSON と通常のメディアファイルの ZIP であるため、OnSong が実際に保存した内容を確認する必要があるとき、または OnSong 以外の何かがコンテンツを読み取る必要があるときに選択するのに適した形式です。