OnSong^® バインダー

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

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

内容

binder は ZIP アーカイブです。1 つを解凍すると、項目の識別子の後に名付けられたフォルダが見つかり、以下が含まれます。

• manifest.json — 項目自体、シリアル化されたもの。OnSong が認識するすべてのプロパティ、OnSong web API が使用するのと同じ形状です。
• ファイル（ある場合）。添付ファイルは元のファイル名を保持するため、binder 内の PDF または MP3 はまさにその PDF または MP3 です。
• 子要素用フォルダ、それらの名前付け — songs、attachments — それぞれが正確に同じ形状のさらに多くのフォルダを保持します。

その構造は下へと繰り返されます。セットは曲を含み、曲は添付ファイルを含み、それぞれは独自のマニフェストを持つフォルダです。200 曲の書籍を保持する binder は、単一のチャートを保持する binder と同じ形式です。

マニフェスト内で、子要素への参照は $binder. プレフィックスでマークされているため、読み取り機は項目に属する値と隣のフォルダを指す値の違いを区別できます。

保持内容

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

Binder か Archive か？

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

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

インポートおよびエクスポート

Binder は他のファイルと同じ方法でインポートします。Files、Mail、AirDrop、またはクラウドサービスから 1 つを開いて OnSong を選択します。セットを保持する binder をインポートすると、セット内のすべての曲を再作成します。単一の曲を保持する binder をインポートすると、その曲が追加されます。

作成するには、共有を使用して、形式として OnSong Binder を選択します。

Binder は、OnSong Connect が 1 つのデバイスが別のデバイスに曲またはセットを要求する場合にデバイス間で送信するものでもあります。そのため、Files アプリに存在する同じ形式がネットワークを介して移動しています。

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