{
  "appVersion": "1.6.1",
  "contract": {
    "id": "recording",
    "name": "Aufnahme und Gruppen",
    "fields": [
      {
        "id": "commands",
        "name": "commands",
        "type": "ObservableCollection`1",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "commands.delayBeforeUs",
        "name": "delayBeforeUs",
        "type": "Int64",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "commands.groupId",
        "name": "groupId",
        "type": "String",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "commands.id",
        "name": "id",
        "type": "String",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "formatVersion",
        "name": "formatVersion",
        "type": "Int32",
        "options": [],
        "defaultValue": 3
      },
      {
        "id": "groups",
        "name": "groups",
        "type": "ObservableCollection`1",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "groups.id",
        "name": "id",
        "type": "String",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "groups.automatic",
        "name": "automatic",
        "type": "Boolean",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "groups.title",
        "name": "title",
        "type": "String",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "id",
        "name": "id",
        "type": "Guid",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "name",
        "name": "name",
        "type": "String",
        "options": [],
        "defaultValue": ""
      },
      {
        "id": "recordedEnvironment",
        "name": "recordedEnvironment",
        "type": "MakroRecordedEnvironment",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.recordedAtUtc",
        "name": "recordedAtUtc",
        "type": "DateTime",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.startCursorX",
        "name": "startCursorX",
        "type": "Int32",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.startCursorY",
        "name": "startCursorY",
        "type": "Int32",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.virtualDesktopHeight",
        "name": "virtualDesktopHeight",
        "type": "Int32",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.virtualDesktopWidth",
        "name": "virtualDesktopWidth",
        "type": "Int32",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.virtualDesktopX",
        "name": "virtualDesktopX",
        "type": "Int32",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordedEnvironment.virtualDesktopY",
        "name": "virtualDesktopY",
        "type": "Int32",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordingSettings",
        "name": "recordingSettings",
        "type": "MakroRecordingSettings",
        "options": [],
        "defaultValue": null
      },
      {
        "id": "recordingSettings.automaticMovementGroups",
        "name": "automaticMovementGroups",
        "type": "Boolean",
        "options": [],
        "defaultValue": true
      },
      {
        "id": "recordingSettings.combineKeyboardInputs",
        "name": "combineKeyboardInputs",
        "type": "Boolean",
        "options": [],
        "defaultValue": false
      },
      {
        "id": "recordingSettings.minimumDistancePixels",
        "name": "minimumDistancePixels",
        "type": "Int32",
        "options": [],
        "defaultValue": 0
      },
      {
        "id": "recordingSettings.minimumIntervalUs",
        "name": "minimumIntervalUs",
        "type": "Int32",
        "options": [],
        "defaultValue": 1000
      },
      {
        "id": "recordingSettings.mode",
        "name": "mode",
        "type": "MakroRecordingMode",
        "options": [
          "ClicksOnly",
          "ScreenAccurateAbsolute",
          "MotionFaithfulRelative"
        ],
        "defaultValue": "ScreenAccurateAbsolute"
      },
      {
        "id": "recordingSettings.recordingHotkeyModifiers",
        "name": "recordingHotkeyModifiers",
        "type": "KeyModifiers",
        "options": [
          "None",
          "Alt",
          "Control",
          "Shift",
          "Windows"
        ],
        "defaultValue": "None"
      },
      {
        "id": "recordingSettings.recordingHotkeyVirtualKey",
        "name": "recordingHotkeyVirtualKey",
        "type": "UInt32",
        "options": [],
        "defaultValue": 120
      },
      {
        "id": "recordingSettings.recordKeyboard",
        "name": "recordKeyboard",
        "type": "Boolean",
        "options": [],
        "defaultValue": true
      },
      {
        "id": "recordingSettings.recordMouseButtons",
        "name": "recordMouseButtons",
        "type": "Boolean",
        "options": [],
        "defaultValue": true
      },
      {
        "id": "recordingSettings.removeStopGesture",
        "name": "removeStopGesture",
        "type": "Boolean",
        "options": [],
        "defaultValue": true
      }
    ]
  },
  "explanations": {
    "purpose": "Ein Makro speichert geordnete Befehle, optionale Gruppen, Aufnahmeoptionen und gegebenenfalls die Aufnahmeumgebung. Gruppen sind Bearbeitungsmetadaten; die Ausführung folgt commands. Der Executor führt Makros exklusiv über seinen Ausführungsgate aus und gibt selbst gehaltene Eingaben auch bei Abbruch frei.",
    "example": "Das Makrobeispiel kombiniert text_input mit „Notiz aus dem Beispielmakro“ und anschließend timeout mit duration=200. Vor Ausführung einen leeren Editor fokussieren.",
    "errors": "Ungültige Tasten-/Maustastenkennungen, doppelte IDs, fehlerhafte Gruppenreferenzen und negative/ungültige Zeitwerte vor Ausführung korrigieren. Eingaben wirken auf das aktive Fenster. Bei absoluten Bewegungen die Aufnahmeumgebung prüfen; ein Abbruch gibt die vom Executor gehaltenen Tasten/Maustasten frei, rekonstruiert aber keine bereits eingegebenen Texte.",
    "field.commands": "Geordnete Makrobefehle mit type und eindeutiger id. Die Reihenfolge ist die Ausführungsreihenfolge; UI-Gruppierung ersetzt diese Liste nicht.",
    "field.commands.delayBeforeUs": "Wartezeit vor diesem Makrobefehl in Mikrosekunden; 1000 µs sind 1 ms. null kennzeichnet ältere oder manuell angelegte Befehle ohne aufgezeichnete Vorverzögerung.",
    "field.commands.groupId": "Optionale Referenz auf groups[].id. Gruppen ordnen zusammengehörige aufgezeichnete Befehle, ändern aber nicht ihre Reihenfolge in commands. Jede Gruppe muss Befehle enthalten; Befehle derselben Gruppe müssen einen zusammenhängenden Block bilden.",
    "field.commands.id": "Stabile Identität dieses Eintrags. In einem Job müssen Step-IDs eindeutig sein; beim Kopieren eines eigenständigen Jobs/Makros eine neue Objekt-GUID erzeugen und interne Referenzen gezielt anpassen.",
    "field.formatVersion": "Versionsnummer des gespeicherten Formats. Aktuell Job=4, Makro=3, Automation=1. Eine Änderung ist keine Methode, eine inkompatible Datei zu reparieren.",
    "field.groups": "Gruppenmetadaten eines Makros. Jeder referenzierte groupId muss auf eine gültige Gruppe zeigen. Jede Gruppe muss Befehle enthalten; Befehle derselben Gruppe müssen einen zusammenhängenden Block bilden.",
    "field.groups.id": "Stabile Identität dieses Eintrags. In einem Job müssen Step-IDs eindeutig sein; beim Kopieren eines eigenständigen Jobs/Makros eine neue Objekt-GUID erzeugen und interne Referenzen gezielt anpassen.",
    "field.groups.automatic": "Markiert eine automatisch bei der Aufnahme erzeugte Gruppe; Titel und Befehlszuordnung bleiben Metadaten des Makros.",
    "field.groups.title": "Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.",
    "field.id": "Stabile Identität dieses Eintrags. In einem Job müssen Step-IDs eindeutig sein; beim Kopieren eines eigenständigen Jobs/Makros eine neue Objekt-GUID erzeugen und interne Referenzen gezielt anpassen.",
    "field.name": "Anzeigename für Auswahl und Verlauf. Beziehungen verwenden die stabile ID, nicht diesen frei änderbaren Namen.",
    "field.recordedEnvironment": "Optionaler Snapshot der Aufnahmeumgebung. Er hilft, Abweichungen der Bildschirmgeometrie bei absoluten Makros zu erkennen.",
    "field.recordedEnvironment.recordedAtUtc": "UTC-Zeitpunkt der Aufnahme. Er ist Metadatum und keine Befehlsverzögerung.",
    "field.recordedEnvironment.startCursorX": "Optionale horizontale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.",
    "field.recordedEnvironment.startCursorY": "Optionale vertikale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.",
    "field.recordedEnvironment.virtualDesktopHeight": "Gesamthöhe der aufgezeichneten Desktop-Anordnung in Pixeln.",
    "field.recordedEnvironment.virtualDesktopWidth": "Gesamtbreite der aufgezeichneten Desktop-Anordnung in Pixeln. Abweichende Anordnungen können absolute Mauspositionen verändern.",
    "field.recordedEnvironment.virtualDesktopX": "Linke Kante des gesamten virtuellen Desktops bei Aufnahme; sie kann bei Monitoren links vom Hauptmonitor negativ sein.",
    "field.recordedEnvironment.virtualDesktopY": "Obere Kante des virtuellen Desktops bei Aufnahme; sie kann bei Monitoren oberhalb des Hauptmonitors negativ sein.",
    "field.recordingSettings": "Optionen für neue Makroaufnahmen. Änderungen an diesen Optionen wandeln vorhandene commands nicht automatisch in andere Bewegungstypen um.",
    "field.recordingSettings.automaticMovementGroups": "Erzeugt bei der Aufnahme Gruppen für zusammengehörige Bewegungen. Befehlszeiten und Reihenfolge bleiben ausdrücklich gespeichert.",
    "field.recordingSettings.combineKeyboardInputs": "Fasst geeignete aufgezeichnete Tastatureingaben zusammen, etwa zu Text-/Kombinationsbefehlen.",
    "field.recordingSettings.minimumDistancePixels": "Kleinste räumliche Distanz zwischen aufgezeichneten Bewegungsproben in Pixeln.",
    "field.recordingSettings.minimumIntervalUs": "Kleinster zeitlicher Abstand aufgezeichneter Bewegungsproben in Mikrosekunden. Er beeinflusst Datenmenge und zeitliche Genauigkeit.",
    "field.recordingSettings.mode": "Aufnahmemodus: 0=ClicksOnly, 1=ScreenAccurateAbsolute, 2=MotionFaithfulRelative. Im Makro-JSON wird dieser Enum als Zahl gespeichert; die Optionen ändern nur zukünftige Aufnahmen.",
    "field.recordingSettings.recordingHotkeyModifiers": "Bitmaske der Aufnahme-Hotkey-Modifikatoren: Alt=1, Control=2, Shift=4, Windows=8, None=0.",
    "field.recordingSettings.recordingHotkeyVirtualKey": "Virtual-Key-Code der Aufnahme-Taste; Standard 120 entspricht F9. Prüfe Konflikte mit anderen Hotkeys.",
    "field.recordingSettings.recordKeyboard": "Zeichnet Tastatureingaben für neue Makroaufnahmen auf. Vorhandene Tastenbefehle werden dadurch nicht entfernt.",
    "field.recordingSettings.recordMouseButtons": "Zeichnet Maustasten für neue Aufnahmen auf; reine Bewegungsaufzeichnung ist davon getrennt.",
    "field.recordingSettings.removeStopGesture": "Entfernt die konfigurierte Stop-Geste aus der Aufnahme, damit sie später nicht als gewünschte Eingabe wiederholt wird.",
    "field.recordingSettings.mode.option.MotionFaithfulRelative": "Aufnahmemodus 2: relative Mausbewegungen aufzeichnen.",
    "field.recordingSettings.recordingHotkeyModifiers.option.Alt": "Alt-Modifikator; numerische Bitmaske 1.",
    "field.recordingSettings.recordingHotkeyModifiers.option.Shift": "Umschalt-Modifikator; numerische Bitmaske 4.",
    "field.recordingSettings.recordingHotkeyModifiers.option.None": "Keine Modifikatortaste; numerische Bitmaske 0.",
    "field.recordingSettings.mode.option.ScreenAccurateAbsolute": "Aufnahmemodus 1: Bildschirmpositionen als absolute Pixelkoordinaten aufzeichnen.",
    "field.recordingSettings.recordingHotkeyModifiers.option.Control": "Strg-Modifikator; numerische Bitmaske 2.",
    "field.recordingSettings.recordingHotkeyModifiers.option.Windows": "Windows-Taste als Modifikator (Bitmaske 8) beziehungsweise Windows-Fachbereich, wenn diese Option zu einem Log-Bereich gehört.",
    "field.recordingSettings.mode.option.ClicksOnly": "Aufnahmemodus 0: Klick-/Tastenaktionen statt einer vollständigen Bewegungsspur aufzeichnen."
  },
  "template": {
    "formatVersion": 3,
    "id": "95725efa-50bf-07cb-abf1-4f87f86b2103",
    "name": "Mein Makro",
    "commands": [],
    "groups": [],
    "recordingSettings": {
      "mode": 1,
      "minimumIntervalUs": 1000,
      "minimumDistancePixels": 0,
      "recordKeyboard": true,
      "combineKeyboardInputs": false,
      "recordMouseButtons": true,
      "removeStopGesture": true,
      "automaticMovementGroups": true,
      "recordingHotkeyModifiers": 0,
      "recordingHotkeyVirtualKey": 120
    },
    "recordedEnvironment": null
  },
  "screenshots": [],
  "note": "Referenzdaten. Defaultvorlage vor Verwendung vervollständigen und fachlich validieren."
}