hyperframes-audio

HyperFrames Audio 是一个面向 HyperFrames 合成项目的音频混音技能，专注于处理已放置音频轨道的混音关系。

用途

该技能适用于在 HyperFrames 合成中需要混音的场合，包括淡入淡出、交叉淡化、轨道增益/音量调整、音量自动化、闪避（ducking）、人声雕刻（voiceover carve）以及效果链管理。它不负责音频素材的获取、生成或预处理（这些由 /media-use 负责），也不处理剪辑时间（由 /hyperframes-core 负责）。

主要能力

效果链：通过 data-fx-chain 属性在音频或视频元素上定义效果处理顺序，支持增益、EQ（高通、低通、峰值、搁架）、压缩器、限制器、真峰值限制器、门限、饱和、延迟、混响、合唱、移相器和位压缩等效果家族。
自动化：通过 data-automation 属性定义音量或效果参数的包络线。
闪避/人声雕刻：通过 data-fx-carve 属性配置，自动分析人声频段并让背景音乐在相应频段让出空间，保持音乐的低频和高频，同时提升人声清晰度。
音频组总线：通过 <hf-audio-group> 元素可将多个轨道归为一个总线，共享一个效果链、一个推子和一个自动化时钟。
预览与渲染一致性：预览和渲染共用同一 Web Audio 图实现，避免二次调音。

使用方式

在音频或视频元素上直接设置 data-fx-chain、data-automation 和 data-fx-carve 属性。对于人声雕刻，将背景音乐元素指向人声组，例如：

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

并建议将人声剪辑分组，通过 data-audio-group 属性关联，以避免逐个指定剪辑 ID 的脆弱性：

<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>

音频组总线示例：

<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>

具体安装命令暂未提供，文档提及插件安装和独立安装两种方式。

适用场景

视频合成中需要混合背景音乐与人声旁白，希望人声清晰而不整体压低音乐。
多段旁白需要统一处理（如压缩、EQ）时，使用音频组总线避免逐轨维护。
需要精确控制淡入淡出、交叉淡化或音量自动化。
需要为音频添加特定效果（如混响、延迟、饱和）以塑造空间感或音色。

限制

不提供自动波形同步或漂移校正。
人声雕刻要求背景音乐本身不是人声组的一部分，且人声组中不应包含音效或音乐剪辑。
每个效果的具体 JSON 格式和参数范围需参考 references/attributes.md 和 references/fx-registry.md。
诊断未知音频文件时，若没有原始文件或可用静音段，静态音调缺陷可能无法确定。
文档中列出的预设和命名作业可参考 references/presets.md，但具体收费、价格、平台等信息暂未提供。

技能介绍

用途

主要能力

使用方式

适用场景

限制