Vorschau · Entwicklungsstand 1.6.1

Aufnahme und Gruppen

Wofür ist das gedacht?

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.

Aufnahme und Gruppen verstehen
  1. 1
    commands

    Geordnete Makrobefehle mit type und eindeutiger id. Die Reihenfolge ist die Ausführungsreihenfolge; UI-Gruppierung ersetzt diese Liste nicht.

  2. 2
    delayBeforeUs

    Wartezeit vor diesem Makrobefehl in Mikrosekunden; 1000 µs sind 1 ms. null kennzeichnet ältere oder manuell angelegte Befehle ohne aufgezeichnete Vorverzögerung.

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

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

  5. 5
    formatVersion

    Versionsnummer des gespeicherten Formats. Aktuell Job=4, Makro=3, Automation=1. Eine Änderung ist keine Methode, eine inkompatible Datei zu reparieren.

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

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

  8. 8
    automatic

    Markiert eine automatisch bei der Aufnahme erzeugte Gruppe; Titel und Befehlszuordnung bleiben Metadaten des Makros.

  9. 9
    title

    Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.

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

  11. 11
    name

    Anzeigename für Auswahl und Verlauf. Beziehungen verwenden die stabile ID, nicht diesen frei änderbaren Namen.

  12. 12
    recordedEnvironment

    Optionaler Snapshot der Aufnahmeumgebung. Er hilft, Abweichungen der Bildschirmgeometrie bei absoluten Makros zu erkennen.

  13. 13
    recordedAtUtc

    UTC-Zeitpunkt der Aufnahme. Er ist Metadatum und keine Befehlsverzögerung.

  14. 14
    startCursorX

    Optionale horizontale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.

  15. 15
    startCursorY

    Optionale vertikale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.

  16. 16
    virtualDesktopHeight

    Gesamthöhe der aufgezeichneten Desktop-Anordnung in Pixeln.

  17. 17
    virtualDesktopWidth

    Gesamtbreite der aufgezeichneten Desktop-Anordnung in Pixeln. Abweichende Anordnungen können absolute Mauspositionen verändern.

  18. 18
    virtualDesktopX

    Linke Kante des gesamten virtuellen Desktops bei Aufnahme; sie kann bei Monitoren links vom Hauptmonitor negativ sein.

  19. 19
    virtualDesktopY

    Obere Kante des virtuellen Desktops bei Aufnahme; sie kann bei Monitoren oberhalb des Hauptmonitors negativ sein.

  20. 20
    recordingSettings

    Optionen für neue Makroaufnahmen. Änderungen an diesen Optionen wandeln vorhandene commands nicht automatisch in andere Bewegungstypen um.

  21. 21
    automaticMovementGroups

    Erzeugt bei der Aufnahme Gruppen für zusammengehörige Bewegungen. Befehlszeiten und Reihenfolge bleiben ausdrücklich gespeichert.

  22. 22
    combineKeyboardInputs

    Fasst geeignete aufgezeichnete Tastatureingaben zusammen, etwa zu Text-/Kombinationsbefehlen.

  23. 23
    minimumDistancePixels

    Kleinste räumliche Distanz zwischen aufgezeichneten Bewegungsproben in Pixeln.

  24. 24
    minimumIntervalUs

    Kleinster zeitlicher Abstand aufgezeichneter Bewegungsproben in Mikrosekunden. Er beeinflusst Datenmenge und zeitliche Genauigkeit.

  25. 25
    mode

    Aufnahmemodus: 0=ClicksOnly, 1=ScreenAccurateAbsolute, 2=MotionFaithfulRelative. Im Makro-JSON wird dieser Enum als Zahl gespeichert; die Optionen ändern nur zukünftige Aufnahmen.

  26. 26
    recordingHotkeyModifiers

    Bitmaske der Aufnahme-Hotkey-Modifikatoren: Alt=1, Control=2, Shift=4, Windows=8, None=0.

  27. 27
    recordingHotkeyVirtualKey

    Virtual-Key-Code der Aufnahme-Taste; Standard 120 entspricht F9. Prüfe Konflikte mit anderen Hotkeys.

  28. 28
    recordKeyboard

    Zeichnet Tastatureingaben für neue Makroaufnahmen auf. Vorhandene Tastenbefehle werden dadurch nicht entfernt.

  29. 29
    recordMouseButtons

    Zeichnet Maustasten für neue Aufnahmen auf; reine Bewegungsaufzeichnung ist davon getrennt.

  30. 30
    removeStopGesture

    Entfernt die konfigurierte Stop-Geste aus der Aufnahme, damit sie später nicht als gewünschte Eingabe wiederholt wird.

Orientierung für die Bedienung. Technische Verträge stehen im Entwicklerbereich am Seitenende.

Einstellungen in der Oberfläche

Beispielwerte dienen zur Orientierung. Passe Pfade, Quellen und Geräte an deinen Arbeitsplatz an. Ein ausgeschaltetes Häkchen und die Zahl 0 sind ebenfalls gültige Beispielwerte.

EinstellungBedeutung und BedienungBeispielwert
commandsGeordnete Makrobefehle mit type und eindeutiger id. Die Reihenfolge ist die Ausführungsreihenfolge; UI-Gruppierung ersetzt diese Liste nicht.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
delayBeforeUsWartezeit vor diesem Makrobefehl in Mikrosekunden; 1000 µs sind 1 ms. null kennzeichnet ältere oder manuell angelegte Befehle ohne aufgezeichnete Vorverzögerung.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
groupIdOptionale 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.Beispieltext
idStabile 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.Beispieltext
formatVersionVersionsnummer des gespeicherten Formats. Aktuell Job=4, Makro=3, Automation=1. Eine Änderung ist keine Methode, eine inkompatible Datei zu reparieren.3
groupsGruppenmetadaten 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.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
idStabile 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.Beispieltext
automaticMarkiert eine automatisch bei der Aufnahme erzeugte Gruppe; Titel und Befehlszuordnung bleiben Metadaten des Makros.Aus (Häkchen entfernt)
titleSichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.Hinweis
idStabile 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.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
nameAnzeigename für Auswahl und Verlauf. Beziehungen verwenden die stabile ID, nicht diesen frei änderbaren Namen.Beispieltext
recordedEnvironmentOptionaler Snapshot der Aufnahmeumgebung. Er hilft, Abweichungen der Bildschirmgeometrie bei absoluten Makros zu erkennen.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
recordedAtUtcUTC-Zeitpunkt der Aufnahme. Er ist Metadatum und keine Befehlsverzögerung.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
startCursorXOptionale horizontale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.100
startCursorYOptionale vertikale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.100
virtualDesktopHeightGesamthöhe der aufgezeichneten Desktop-Anordnung in Pixeln.100
virtualDesktopWidthGesamtbreite der aufgezeichneten Desktop-Anordnung in Pixeln. Abweichende Anordnungen können absolute Mauspositionen verändern.100
virtualDesktopXLinke Kante des gesamten virtuellen Desktops bei Aufnahme; sie kann bei Monitoren links vom Hauptmonitor negativ sein.100
virtualDesktopYObere Kante des virtuellen Desktops bei Aufnahme; sie kann bei Monitoren oberhalb des Hauptmonitors negativ sein.100
recordingSettingsOptionen für neue Makroaufnahmen. Änderungen an diesen Optionen wandeln vorhandene commands nicht automatisch in andere Bewegungstypen um.Passenden Wert oder Ergebnis eines vorherigen Steps auswählen; Unterfelder siehe unten.
automaticMovementGroupsErzeugt bei der Aufnahme Gruppen für zusammengehörige Bewegungen. Befehlszeiten und Reihenfolge bleiben ausdrücklich gespeichert.An (Häkchen gesetzt)
combineKeyboardInputsFasst geeignete aufgezeichnete Tastatureingaben zusammen, etwa zu Text-/Kombinationsbefehlen.Aus (Häkchen entfernt)
minimumDistancePixelsKleinste räumliche Distanz zwischen aufgezeichneten Bewegungsproben in Pixeln.0
minimumIntervalUsKleinster zeitlicher Abstand aufgezeichneter Bewegungsproben in Mikrosekunden. Er beeinflusst Datenmenge und zeitliche Genauigkeit.1000
modeAufnahmemodus: 0=ClicksOnly, 1=ScreenAccurateAbsolute, 2=MotionFaithfulRelative. Im Makro-JSON wird dieser Enum als Zahl gespeichert; die Optionen ändern nur zukünftige Aufnahmen.
ClicksOnly
Aufnahmemodus 0: Klick-/Tastenaktionen statt einer vollständigen Bewegungsspur aufzeichnen.
ScreenAccurateAbsolute
Aufnahmemodus 1: Bildschirmpositionen als absolute Pixelkoordinaten aufzeichnen.
MotionFaithfulRelative
Aufnahmemodus 2: relative Mausbewegungen aufzeichnen.
ScreenAccurateAbsolute
recordingHotkeyModifiersBitmaske der Aufnahme-Hotkey-Modifikatoren: Alt=1, Control=2, Shift=4, Windows=8, None=0.
None
Keine Modifikatortaste; numerische Bitmaske 0.
Alt
Alt-Modifikator; numerische Bitmaske 1.
Control
Strg-Modifikator; numerische Bitmaske 2.
Shift
Umschalt-Modifikator; numerische Bitmaske 4.
Windows
Windows-Taste als Modifikator (Bitmaske 8) beziehungsweise Windows-Fachbereich, wenn diese Option zu einem Log-Bereich gehört.
None
recordingHotkeyVirtualKeyVirtual-Key-Code der Aufnahme-Taste; Standard 120 entspricht F9. Prüfe Konflikte mit anderen Hotkeys.120
recordKeyboardZeichnet Tastatureingaben für neue Makroaufnahmen auf. Vorhandene Tastenbefehle werden dadurch nicht entfernt.An (Häkchen gesetzt)
recordMouseButtonsZeichnet Maustasten für neue Aufnahmen auf; reine Bewegungsaufzeichnung ist davon getrennt.An (Häkchen gesetzt)
removeStopGestureEntfernt die konfigurierte Stop-Geste aus der Aufnahme, damit sie später nicht als gewünschte Eingabe wiederholt wird.An (Häkchen gesetzt)

Beispiel

Das Makrobeispiel kombiniert text_input mit „Notiz aus dem Beispielmakro“ und anschließend timeout mit duration=200. Vor Ausführung einen leeren Editor fokussieren.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

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.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: recording

Felder und Zusammenhänge auf einen Blick
  1. 1
    commandscommands · ObservableCollection`1 · Nicht angegeben

    Geordnete Makrobefehle mit type und eindeutiger id

  2. 2
    delayBeforeUscommands.delayBeforeUs · Int64 · Nicht angegeben

    Wartezeit vor diesem Makrobefehl in Mikrosekunden; 1000 µs sind 1 ms

  3. 3
    groupIdcommands.groupId · String · Nicht angegeben

    Optionale Referenz auf groups[].id

  4. 4
    idcommands.id · String · Nicht angegeben

    Stabile Identität dieses Eintrags

  5. 5
    formatVersionformatVersion · Int32 · 3

    Versionsnummer des gespeicherten Formats

  6. 6
    groupsgroups · ObservableCollection`1 · Nicht angegeben

    Gruppenmetadaten eines Makros

  7. 7
    idgroups.id · String · Nicht angegeben

    Stabile Identität dieses Eintrags

  8. 8
    automaticgroups.automatic · Boolean · Nicht angegeben

    Markiert eine automatisch bei der Aufnahme erzeugte Gruppe; Titel und Befehlszuordnung bleiben Metadaten des Makros.

  9. 9
    titlegroups.title · String · Nicht angegeben

    Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel

  10. 10
    idid · Guid · Nicht angegeben

    Stabile Identität dieses Eintrags

  11. 11
    namename · String · Leerer Text

    Anzeigename für Auswahl und Verlauf

  12. 12
    recordedEnvironmentrecordedEnvironment · MakroRecordedEnvironment · Nicht angegeben

    Optionaler Snapshot der Aufnahmeumgebung

  13. 13
    recordedAtUtcrecordedEnvironment.recordedAtUtc · DateTime · Nicht angegeben

    UTC-Zeitpunkt der Aufnahme

  14. 14
    startCursorXrecordedEnvironment.startCursorX · Int32 · Nicht angegeben

    Optionale horizontale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.

  15. 15
    startCursorYrecordedEnvironment.startCursorY · Int32 · Nicht angegeben

    Optionale vertikale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.

  16. 16
    virtualDesktopHeightrecordedEnvironment.virtualDesktopHeight · Int32 · Nicht angegeben

    Gesamthöhe der aufgezeichneten Desktop-Anordnung in Pixeln.

  17. 17
    virtualDesktopWidthrecordedEnvironment.virtualDesktopWidth · Int32 · Nicht angegeben

    Gesamtbreite der aufgezeichneten Desktop-Anordnung in Pixeln

  18. 18
    virtualDesktopXrecordedEnvironment.virtualDesktopX · Int32 · Nicht angegeben

    Linke Kante des gesamten virtuellen Desktops bei Aufnahme; sie kann bei Monitoren links vom Hauptmonitor negativ sein.

  19. 19
    virtualDesktopYrecordedEnvironment.virtualDesktopY · Int32 · Nicht angegeben

    Obere Kante des virtuellen Desktops bei Aufnahme; sie kann bei Monitoren oberhalb des Hauptmonitors negativ sein.

  20. 20
    recordingSettingsrecordingSettings · MakroRecordingSettings · Nicht angegeben

    Optionen für neue Makroaufnahmen

  21. 21
    automaticMovementGroupsrecordingSettings.automaticMovementGroups · Boolean · true

    Erzeugt bei der Aufnahme Gruppen für zusammengehörige Bewegungen

  22. 22
    combineKeyboardInputsrecordingSettings.combineKeyboardInputs · Boolean · false

    Fasst geeignete aufgezeichnete Tastatureingaben zusammen, etwa zu Text-/Kombinationsbefehlen.

  23. 23
    minimumDistancePixelsrecordingSettings.minimumDistancePixels · Int32 · 0

    Kleinste räumliche Distanz zwischen aufgezeichneten Bewegungsproben in Pixeln.

  24. 24
    minimumIntervalUsrecordingSettings.minimumIntervalUs · Int32 · 1000

    Kleinster zeitlicher Abstand aufgezeichneter Bewegungsproben in Mikrosekunden

  25. 25
    moderecordingSettings.mode · MakroRecordingMode · ClicksOnly, ScreenAccurateAbsolute, MotionFaithfulRelative

    Aufnahmemodus: 0=ClicksOnly, 1=ScreenAccurateAbsolute, 2=MotionFaithfulRelative

  26. 26
    recordingHotkeyModifiersrecordingSettings.recordingHotkeyModifiers · KeyModifiers · None, Alt, Control, Shift, Windows

    Bitmaske der Aufnahme-Hotkey-Modifikatoren: Alt=1, Control=2, Shift=4, Windows=8, None=0.

  27. 27
    recordingHotkeyVirtualKeyrecordingSettings.recordingHotkeyVirtualKey · UInt32 · 120

    Virtual-Key-Code der Aufnahme-Taste; Standard 120 entspricht F9

  28. 28
    recordKeyboardrecordingSettings.recordKeyboard · Boolean · true

    Zeichnet Tastatureingaben für neue Makroaufnahmen auf

  29. 29
    recordMouseButtonsrecordingSettings.recordMouseButtons · Boolean · true

    Zeichnet Maustasten für neue Aufnahmen auf; reine Bewegungsaufzeichnung ist davon getrennt.

  30. 30
    removeStopGesturerecordingSettings.removeStopGesture · Boolean · true

    Entfernt die konfigurierte Stop-Geste aus der Aufnahme, damit sie später nicht als gewünschte Eingabe wiederholt wird.

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Feldtypen, Standards und Regeln

WertTypStandard laut VertragOptionen und RegelnErklärung
commands
commands
ObservableCollection`1Nicht angegebenRegeln siehe Erklärung
Geordnete Makrobefehle mit type und eindeutiger id. Die Reihenfolge ist die Ausführungsreihenfolge; UI-Gruppierung ersetzt diese Liste nicht.
delayBeforeUs
commands.delayBeforeUs
Int64Nicht angegebenRegeln siehe Erklärung
Wartezeit vor diesem Makrobefehl in Mikrosekunden; 1000 µs sind 1 ms. null kennzeichnet ältere oder manuell angelegte Befehle ohne aufgezeichnete Vorverzögerung.
groupId
commands.groupId
StringNicht angegebenRegeln siehe Erklärung
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.
id
commands.id
StringNicht angegebenRegeln siehe Erklärung
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.
formatVersion
formatVersion
Int323Regeln siehe Erklärung
Versionsnummer des gespeicherten Formats. Aktuell Job=4, Makro=3, Automation=1. Eine Änderung ist keine Methode, eine inkompatible Datei zu reparieren.
groups
groups
ObservableCollection`1Nicht angegebenRegeln siehe Erklärung
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.
id
groups.id
StringNicht angegebenRegeln siehe Erklärung
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.
automatic
groups.automatic
BooleanNicht angegebenRegeln siehe Erklärung
Markiert eine automatisch bei der Aufnahme erzeugte Gruppe; Titel und Befehlszuordnung bleiben Metadaten des Makros.
title
groups.title
StringNicht angegebenRegeln siehe Erklärung
Sichtbare Überschrift der Auswahl beziehungsweise Gruppentitel. Sie ist keine technische Identität.
id
id
GuidNicht angegebenRegeln siehe Erklärung
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.
name
name
StringLeerer TextRegeln siehe Erklärung
Anzeigename für Auswahl und Verlauf. Beziehungen verwenden die stabile ID, nicht diesen frei änderbaren Namen.
recordedEnvironment
recordedEnvironment
MakroRecordedEnvironmentNicht angegebenRegeln siehe Erklärung
Optionaler Snapshot der Aufnahmeumgebung. Er hilft, Abweichungen der Bildschirmgeometrie bei absoluten Makros zu erkennen.
recordedAtUtc
recordedEnvironment.recordedAtUtc
DateTimeNicht angegebenRegeln siehe Erklärung
UTC-Zeitpunkt der Aufnahme. Er ist Metadatum und keine Befehlsverzögerung.
startCursorX
recordedEnvironment.startCursorX
Int32Nicht angegebenRegeln siehe Erklärung
Optionale horizontale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.
startCursorY
recordedEnvironment.startCursorY
Int32Nicht angegebenRegeln siehe Erklärung
Optionale vertikale Startposition des Mauszeigers bei der Aufnahme in Desktop-Pixeln.
virtualDesktopHeight
recordedEnvironment.virtualDesktopHeight
Int32Nicht angegebenRegeln siehe Erklärung
Gesamthöhe der aufgezeichneten Desktop-Anordnung in Pixeln.
virtualDesktopWidth
recordedEnvironment.virtualDesktopWidth
Int32Nicht angegebenRegeln siehe Erklärung
Gesamtbreite der aufgezeichneten Desktop-Anordnung in Pixeln. Abweichende Anordnungen können absolute Mauspositionen verändern.
virtualDesktopX
recordedEnvironment.virtualDesktopX
Int32Nicht angegebenRegeln siehe Erklärung
Linke Kante des gesamten virtuellen Desktops bei Aufnahme; sie kann bei Monitoren links vom Hauptmonitor negativ sein.
virtualDesktopY
recordedEnvironment.virtualDesktopY
Int32Nicht angegebenRegeln siehe Erklärung
Obere Kante des virtuellen Desktops bei Aufnahme; sie kann bei Monitoren oberhalb des Hauptmonitors negativ sein.
recordingSettings
recordingSettings
MakroRecordingSettingsNicht angegebenRegeln siehe Erklärung
Optionen für neue Makroaufnahmen. Änderungen an diesen Optionen wandeln vorhandene commands nicht automatisch in andere Bewegungstypen um.
automaticMovementGroups
recordingSettings.automaticMovementGroups
BooleantrueRegeln siehe Erklärung
Erzeugt bei der Aufnahme Gruppen für zusammengehörige Bewegungen. Befehlszeiten und Reihenfolge bleiben ausdrücklich gespeichert.
combineKeyboardInputs
recordingSettings.combineKeyboardInputs
BooleanfalseRegeln siehe Erklärung
Fasst geeignete aufgezeichnete Tastatureingaben zusammen, etwa zu Text-/Kombinationsbefehlen.
minimumDistancePixels
recordingSettings.minimumDistancePixels
Int320Regeln siehe Erklärung
Kleinste räumliche Distanz zwischen aufgezeichneten Bewegungsproben in Pixeln.
minimumIntervalUs
recordingSettings.minimumIntervalUs
Int321000Regeln siehe Erklärung
Kleinster zeitlicher Abstand aufgezeichneter Bewegungsproben in Mikrosekunden. Er beeinflusst Datenmenge und zeitliche Genauigkeit.
mode
recordingSettings.mode
MakroRecordingModeScreenAccurateAbsoluteRegeln siehe Erklärung
["ClicksOnly", "ScreenAccurateAbsolute", "MotionFaithfulRelative"]
Aufnahmemodus: 0=ClicksOnly, 1=ScreenAccurateAbsolute, 2=MotionFaithfulRelative. Im Makro-JSON wird dieser Enum als Zahl gespeichert; die Optionen ändern nur zukünftige Aufnahmen.
ClicksOnly
Aufnahmemodus 0: Klick-/Tastenaktionen statt einer vollständigen Bewegungsspur aufzeichnen.
ScreenAccurateAbsolute
Aufnahmemodus 1: Bildschirmpositionen als absolute Pixelkoordinaten aufzeichnen.
MotionFaithfulRelative
Aufnahmemodus 2: relative Mausbewegungen aufzeichnen.
recordingHotkeyModifiers
recordingSettings.recordingHotkeyModifiers
KeyModifiersNoneRegeln siehe Erklärung
["None", "Alt", "Control", "Shift", "Windows"]
Bitmaske der Aufnahme-Hotkey-Modifikatoren: Alt=1, Control=2, Shift=4, Windows=8, None=0.
None
Keine Modifikatortaste; numerische Bitmaske 0.
Alt
Alt-Modifikator; numerische Bitmaske 1.
Control
Strg-Modifikator; numerische Bitmaske 2.
Shift
Umschalt-Modifikator; numerische Bitmaske 4.
Windows
Windows-Taste als Modifikator (Bitmaske 8) beziehungsweise Windows-Fachbereich, wenn diese Option zu einem Log-Bereich gehört.
recordingHotkeyVirtualKey
recordingSettings.recordingHotkeyVirtualKey
UInt32120Regeln siehe Erklärung
Virtual-Key-Code der Aufnahme-Taste; Standard 120 entspricht F9. Prüfe Konflikte mit anderen Hotkeys.
recordKeyboard
recordingSettings.recordKeyboard
BooleantrueRegeln siehe Erklärung
Zeichnet Tastatureingaben für neue Makroaufnahmen auf. Vorhandene Tastenbefehle werden dadurch nicht entfernt.
recordMouseButtons
recordingSettings.recordMouseButtons
BooleantrueRegeln siehe Erklärung
Zeichnet Maustasten für neue Aufnahmen auf; reine Bewegungsaufzeichnung ist davon getrennt.
removeStopGesture
recordingSettings.removeStopGesture
BooleantrueRegeln siehe Erklärung
Entfernt die konfigurierte Stop-Geste aus der Aufnahme, damit sie später nicht als gewünschte Eingabe wiederholt wird.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag

JSON-Vorlage für Textdateien und Agenten

Strukturelle Defaultvorlage direkt vom App-Serializer. Leere Pflichtwerte und Ziele vor Verwendung ergänzen; diese Vorlage ist kein vollständig validierter Ablauf. Bei neuen Jobs den aktuellen inputs/localValues-Vertrag verwenden.

Dateiformate und Regeln · JSON herunterladen
{
  "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
}