คู่มือผู้ใช้
OnSong® ไฟล์เพลง
รูปแบบไฟล์ OnSong® Binder คือวิธีที่ OnSong ย้ายเพลง ชุดเพลง หรือหนังสือทั้งเล่มระหว่างไลบรารี เช่นเดียวกับ OnSong® Archive มันมีทุกอย่างที่จำเป็นในการสร้างเนื้อหาใหม่ที่อื่น — ข้อความเพลง ไฟล์แนบ สไตล์ การตั้งค่า การเปลี่ยนระดับเสียง และคำอธิบาย — แต่ต่างจากที่เก็บถาวรซึ่งเป็น blob ที่ปิดสนิท binder คือโฟลเดอร์ของไฟล์ธรรมชาติ ทำให้สามารถอ่าน ตรวจสอบ และสามารถเก็บสื่อที่เพลงขึ้นอยู่กับไปพร้อมกับเพลงนั้นเอง ในลักษณะที่ไม่ขึ้นกับแพลตฟอร์ม
รูปแบบไฟล์ OnSong® Binder มีนามสกุลไฟล์เป็น .onsongbinder หรือ .binder และประเภท MIME เป็น application/onsong-binder
สิ่งที่อยู่ข้างใน
binder คือไฟล์ ZIP archive ถ้าคุณแกะมันออกมา คุณจะพบโฟลเดอร์ที่ตั้งชื่อตามตัวระบุของรายการ ซึ่งมีดังนี้:
manifest.json— รายการนั้นเอง ที่ได้รับการ serialize ทุกคุณสมบัติที่ OnSong รู้เกี่ยวกับมัน ในรูปแบบเดียวกับที่ OnSong web API ใช้- ไฟล์ของมัน ถ้ามี ไฟล์แนบจะเก็บชื่อไฟล์ดั้งเดิม ดังนั้น PDF หรือ MP3 ภายใน binder จึงเป็นเพียง PDF หรือ MP3 นั้น
- โฟลเดอร์สำหรับลูก ตั้งชื่อตามสิ่งที่พวกเขาเป็น —
songsattachments— แต่ละรายการจะมีโฟลเดอร์เพิ่มเติมในรูปแบบเดียวกันทุกประการ
โครงสร้างนั้นทำซ้ำไปตลอด: ชุดเพลงมีเพลง เพลงมีไฟล์แนบ และแต่ละชุดคือโฟลเดอร์ที่มี manifest ของตัวเองอยู่ข้างไฟล์ของตัวเอง binder ที่มีหนังสือที่มีเพลงสองร้อยบทเพลงมีรูปแบบเดียวกับบทเพลงเดียว
ภายใน manifest การอ้างอิงถึงลูกจะถูกทำเครื่องหมายด้วยคำนำหน้า $binder. ดังนั้นผู้อ่านจึงสามารถบอกความแตกต่างระหว่างค่าที่เป็นของรายการและค่าที่ชี้ไปยังโฟลเดอร์ข้างๆ ได้
สิ่งที่มันบรรทุก
- เพลง — แผนภูมิคอร์ดและทุกอย่างที่แนบมากับมัน
- ชุดเพลง — เพลงต่างๆ ตามลำดับ พร้อมกับการจัดเรียงของชุด
- หนังสือ — คอลเลคชันทั้งหมด
- ไฟล์แนบ — PDF รูปภาพ เสียง และไฟล์อื่นๆ ที่เกี่ยวข้องกับเพลง คุณสามารถเลือกใช้เฉพาะไฟล์แนบที่ใช้งานอยู่จริง แทนที่จะเป็นทุกเวอร์ชันที่เคยเพิ่มมาก่อน
Binder หรือ Archive?
ทั้งสองอย่างนี้ทำการแลกเปลี่ยนเนื้อหาของไลบรารีอย่างถูกต้อง ดังนั้นการเลือกจึงขึ้นอยู่กับสิ่งที่คุณต้องการจากไฟล์:
- OnSong® Archive คือรูปแบบเก่า และควรใช้เพื่อความเข้ากันได้กับเวอร์ชันก่อนหน้าของ OnSong
- OnSong® Binder คือรูปแบบปัจจุบัน ใช้เพื่อแชร์กับเวอร์ชันใหม่กว่าของ OnSong — และเมื่อคุณต้องการไฟล์ที่คุณสามารถเปิดและดูข้างในได้
การนำเข้าและการส่งออก
Binders จะนำเข้าเหมือนไฟล์อื่นๆ: เปิดจาก Files Mail AirDrop หรือบริการคลาวด์ และเลือก OnSong นำเข้า binder ที่มีชุดเพลงจะสร้างชุดเพลงและทุกเพลงในนั้นขึ้นมาใหม่ การนำเข้า binder ที่มีเพลงเดียวจะเพิ่มเพลงนั้น
หากต้องการสร้างไฟล์ ให้ใช้ แชร์ และเลือก OnSong Binder เป็นรูปแบบ
Binders ยังเป็นสิ่งที่ OnSong Connect ส่งระหว่างอุปกรณ์เมื่ออุปกรณ์หนึ่งขอให้อีกอุปกรณ์หนึ่งใช้เพลงหรือชุดเพลง ดังนั้นรูปแบบเดียวกันที่อยู่ในแอป Files ของคุณจึงเป็นรูปแบบที่เดินทางผ่านเครือข่าย
เนื่องจาก binder คือ ZIP ของ JSON ธรรมดาและไฟล์สื่ออื่นๆ จึงเป็นรูปแบบที่เหมาะสมในการเลือกเมื่อคุณต้องการดูว่า OnSong จัดเก็บไว้อะไรจริงๆ — หรือเมื่อมีอย่างอื่นที่ต้องการอ่านเนื้อหาของคุณและไม่ใช่ OnSong