Formato file della libreria

`library.json`

Una libreria Audio Forge esportata è un archivio ZIP contenente un descrittore library.json e i suoi file audio. Lo schema leggibile dalla macchina corrente è:

Schema libreria Audio Forge v1

Sia gli interi che i decimali JSON sono validi per i campi del tipo number. Ad esempio, "ambianceDuckingPercent": 0 e "ambianceDuckingPercent": 0.0 sono equivalenti.

Il descrittore contiene esattamente una proprietà di primo livello. Il suo nome è il nome visualizzato della libreria. La libreria può contenere Music, Ambiance e la sezione legacy Sound. Ogni sezione mappa i nomi delle categorie agli oggetti categoria.

{
  "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 è richiesto in un oggetto categoria. I campi opzionali omessi utilizzano i valori predefiniti mostrati di seguito. Un campo contrassegnato come nullable può anche essere impostato su null.

Campo	Tipo JSON	Valore predefinito o significato
`name`	stringa	Nome visualizzato della categoria richiesto
`packName`	stringa o null	Stringa vuota
`packId`	stringa o null	Nessun pacchetto associato
`icon`	intero o null	Codice punto icona cartella materiale
`iconFamily`	stringa o null	`MaterialIcons`
`iconPackage`	stringa o null	Nessun pacchetto di icone
`iconRef`	oggetto o null	Riferimento al registro con `pack`, `name` e un intero opzionale `version`
`color`	intero o null	Intero ARGB colore; grigio quando omesso
`isDefault`	booleano o null	`false`
`singleLoop`	booleano o null	`false`
`oneShot`	booleano o null	`false`; usa `true` per una categoria Echo
`singlePlayTransitionTo`	stringa o null	Stringa vuota
`singlePlayTransitionMs`	intero o null	Durata del timer in millisecondi
`singlePlayTransitionTrackCount`	intero o null	`1`
`singlePlayStopPlayback`	booleano o null	`false`
`timerEnabled`	booleano o null	`false`
`enabled`	booleano o null	`true`
`index`	intero o null	`-1`
`key`	stringa o null	Nessuna chiave di categoria del marketplace
`minPause`	intero o null	Pausa minima in millisecondi; `0`
`maxPause`	intero o null	Pausa massima in millisecondi; `0`
`crossfadeDuration`	numero o null	Secondi; `0`. I valori negativi sovrappongono le tracce
`transitionsEnabled`	booleano o null	`false`
`nameIntl`	oggetto o null	Mappa stringa-nome specifica per la localizzazione
`version`	intero o null	Versione dei dati della categoria
`initialVolume`	numero o null	Guadagno interno iniziale; nessuna sovrascrittura quando omesso
`targetVolume`	numero o null	Guadagno interno di destinazione; nessuna sovrascrittura quando omesso
`initialTransition`	intero o null	Transizione iniziale in millisecondi
`initialPlaybackSpeed`	numero o null	Moltiplicatore della velocità di riproduzione
`ambianceDuckingPercent`	numero o null	Percentuale di riduzione del volume musicale da `0` a `100`
`iconType`	stringa o null	`fontIcon` o `customIcon`; predefinito su `fontIcon`
`customIconPath`	stringa o null	Percorso dell’icona personalizzata all’interno della libreria

I campi di volume della categoria in library.json utilizzano il guadagno interno di Audio Forge, dove 1.0 è l’unità e 2.0 è il massimo potenziato. Questo differisce dalla scala visualizzata normalizzata 0.0 a 1.0 dell’API Local.

Percorsi degli archivi

I file audio utilizzano i nomi delle categorie da library.json:

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

I file di icone personalizzate esportati da Audio Forge sono archiviati in user_icons/. I metadati di transizione opzionali sono archiviati in transitions/transitions.json e gli stati salvati opzionali sono archiviati in saved_states.json.

Audio Forge convalida l’intero descrittore prima di modificare una libreria. Un campo non valido produce un errore contenente la sua libreria, sezione, categoria e percorso del campo.