Metadata âm thanh & sóng âm

// Vẽ sóng âm bằng canvas từ /tracks/:id/waveform — không cần tải file nhạc.
async function drawWaveform(canvas, trackId, points = 120) {
  const { peaks, analysis, duration } = await fetch(
    `/api/xunibox/tracks/${trackId}/waveform?points=${points}`,
  ).then((r) => r.json());

  const ctx = canvas.getContext("2d");
  const width = canvas.width;
  const height = canvas.height;
  const barWidth = width / peaks.length;

  ctx.clearRect(0, 0, width, height);
  peaks.forEach((peak, index) => {           // peak nằm trong thang 0-100
    const barHeight = Math.max(2, (peak / 100) * height);
    const gradient = ctx.createLinearGradient(0, 0, 0, height);
    gradient.addColorStop(0, "#ff4d2d");
    gradient.addColorStop(1, "#ff9425");
    ctx.fillStyle = gradient;
    ctx.fillRect(index * barWidth, (height - barHeight) / 2, barWidth * 0.7, barHeight);
  });

  console.log(duration, analysis.bpm, analysis.musical_key); // "3:24", 128, "A minor"
}

// Ghép nhạc theo nhịp: chọn bài có BPM khớp độ dài cảnh quay.
// Ví dụ video 15 giây, muốn cắt cảnh 4 lần đều nhau => 1 cảnh / 3.75s
// => BPM lý tưởng = 60 / 3.75 * 4 ≈ 64, hoặc bội số 128.

function pickByTempo(tracks, targetBpm, tolerance = 6) {
  return tracks
    .filter((track) => track.bpm != null)
    .map((track) => {
      // Chấp nhận cả bội số / ước số: 64 và 128 cảm giác cùng nhịp.
      const candidates = [track.bpm, track.bpm / 2, track.bpm * 2];
      const distance = Math.min(...candidates.map((bpm) => Math.abs(bpm - targetBpm)));
      return { track, distance };
    })
    .filter((item) => item.distance <= tolerance)
    .sort((a, b) => a.distance - b.distance)
    .map((item) => item.track);
}

// Ghép theo cảm xúc: energy 0-1, càng cao càng sôi động.
const chill  = tracks.filter((t) => (t.energy ?? 0) < 0.35);
const hype   = tracks.filter((t) => (t.energy ?? 0) > 0.7);

// Chuẩn hoá âm lượng khi trộn nhạc nền với tiếng gốc của video:
// gain_dB = mục_tiêu - loudness_db, ví dụ mục tiêu -14 LUFS.
const gainDb = -14 - (track.loudness_db ?? -14);