Vorschau · Entwicklungsstand 1.6.1

Bildschirm aufnehmen

Bildschirm aufnehmenDetailansicht: Bildschirm aufnehmen. Markierte Beschriftungen zeigen die Einstellungen im Editor. Die Abbildung zeigt eine Beispielkonfiguration, keine ausgeführte Aktion. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.
Detailansicht: Bildschirm aufnehmen. Markierte Beschriftungen zeigen die Einstellungen im Editor. Die Abbildung zeigt eine Beispielkonfiguration, keine ausgeführte Aktion. Zusammengestellte Ausschnitte echter Einstellungsfelder mit Beispielwerten; die Nummer markiert Beschriftung und Eingabe gemeinsam.
  1. 1
    Monitor

    Nullbasierter Monitorindex der Bildschirmaufnahme. Auf einem anderen Rechner kann die Monitorreihenfolge abweichen.

  2. 2
    Mauszeiger aufnehmen

    Nimmt den Mauszeiger in die Bildschirmaufnahme auf. Für Bildvergleiche kann der Zeiger störende zusätzliche Pixel verursachen.

  3. 3
    Auf neues Bild warten

    Wartet auf einen neuen Desktop-Frame statt sofort den zuletzt verfügbaren Frame zu übernehmen.

  4. 4
    Zeitlimit (ms)

    Zeitlimit in Millisekunden für den betreffenden Vorgang. Das jeweilige Fehler-/Skip-Verhalten steht im Step-Text; es ist keine allgemeine Job-Gesamtdauer.

  5. 5
    Bei Zeitlimit letztes Bild verwenden

    Erlaubt nach Ablauf des Aufnahmezeitlimits den zuletzt verfügbaren Frame. Prüfe dessen is_fresh, bevor eine zeitkritische Folgeaktion ausgeführt wird.

  6. 6
    Monitor-Kennung

    Optional gespeicherte Monitor-Gerätekennung zur Wiedererkennung des gewünschten Bildschirms. Bei Umbau der Monitoranordnung prüfen.

Editor-Ausschnitt mit Markierungen · Lightmode · Beispieldaten · Bild anklicken zum Vergrößern. Die Ansichten erklären die Bedienung; noch nicht gewählte Quellen, Geräte oder Modelle müssen für einen ausführbaren Job ergänzt werden.

Wofür ist das gedacht?

Wähle einen Monitor als Bildquelle. Optional wartet die Aufnahme auf ein neues Desktop-Bild; beim Zeitlimit kannst du den letzten verfügbaren Frame zulassen. Prüfe is_fresh und frame_timestamp, wenn eine spätere Mausaktion nur auf neue Bilder reagieren soll.

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
MonitorNullbasierter Monitorindex der Bildschirmaufnahme. Auf einem anderen Rechner kann die Monitorreihenfolge abweichen.

Zulässiger Bereich: ab 0.

0
Mauszeiger aufnehmenNimmt den Mauszeiger in die Bildschirmaufnahme auf. Für Bildvergleiche kann der Zeiger störende zusätzliche Pixel verursachen.Aus (Häkchen entfernt)
Auf neues Bild wartenWartet auf einen neuen Desktop-Frame statt sofort den zuletzt verfügbaren Frame zu übernehmen.An (Häkchen gesetzt)
Zeitlimit (ms)Zeitlimit in Millisekunden für den betreffenden Vorgang. Das jeweilige Fehler-/Skip-Verhalten steht im Step-Text; es ist keine allgemeine Job-Gesamtdauer.

Zulässiger Bereich: ab 1 bis 60000.

250
Bei Zeitlimit letztes Bild verwendenErlaubt nach Ablauf des Aufnahmezeitlimits den zuletzt verfügbaren Frame. Prüfe dessen is_fresh, bevor eine zeitkritische Folgeaktion ausgeführt wird.

Im Bereich „Erweitert“ verfügbar.

An (Häkchen gesetzt)
Monitor-KennungOptional gespeicherte Monitor-Gerätekennung zur Wiedererkennung des gewünschten Bildschirms. Bei Umbau der Monitoranordnung prüfen.

Im Bereich „Erweitert“ verfügbar.

Beispieltext

Ergebniswerte verwenden

ErgebnisBedeutung
ImageLaufzeit-Bildobjekt für Bildverbraucher. Es wird nicht als Bitmap-Payload in der Jobdatei gespeichert. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
BoundsErmitteltes Rechteck im Koordinatenraum des entsprechenden Ergebnisobjekts. Einzelwert dieses Ergebnisses.
Bounds / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Bounds / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Bounds / WidthBreite des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / HeightHöhe des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / LeftLinke Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / TopObere Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / RightRechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Einzelwert dieses Ergebnisses.
Bounds / BottomUntere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Einzelwert dieses Ergebnisses.
Bounds / Is EmptyOb die Zwischenablage im abgefragten Kontext leer ist. Einzelwert dieses Ergebnisses.
Bounds / LocationPixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Einzelwert dieses Ergebnisses.
Bounds / Location / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Bounds / Location / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Bounds / CenterMittelpunkt einer einzelnen Erkennung in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / Center / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Bounds / Center / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
OffsetPixelversatz der Bildquelle gegenüber dem globalen Desktop. Bei bildlokalen Punkten addieren, bevor sie global verwendet werden. Einzelwert dieses Ergebnisses.
Offset / XHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Offset / YVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Is FreshOb die Aufnahme einen frischen Frame statt einer zwischengespeicherten Aufnahme geliefert hat. Einzelwert dieses Ergebnisses.
Capture Timestamp UtcUTC-Zeitpunkt des erfassten Bildes; bei wiederverwendeten Frames bleibt der ursprüngliche Zeitpunkt erhalten. Einzelwert dieses Ergebnisses.
Frame VersionLaufzeit-Identität des Frames innerhalb seines Aufnahmeproduzenten. Cache-/Zeigeraktualisierungen sind keine neuen Desktop-Bildversionen; nicht zwischen unabhängigen Kameras/Monitorquellen vergleichen. Einzelwert dieses Ergebnisses.
Frame TimestampMonotoner Stopwatch/QPC-Zeitstempel des Frames. 0 bedeutet unbekannt; dies ist kein Datum in Millisekunden seit 1970. Einzelwert dieses Ergebnisses.
Has ImageOb die Zwischenablage ein Bild enthält. Daraus folgt nicht automatisch, dass ein Bild als persistierbares JSON-Literal vorliegt. Einzelwert dieses Ergebnisses.

Beispiel

Monitor 0 aufnehmen → Bild speichern. Bei zeitkritischer Erkennung auf ein neues Bild warten und den Rückfall auf Cache deaktivieren.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Prüfe die in dieser Referenz beschriebenen aktiven Pflichtfelder, kompatible Wertequellen und die Voraussetzungen auf dem Zielrechner. Ungültige Quellen oder Typen sind Fehler; eine gültige, aber nicht verfügbare optionale Quelle kann gemäß Eingabevertrag zum Überspringen führen. Ein Fehler beendet die Start-/Hauptphase; die vorgesehene Endphase wird zum Aufräumen behandelt. Der Verlauf zeigt den tatsächlich belegten Status.

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: desktop_duplication

Felder und Zusammenhänge auf einen Blick
  1. 1
    Monitordesktop_idx · Integer · 0

    Nullbasierter Monitorindex der Bildschirmaufnahme

  2. 2
    Mauszeiger aufnehmencapture_cursor · Boolean · false

    Nimmt den Mauszeiger in die Bildschirmaufnahme auf

  3. 3
    Auf neues Bild wartenwait_for_new_frame · Boolean · true

    Wartet auf einen neuen Desktop-Frame statt sofort den zuletzt verfügbaren Frame zu übernehmen.

  4. 4
    Zeitlimit (ms)timeout_ms · Integer · 250

    Zeitlimit in Millisekunden für den betreffenden Vorgang

  5. 5
    Bei Zeitlimit letztes Bild verwendenallow_cached_fallback · Boolean · true

    Erlaubt nach Ablauf des Aufnahmezeitlimits den zuletzt verfügbaren Frame

  6. 6
    Monitor-Kennungmonitor_device_name · Text · Leerer Text

    Optional gespeicherte Monitor-Gerätekennung zur Wiedererkennung des gewünschten Bildschirms

  7. 7
    ImageErgebnis: image · Wert

    Laufzeit-Bildobjekt für Bildverbraucher

  8. 8
    BoundsErgebnis: bounds · Wert

    Ermitteltes Rechteck im Koordinatenraum des entsprechenden Ergebnisobjekts

  9. 9
    Bounds / XErgebnis: bounds.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  10. 10
    Bounds / YErgebnis: bounds.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  11. 11
    Bounds / WidthErgebnis: bounds.width · Wert

    Breite des Ergebnisrechtecks in Pixeln

  12. 12
    Bounds / HeightErgebnis: bounds.height · Wert

    Höhe des Ergebnisrechtecks in Pixeln

  13. 13
    Bounds / LeftErgebnis: bounds.left · Wert

    Linke Rechteckkante in Pixeln

  14. 14
    Bounds / TopErgebnis: bounds.top · Wert

    Obere Rechteckkante in Pixeln

  15. 15
    Bounds / RightErgebnis: bounds.right · Wert

    Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet

  16. 16
    Bounds / BottomErgebnis: bounds.bottom · Wert

    Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet

  17. 17
    Bounds / Is EmptyErgebnis: bounds.is_empty · Wert

    Ob die Zwischenablage im abgefragten Kontext leer ist

  18. 18
    Bounds / LocationErgebnis: bounds.location · Wert

    Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum

  19. 19
    Bounds / Location / XErgebnis: bounds.location.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  20. 20
    Bounds / Location / YErgebnis: bounds.location.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  21. 21
    Bounds / CenterErgebnis: bounds.center · Wert

    Mittelpunkt einer einzelnen Erkennung in Pixeln

  22. 22
    Bounds / Center / XErgebnis: bounds.center.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  23. 23
    Bounds / Center / YErgebnis: bounds.center.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  24. 24
    OffsetErgebnis: offset · Wert

    Pixelversatz der Bildquelle gegenüber dem globalen Desktop

  25. 25
    Offset / XErgebnis: offset.x · Wert

    Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten

  26. 26
    Offset / YErgebnis: offset.y · Wert

    Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen

  27. 27
    Is FreshErgebnis: is_fresh · Wert

    Ob die Aufnahme einen frischen Frame statt einer zwischengespeicherten Aufnahme geliefert hat

  28. 28
    Capture Timestamp UtcErgebnis: capture_timestamp_utc · Wert

    UTC-Zeitpunkt des erfassten Bildes; bei wiederverwendeten Frames bleibt der ursprüngliche Zeitpunkt erhalten

  29. 29
    Frame VersionErgebnis: frame_version · Wert

    Laufzeit-Identität des Frames innerhalb seines Aufnahmeproduzenten

  30. 30
    Frame TimestampErgebnis: frame_timestamp · Wert

    Monotoner Stopwatch/QPC-Zeitstempel des Frames

  31. 31
    Has ImageErgebnis: has_image · Wert

    Ob die Zwischenablage ein Bild enthält

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

Feldtypen, Standards und Regeln

WertTypStandard laut VertragOptionen und RegelnErklärung
Monitor
desktop_idx
Integer0Pflichtfeld

Grenzen: {"Minimum": 0}
Nullbasierter Monitorindex der Bildschirmaufnahme. Auf einem anderen Rechner kann die Monitorreihenfolge abweichen.
Mauszeiger aufnehmen
capture_cursor
BooleanfalseRegeln siehe Erklärung
Nimmt den Mauszeiger in die Bildschirmaufnahme auf. Für Bildvergleiche kann der Zeiger störende zusätzliche Pixel verursachen.
Auf neues Bild warten
wait_for_new_frame
BooleantrueRegeln siehe Erklärung
Wartet auf einen neuen Desktop-Frame statt sofort den zuletzt verfügbaren Frame zu übernehmen.
Zeitlimit (ms)
timeout_ms
Integer250Pflichtfeld

Grenzen: {"Minimum": 1, "Maximum": 60000}
Zeitlimit in Millisekunden für den betreffenden Vorgang. Das jeweilige Fehler-/Skip-Verhalten steht im Step-Text; es ist keine allgemeine Job-Gesamtdauer.
Bei Zeitlimit letztes Bild verwenden
allow_cached_fallback
BooleantrueRegeln siehe Erklärung
Erlaubt nach Ablauf des Aufnahmezeitlimits den zuletzt verfügbaren Frame. Prüfe dessen is_fresh, bevor eine zeitkritische Folgeaktion ausgeführt wird.
Monitor-Kennung
monitor_device_name
TextLeerer TextRegeln siehe Erklärung
Optional gespeicherte Monitor-Gerätekennung zur Wiedererkennung des gewünschten Bildschirms. Bei Umbau der Monitoranordnung prüfen.

JSON-Felder und verschachtelte Einstellungen

Technische Feldnamen des Modells. Die Einstellungsfelder oben beschreiben die UI; die JSON-Vorlage zeigt die tatsächliche Schreibweise. Bei aktuellen inputs/localValues stammen aktive Werte aus den Referenzen. Die Modell-Standardwerte und Enum-Namen sind keine universelle JSON-Schreibweise.

FeldModelltypModell-Standard / OptionenErklärung
idStringNicht angegebenStabile 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.
inputsDictionary`2Nicht angegebenZuordnung von UI-Feld-ID zu typisierter Wertequelle. Bei vorhandenen inputs serialisiert der kanonische Job-Serializer settings nicht zusätzlich. Leere inputs mit settings bleiben als Legacy-/direkte Konfiguration lesbar.
inputs.itemsList`1Nicht angegebenGeordnete Unterbindungen einer Liste. Die Reihenfolge ist Teil der Eingabe; Elemente müssen das Listenelement-Schema erfüllen.
inputs.property_idStringNicht angegebenStabile Ergebnis-ID einer älteren Step-Referenz. Neue Dateien kodieren sie in source_id; nicht mit einem CLR-Propertynamen oder dem UI-Label verwechseln.
inputs.property_pathStringNicht angegebenÄlterer Pfad zu einem Ergebnis-Unterwert. Bestehende Dateien bleiben lesbar; neue Referenzen verwenden stabile Ergebnis-IDs und gegebenenfalls value_path.
inputs.source_step_idStringNicht angegebenKompatibilitätsfeld älterer Referenzen. Neue Referenzen verwenden provider_id=step_result und die versionierte source_id.
inputs.membersDictionary`2Nicht angegebenBenannte Unterbindungen eines strukturierten Werts. Jeder Schlüssel ist eine stabile Mitglied-ID des Feldschemas; Unterbindungen können Werte einer Basisquelle gezielt überschreiben.
inputs.provider_idStringNicht angegebenAnbieter der Wertequelle: local_value, job_variable, step_result oder secret. Ein Quellwert benötigt zusätzlich source_id und muss zum Eingabetyp passen.
inputs.schema_idStringNicht angegebenVersionierte Form eines zusammengesetzten Eingabewerts. Sie gehört zum Bindungsbaum, nicht als frei erfundener Schlüssel in die Variable. Übernimm die für dieses Feld exportierte Schema-ID.
inputs.source_idStringNicht angegebenAnbieterbezogene Identität. Bei step_result: v1/<URI-kodierte-Step-ID>/<URI-kodierte-stabile-Ergebnis-ID>; bei lokalen Werten und Jobvariablen deren GUID. Dies ist nicht nur die rohe Step-ID.
inputs.value_pathStringNicht angegebenOptionaler Pfad unterhalb einer Anbieterquelle, zum Beispiel zu einem typisierten Objektmitglied. Er ändert den Quellanbieter nicht; der ausgewählte Unterwert muss kompatibel sein.
is_enabledBooleantruetrue führt den Step aus; false deaktiviert ihn. Blockmarker können in der UI nicht beliebig deaktiviert werden, weil ihre Struktur erhalten bleiben muss.
settingsDesktopDuplicationSettingsNicht angegebenDirekte beziehungsweise ältere Step-Konfiguration. Für neue referenzbasierte Dateien inputs und localValues verwenden; die UI migriert gespeicherte Literalwerte in lokale Quellen.
settings.allow_cached_fallbackBooleantrueErlaubt nach Ablauf des Aufnahmezeitlimits den zuletzt verfügbaren Frame. Prüfe dessen is_fresh, bevor eine zeitkritische Folgeaktion ausgeführt wird.
settings.capture_cursorBooleanfalseNimmt den Mauszeiger in die Bildschirmaufnahme auf. Für Bildvergleiche kann der Zeiger störende zusätzliche Pixel verursachen.
settings.desktop_idxInt320Nullbasierter Monitorindex der Bildschirmaufnahme. Auf einem anderen Rechner kann die Monitorreihenfolge abweichen.
settings.monitor_device_nameStringLeerer TextOptional gespeicherte Monitor-Gerätekennung zur Wiedererkennung des gewünschten Bildschirms. Bei Umbau der Monitoranordnung prüfen.
settings.timeout_msInt32250Zeitlimit in Millisekunden für den betreffenden Vorgang. Das jeweilige Fehler-/Skip-Verhalten steht im Step-Text; es ist keine allgemeine Job-Gesamtdauer.
settings.wait_for_new_frameBooleantrueWartet auf einen neuen Desktop-Frame statt sofort den zuletzt verfügbaren Frame zu übernehmen.

Ergebnisvertrag

ErgebnisTyp / OptionenAnzahlErklärung
imageImageOptionalSingleLaufzeit-Bildobjekt für Bildverbraucher. Es wird nicht als Bitmap-Payload in der Jobdatei gespeichert. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
boundsRectangleSingleErmitteltes Rechteck im Koordinatenraum des entsprechenden Ergebnisobjekts. Einzelwert dieses Ergebnisses.
bounds.xIntegerSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
bounds.yIntegerSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
bounds.widthIntegerSingleBreite des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
bounds.heightIntegerSingleHöhe des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
bounds.leftIntegerSingleLinke Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
bounds.topIntegerSingleObere Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
bounds.rightIntegerSingleRechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Einzelwert dieses Ergebnisses.
bounds.bottomIntegerSingleUntere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Einzelwert dieses Ergebnisses.
bounds.is_emptyBooleanSingleOb die Zwischenablage im abgefragten Kontext leer ist. Einzelwert dieses Ergebnisses.
bounds.locationPointSinglePixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Einzelwert dieses Ergebnisses.
bounds.location.xIntegerSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
bounds.location.yIntegerSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
bounds.centerPointSingleMittelpunkt einer einzelnen Erkennung in Pixeln. Einzelwert dieses Ergebnisses.
bounds.center.xIntegerSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
bounds.center.yIntegerSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
offsetPointSinglePixelversatz der Bildquelle gegenüber dem globalen Desktop. Bei bildlokalen Punkten addieren, bevor sie global verwendet werden. Einzelwert dieses Ergebnisses.
offset.xIntegerSingleHorizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
offset.yIntegerSingleVertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
is_freshBooleanSingleOb die Aufnahme einen frischen Frame statt einer zwischengespeicherten Aufnahme geliefert hat. Einzelwert dieses Ergebnisses.
capture_timestamp_utcDateTimeSingleUTC-Zeitpunkt des erfassten Bildes; bei wiederverwendeten Frames bleibt der ursprüngliche Zeitpunkt erhalten. Einzelwert dieses Ergebnisses.
frame_versionIntegerSingleLaufzeit-Identität des Frames innerhalb seines Aufnahmeproduzenten. Cache-/Zeigeraktualisierungen sind keine neuen Desktop-Bildversionen; nicht zwischen unabhängigen Kameras/Monitorquellen vergleichen. Einzelwert dieses Ergebnisses.
frame_timestampIntegerSingleMonotoner Stopwatch/QPC-Zeitstempel des Frames. 0 bedeutet unbekannt; dies ist kein Datum in Millisekunden seit 1970. Einzelwert dieses Ergebnisses.
has_imageBooleanSingleOb die Zwischenablage ein Bild enthält. Daraus folgt nicht automatisch, dass ein Bild als persistierbares JSON-Literal vorliegt. Einzelwert dieses Ergebnisses.

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
{
  "type": "desktop_duplication",
  "settings": {
    "desktop_idx": 0,
    "capture_cursor": false,
    "monitor_device_name": "",
    "wait_for_new_frame": true,
    "timeout_ms": 250,
    "allow_cached_fallback": true
  },
  "id": "ffa47583-1458-1a09-c1e7-2592222fbe7b",
  "inputs": {},
  "is_enabled": true
}