Formato de archivo de biblioteca

`library.json`

Una biblioteca de Audio Forge exportada es un archivo ZIP que contiene un descriptor library.json y sus archivos de audio. El esquema legible por máquina actual es:

Esquema de biblioteca de Audio Forge v1

Los enteros y decimales JSON son válidos para los campos del tipo number. Por ejemplo, "ambianceDuckingPercent": 0 y "ambianceDuckingPercent": 0.0 son equivalentes.

El descriptor contiene exactamente una propiedad de nivel superior. Su nombre es el nombre de visualización de la biblioteca. La biblioteca puede contener Music, Ambiance, y la sección de legado Sound. Cada sección asigna nombres de categoría a objetos de categoría.

{
  "My Library": {
    "Music": {
      "Battle": {
        "name": "Battle",
        "packName": "user",
        "enabled": true,
        "oneShot": false,
        "iconType": "fontIcon",
        "targetVolume": 1.0
      }
    },
    "Ambiance": {
      "Thunder": {
        "name": "Thunder",
        "packName": "user",
        "enabled": true,
        "oneShot": true,
        "ambianceDuckingPercent": 0
      }
    }
  }
}

Solo name es obligatorio en un objeto de categoría. Los campos opcionales omitidos usan los valores predeterminados que se muestran a continuación. Un campo marcado como nullable también puede establecerse en null.

Campo	Tipo JSON	Valor predeterminado o significado
`name`	string	Nombre de visualización de la categoría requerido
`packName`	string o null	Cadena vacía
`packId`	string o null	Sin paquete asociado
`icon`	integer o null	Código de punto de la carpeta del material
`iconFamily`	string o null	`MaterialIcons`
`iconPackage`	string o null	Sin paquete de iconos
`iconRef`	object o null	Referencia al registro con `pack`, `name`, y un entero opcional `version`
`color`	integer o null	Entero ARGB de color; gris cuando se omite
`isDefault`	boolean o null	`false`
`singleLoop`	boolean o null	`false`
`oneShot`	boolean o null	`false`; usa `true` para una categoría Echo
`singlePlayTransitionTo`	string o null	Cadena vacía
`singlePlayTransitionMs`	integer o null	Duración del temporizador en milisegundos
`singlePlayTransitionTrackCount`	integer o null	`1`
`singlePlayStopPlayback`	boolean o null	`false`
`timerEnabled`	boolean o null	`false`
`enabled`	boolean o null	`true`
`index`	integer o null	`-1`
`key`	string o null	Clave de categoría de mercado sin mercado
`minPause`	integer o null	Pausa mínima en milisegundos; `0`
`maxPause`	integer o null	Pausa máxima en milisegundos; `0`
`crossfadeDuration`	number o null	Segundos; `0`. Los valores negativos superponen las pistas
`transitionsEnabled`	boolean o null	`false`
`nameIntl`	object o null	Mapa de cadena de nombre local
`version`	integer o null	Versión de datos de la categoría
`initialVolume`	number o null	Ganancia interna inicial; no se anula cuando se omite
`targetVolume`	number o null	Ganancia interna de destino; no se anula cuando se omite
`initialTransition`	integer o null	Transición inicial en milisegundos
`initialPlaybackSpeed`	number o null	Multiplicador de velocidad de reproducción
`ambianceDuckingPercent`	number o null	Porcentaje de reducción de música de `0` a `100`
`iconType`	string o null	`fontIcon` o `customIcon`; por defecto `fontIcon`
`customIconPath`	string o null	Ruta del icono personalizado dentro de la biblioteca

Los campos de volumen de categoría en library.json usan la ganancia interna de Audio Forge, donde 1.0 es la unidad y 2.0 es el máximo aumentado. Esto difiere de la escala de visualización normalizada 0.0 a 1.0 de la API Local.

Rutas de archivo

Los archivos de audio usan los nombres de categoría de library.json:

library.json
Music/Battle/battle-theme.ogg
Ambiance/Thunder/thunder.ogg

Los archivos de iconos personalizados exportados por Audio Forge se almacenan en user_icons/. Los metadatos de transición opcionales se almacenan en transitions/transitions.json, y los estados guardados opcionales se almacenan en saved_states.json.

Audio Forge valida el descriptor completo antes de modificar una biblioteca. Un campo no válido produce un error que contiene su biblioteca, sección, categoría y ruta de campo.