Vorschau · Entwicklungsstand 1.6.1

DesktopDuplicationResult

Wofür ist das gedacht?

Typisierter Ergebnisvertrag DesktopDuplicationResult. Wird von Bildschirm aufnehmen geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.

DesktopDuplicationResult verstehen

1
Zweck
Typisierter Ergebnisvertrag DesktopDuplicationResult. Wird von Bildschirm aufnehmen geliefert. Die stabilen Ergebnis-IDs unten sind unabhängig von CLR-Namen und UI-Übersetzungen. Wähle im Ergebnis-Auswahldialog eine kompatible Eigenschaft statt das ganze Objekt ungeprüft als Text zu verwenden.
2
Beispiel
Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.
3
Hinweise
Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.

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

Ergebniswerte verwenden

Ergebnis	Bedeutung
Image	Laufzeit-Bildobjekt für Bildverbraucher. Es wird nicht als Bitmap-Payload in der Jobdatei gespeichert. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
Bounds	Ermitteltes Rechteck im Koordinatenraum des entsprechenden Ergebnisobjekts. Einzelwert dieses Ergebnisses.
Bounds / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Bounds / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Bounds / Width	Breite des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / Height	Höhe des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / Left	Linke Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / Top	Obere Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / Right	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Einzelwert dieses Ergebnisses.
Bounds / Bottom	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Einzelwert dieses Ergebnisses.
Bounds / Is Empty	Ob die Zwischenablage im abgefragten Kontext leer ist. Einzelwert dieses Ergebnisses.
Bounds / Location	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Einzelwert dieses Ergebnisses.
Bounds / Location / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Bounds / Location / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Bounds / Center	Mittelpunkt einer einzelnen Erkennung in Pixeln. Einzelwert dieses Ergebnisses.
Bounds / Center / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Bounds / Center / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Offset	Pixelversatz der Bildquelle gegenüber dem globalen Desktop. Bei bildlokalen Punkten addieren, bevor sie global verwendet werden. Einzelwert dieses Ergebnisses.
Offset / X	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
Offset / Y	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
Is Fresh	Ob die Aufnahme einen frischen Frame statt einer zwischengespeicherten Aufnahme geliefert hat. Einzelwert dieses Ergebnisses.
Capture Timestamp Utc	UTC-Zeitpunkt des erfassten Bildes; bei wiederverwendeten Frames bleibt der ursprüngliche Zeitpunkt erhalten. Einzelwert dieses Ergebnisses.
Frame Version	Laufzeit-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 Timestamp	Monotoner Stopwatch/QPC-Zeitstempel des Frames. 0 bedeutet unbekannt; dies ist kein Datum in Millisekunden seit 1970. Einzelwert dieses Ergebnisses.
Has Image	Ob die Zwischenablage ein Bild enthält. Daraus folgt nicht automatisch, dass ein Bild als persistierbares JSON-Literal vorliegt. Einzelwert dieses Ergebnisses.

Beispiel

Eine Ergebnisreferenz verwendet provider_id=step_result und source_id=v1/<kodierte-Step-ID>/<kodierte-Ergebnis-ID>. Die Anleitung „Werte verbinden“ zeigt eine vollständige Verbindung. Prüfe Typ und Kardinalität vor der Verwendung in einer Bedingung oder Folgeaktion.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Ein konfigurierte Quelle hat noch nicht zwingend einen Wert geliefert. Prüfe den fachlichen Erfolgswert, fehlende optionale Eigenschaften und den Ausführungszustand des Produzenten. Nur DynamicRoi besitzt die dokumentierte Ausnahme für späteres Feedback; andere Verbraucher dürfen keine beliebigen Vorwärtsreferenzen verwenden.

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

Felder und Zusammenhänge auf einen Blick

1
ImageErgebnis: image · Wert
Laufzeit-Bildobjekt für Bildverbraucher
2
BoundsErgebnis: bounds · Wert
Ermitteltes Rechteck im Koordinatenraum des entsprechenden Ergebnisobjekts
3
Bounds / XErgebnis: bounds.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
4
Bounds / YErgebnis: bounds.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
5
Bounds / WidthErgebnis: bounds.width · Wert
Breite des Ergebnisrechtecks in Pixeln
6
Bounds / HeightErgebnis: bounds.height · Wert
Höhe des Ergebnisrechtecks in Pixeln
7
Bounds / LeftErgebnis: bounds.left · Wert
Linke Rechteckkante in Pixeln
8
Bounds / TopErgebnis: bounds.top · Wert
Obere Rechteckkante in Pixeln
9
Bounds / RightErgebnis: bounds.right · Wert
Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet
10
Bounds / BottomErgebnis: bounds.bottom · Wert
Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet
11
Bounds / Is EmptyErgebnis: bounds.is_empty · Wert
Ob die Zwischenablage im abgefragten Kontext leer ist
12
Bounds / LocationErgebnis: bounds.location · Wert
Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum
13
Bounds / Location / XErgebnis: bounds.location.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
14
Bounds / Location / YErgebnis: bounds.location.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
15
Bounds / CenterErgebnis: bounds.center · Wert
Mittelpunkt einer einzelnen Erkennung in Pixeln
16
Bounds / Center / XErgebnis: bounds.center.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
17
Bounds / Center / YErgebnis: bounds.center.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
18
OffsetErgebnis: offset · Wert
Pixelversatz der Bildquelle gegenüber dem globalen Desktop
19
Offset / XErgebnis: offset.x · Wert
Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten
20
Offset / YErgebnis: offset.y · Wert
Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen
21
Is FreshErgebnis: is_fresh · Wert
Ob die Aufnahme einen frischen Frame statt einer zwischengespeicherten Aufnahme geliefert hat
22
Capture Timestamp UtcErgebnis: capture_timestamp_utc · Wert
UTC-Zeitpunkt des erfassten Bildes; bei wiederverwendeten Frames bleibt der ursprüngliche Zeitpunkt erhalten
23
Frame VersionErgebnis: frame_version · Wert
Laufzeit-Identität des Frames innerhalb seines Aufnahmeproduzenten
24
Frame TimestampErgebnis: frame_timestamp · Wert
Monotoner Stopwatch/QPC-Zeitstempel des Frames
25
Has ImageErgebnis: has_image · Wert
Ob die Zwischenablage ein Bild enthält

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

Ergebnisvertrag

Ergebnis	Typ / Optionen	Anzahl	Erklärung
`image`	`Image`	`OptionalSingle`	Laufzeit-Bildobjekt für Bildverbraucher. Es wird nicht als Bitmap-Payload in der Jobdatei gespeichert. Optionaler Einzelwert: bei fehlender Information keine Eigenschaft erfinden.
`bounds`	`Rectangle`	`Single`	Ermitteltes Rechteck im Koordinatenraum des entsprechenden Ergebnisobjekts. Einzelwert dieses Ergebnisses.
`bounds.x`	`Integer`	`Single`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
`bounds.y`	`Integer`	`Single`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
`bounds.width`	`Integer`	`Single`	Breite des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
`bounds.height`	`Integer`	`Single`	Höhe des Ergebnisrechtecks in Pixeln. Einzelwert dieses Ergebnisses.
`bounds.left`	`Integer`	`Single`	Linke Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
`bounds.top`	`Integer`	`Single`	Obere Rechteckkante in Pixeln. Einzelwert dieses Ergebnisses.
`bounds.right`	`Integer`	`Single`	Rechte Rechteckkante in Pixeln, aus Ursprung und Breite abgeleitet. Einzelwert dieses Ergebnisses.
`bounds.bottom`	`Integer`	`Single`	Untere Rechteckkante in Pixeln, aus Ursprung und Höhe abgeleitet. Einzelwert dieses Ergebnisses.
`bounds.is_empty`	`Boolean`	`Single`	Ob die Zwischenablage im abgefragten Kontext leer ist. Einzelwert dieses Ergebnisses.
`bounds.location`	`Point`	`Single`	Pixelposition/-bereich eines erkannten Wortes oder Trefferobjekts; verwende den im Ergebnis ausgewiesenen Koordinatenraum. Einzelwert dieses Ergebnisses.
`bounds.location.x`	`Integer`	`Single`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
`bounds.location.y`	`Integer`	`Single`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
`bounds.center`	`Point`	`Single`	Mittelpunkt einer einzelnen Erkennung in Pixeln. Einzelwert dieses Ergebnisses.
`bounds.center.x`	`Integer`	`Single`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
`bounds.center.y`	`Integer`	`Single`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
`offset`	`Point`	`Single`	Pixelversatz der Bildquelle gegenüber dem globalen Desktop. Bei bildlokalen Punkten addieren, bevor sie global verwendet werden. Einzelwert dieses Ergebnisses.
`offset.x`	`Integer`	`Single`	Horizontale Punkt-/Versatzkoordinate in Pixeln; den im übergeordneten Ergebnis beschriebenen Koordinatenraum beachten. Einzelwert dieses Ergebnisses.
`offset.y`	`Integer`	`Single`	Vertikale Punkt-/Versatzkoordinate in Pixeln; nicht ungeprüft bildlokale und globale Werte mischen. Einzelwert dieses Ergebnisses.
`is_fresh`	`Boolean`	`Single`	Ob die Aufnahme einen frischen Frame statt einer zwischengespeicherten Aufnahme geliefert hat. Einzelwert dieses Ergebnisses.
`capture_timestamp_utc`	`DateTime`	`Single`	UTC-Zeitpunkt des erfassten Bildes; bei wiederverwendeten Frames bleibt der ursprüngliche Zeitpunkt erhalten. Einzelwert dieses Ergebnisses.
`frame_version`	`Integer`	`Single`	Laufzeit-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_timestamp`	`Integer`	`Single`	Monotoner Stopwatch/QPC-Zeitstempel des Frames. 0 bedeutet unbekannt; dies ist kein Datum in Millisekunden seit 1970. Einzelwert dieses Ergebnisses.
`has_image`	`Boolean`	`Single`	Ob 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