🎵 Kelola animasi & suara

🗂️ Di mana semuanya disimpan?

🎞️ Tambah animasi GIF

Animasi ditanam di firmware sebagai frame JPEG penuh warna. Alurnya: GIF → impor → daftarkan → build & flash → salin suara.

cd firmware
python tools/import_jpeg_clip.py wajah senyum assets/builtin/gif/wajah/senyum.gif --quality 80

"jpeg_clips": [
  …,
  ["gundam", "pilot", "", 31],
  ["wajah", "senyum", ""]          <- baris baru di akhir
]

⚠️ Jangan menambah baris di daftar "builtins". Nomor trek builtin = posisinya, jadi baris ke-19 akan memakai trek 19 yang sudah dipakai wajah/senyum_kedip, dan builtin GIF hanya diambil 6 frame.

ℹ️ Klip satu tema selalu dikelompokkan: klip baru tema lama masuk setelah kelompok temanya. "boot_theme" di meta.json menentukan model saat nyala (sekarang wajah, klip senyum_kedip). "theme_order" mengatur urutan tema (sekarang wajah, mobil, gundam; tema yang tidak disebut di akhir). Pakai hanya media yang boleh kamu sebarkan.

🔊 Suara animasi dan Chronos (root kartu, urutan salin)

Isi kartu siap pakai: folder sd/mp3/ di repo (48 file, 1,4 MB). DFPlayer memutar file root menurut urutan salin (file ke-N yang disalin), bukan nama.

# Linux (kartu di /media/SD)
for f in sd/mp3/*.mp3; do cp "$f" /media/SD/; sync; done

# Windows PowerShell (kartu di E:)
Get-ChildItem sd\mp3\*.mp3 | Sort-Object Name | ForEach-Object { Copy-Item $_.FullName E:\ }

• Suara model diputar sampai habis, lalu diulang selama animasi itu tampil (jeda hening di akhir file mengatur jarak ulang).
• Klip tahan dan goyang memutar suaranya sendiri, lalu suara model utama mulai lagi.
• Saat pemutar musik aktif (main atau jeda) atau layar Chronos tampil, animasi tanpa suara.
• Klip baru otomatis mendapat trek 0049 dan seterusnya (0041–0048 milik Chronos). Salin file itu setelah 0048, sebelum /01.

• Nomor yang tidak dipakai berisi MP3 hening. Jangan dihapus: tanpa pengisi urutan bergeser dan suara tertukar.
• Ganti suara: timpa file bernama sama di sd/mp3/, lalu format dan salin ulang berurutan.
• Lagu di /01 harus bernomor berurutan tanpa lubang (001, 002, 003 …).
• Di macOS, hapus ._* dan .DS_Store (dot_clean); ikut terhitung sebagai file.
• Cek kartu: python firmware/tools/daftar_trek.py --sd /path/kartu. Buat ulang MP3: python3 sd/buat_suara.py.

Semua suara dibuat dari nol oleh sd/buat_suara.py (numpy, tanpa sampel luar, MIT). Opsi --pack mochi-themes.zip memakai WAV asli paket tema mochi-rzmong assets-v1 untuk 14 animasi (paket tanpa lisensi tertulis: untuk kartu sendiri). Build -DMOCHI_DF_MP3_FOLDER: file yang sama di /MP3/0001.mp3 …, dicocokkan dari nama.

💡 Suara tidak diulang? Kabel TX DFPlayer → GPIO21 membawa pesan "trek selesai". Atau pasang BUSY ke GPIO5 + -DMOCHI_PIN_DF_BUSY=5.

🎵 Pemutar musik (/01)

👆 Gerakan

Mode dan lagu terakhir tersimpan. Layar "folder /01 kosong" berarti tidak ada /01/001.mp3.

📱 Chronos: layar dan suara (0041–0048)

ℹ️ Layar Chronos memotong musik; setelahnya lagu diulang dari awal trek. Notifikasi tidak memotong dering panggilan. Mode Jangan Ganggu di aplikasi membisukan suara notifikasi.

🧰 Cek kartu dan nomor trek

cd firmware
python tools/daftar_trek.py                  # tabel model → trek → nama file
python tools/daftar_trek.py --sd /media/SD   # cek root 0001-0048, /01 dan sampah macOS

Skrip ini hanya membaca. Sumbernya include/jpeg_clips.h hasil build, atau assets/meta.json kalau belum build.

⚠️ Di macOS, hapus file ._* dan .DS_Store dari kartu. DFPlayer bisa menghitungnya sebagai trek.