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 バインダー を選択します。

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

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