Bibliotheksdateiformat

`library.json`

Eine exportierte Audio Forge-Bibliothek ist ein ZIP-Archiv, das einen library.json Deskriptor und seine Audiodateien enthält. Das aktuelle, für Maschinen lesbare Schema ist:

Audio Forge-Bibliotheksschema v1

JSON-Integer und -Dezimalzahlen sind für Felder vom Typ number gültig. Zum Beispiel "ambianceDuckingPercent": 0 und "ambianceDuckingPercent": 0.0 sind äquivalent.

Der Deskriptor enthält genau eine oberste Eigenschaft. Ihr Name ist der Anzeigename der Bibliothek. Die Bibliothek kann Music, Ambiance und den veralteten Sound-Abschnitt enthalten. Jeder Abschnitt ordnet Kategorienamen Kategorieobjekten zu.

{
  "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
      }
    }
  }
}

Nur name ist in einem Kategorieobjekt erforderlich. Fehlende optionale Felder verwenden die Standardwerte, die unten angezeigt werden. Ein Feld, das als nullable gekennzeichnet ist, kann auch auf null gesetzt werden.

Feld	JSON-Typ	Standardwert oder Bedeutung
`name`	string	Erforderlicher Anzeigename der Kategorie
`packName`	string oder null	Leerer String
`packId`	string oder null	Kein zugehöriges Paket
`icon`	integer oder null	Materialordner-Symbol-Code-Punkt
`iconFamily`	string oder null	`MaterialIcons`
`iconPackage`	string oder null	Kein Symbolpaket
`iconRef`	object oder null	Registry-Referenz mit `pack`, `name` und optionalem Integer `version`
`color`	integer oder null	ARGB-Farb-Integer; grau, wenn er fehlt
`isDefault`	boolean oder null	`false`
`singleLoop`	boolean oder null	`false`
`oneShot`	boolean oder null	`false`; Verwenden Sie `true` für eine Echo-Kategorie
`singlePlayTransitionTo`	string oder null	Leerer String
`singlePlayTransitionMs`	integer oder null	Timer-Dauer in Millisekunden
`singlePlayTransitionTrackCount`	integer oder null	`1`
`singlePlayStopPlayback`	boolean oder null	`false`
`timerEnabled`	boolean oder null	`false`
`enabled`	boolean oder null	`true`
`index`	integer oder null	`-1`
`key`	string oder null	Kein Marketplace-Kategorischlüssel
`minPause`	integer oder null	Minimale Pause in Millisekunden; `0`
`maxPause`	integer oder null	Maximale Pause in Millisekunden; `0`
`crossfadeDuration`	number oder null	Sekunden; `0`. Negative Werte überlappen Tracks
`transitionsEnabled`	boolean oder null	`false`
`nameIntl`	object oder null	Locale-zu-Name-String-Map
`version`	integer oder null	Kategorie-Datenversion
`initialVolume`	number oder null	Initialer interner Gain; wird bei Auslassen nicht überschrieben
`targetVolume`	number oder null	Ziel-interner Gain; wird bei Auslassen nicht überschrieben
`initialTransition`	integer oder null	Initialer Übergang in Millisekunden
`initialPlaybackSpeed`	number oder null	Wiedergabegeschwindigkeit-Multiplikator
`ambianceDuckingPercent`	number oder null	Musik-Ducking-Prozentsatz von `0` zu `100`
`iconType`	string oder null	`fontIcon` oder `customIcon`; standardmäßig `fontIcon`
`customIconPath`	string oder null	Pfad des benutzerdefinierten Symbols innerhalb der Bibliothek

Kategorie-Lautstärke-Felder in library.json verwenden Audio Forge’s internen Gain-Bereich, wobei 1.0 die Einheit und 2.0 das maximale Boost ist. Dies unterscheidet sich von der Local API’s normalisierten 0.0 zu 1.0 Anzeige-Skala.

Archivpfade

Audiodateien verwenden die Kategorie-Namen aus library.json:

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

Benutzerdefinierte Symboldateien, die von Audio Forge exportiert werden, werden unter user_icons/ gespeichert. Optionale Übergangs-Metadaten werden in transitions/transitions.json gespeichert, und optionale gespeicherte Zustände werden in saved_states.json gespeichert.

Audio Forge validiert den gesamten Deskriptor, bevor eine Bibliothek geändert wird. Ein ungültiges Feld erzeugt einen Fehler, der seine Bibliothek, seinen Abschnitt, seine Kategorie und sein Feld enthält.