Навык описывает сведение уже размещённого в HyperFrames аудио: настройку громкости и автоматизации, цепочек эффектов, fade и ducking. Помогает освободить место для речи в музыкальной подложке с помощью voiceover carve, не приглушая музыку целиком.

Возможности

• Настраивает data-fx-chain, data-automation и data-fx-carve на аудио- и видеоэлементах.
• Поддерживает gain, EQ, compressor, limiter, gate, saturate, delay, reverb, chorus, phaser и bitcrush.
• Создаёт voiceover carve: анализирует речь и подложку, добавляет фильтры и автоматизацию уровня.
• Объединяет несколько треков в <hf-audio-group> с общей цепочкой эффектов, громкостью и автоматизацией.
• Использует одну Web Audio graph для preview и render, поэтому результат предпросмотра соответствует рендеру.

Когда использовать

• Аудио уже добавлено в композицию, и нужно настроить сведение или эффекты.
• Музыка мешает разборчивости речи — нужно сделать carve под голос.
• Нескольким трекам нужна общая обработка или общий фейдер.
• Нужно автоматизировать громкость или параметр эффекта на протяжении трека.

Для поиска или генерации аудио используйте /media-use, для тайминга клипов и раскладки треков — /hyperframes-core.

Установка

Для запуска CLI установите зависимость в проекте; также нужен ffmpeg в PATH:

npm i -D @hyperframes/core

Примеры

Автоматически определить музыкальную подложку и голос, затем применить динамический carve:

node <SKILL_DIR>/scripts/carve.mjs --comp index.html

Сгруппировать клипы с речью и указать группу как источник для carve:

<audio id="vo-intro" data-audio-group="voiceover" …></audio>
<audio id="vo-middle" data-audio-group="voiceover" …></audio>
<audio id="vo-outro" data-audio-group="voiceover" …></audio>

<audio id="music" data-fx-carve='{"enabled":true,"sources":["voiceover"],"strength":0.8}' …></audio>

Создать bus с общей обработкой для нескольких голосовых клипов:

<hf-audio-group
  id="voiceover"
  data-label="Voiceover"
  data-volume="0.9"
  data-fx-chain='{"version":1,"nodes":[
    {"type":"compressor","id":"g1","params":{"threshold":-18,"ratio":3}},
    {"type":"peaking","id":"g2","params":{"frequency":3000,"gain":2,"q":1}}]}'
></hf-audio-group>

<audio id="vo-intro" data-audio-group="voiceover" …></audio>
<audio id="vo-middle" data-audio-group="voiceover" …></audio>

Установка

npx skills add https://github.com/heygen-com/hyperframes --skill hyperframes-audio