Smart Client Skriptsprache und -grenzen
Smart Client Ihre Skripte verwenden eine begrenzte Anzahl von C# innerhalb von XML. Wann XProtect Smart Client Wenn eine Skriptdatei geladen wird, wird die Datei mit einer Liste der zugelassenen Sprachfunktionen und -aktionen abgeglichen. Wenn ein Teil des Skripts ungültig ist, werden der Skriptkörper und die Ereignisauslöser nicht ausgeführt. Die <Login> Die Sperre wird weiterhin angewendet.
Dateistruktur
Speichern Sie die Datei mit dem .scs Erweiterung, codiert als UTF-8. UTF-8 ohne BOM wird empfohlen.
Element | Erforderlich | Beschreibung |
|---|---|---|
| Ja | Stammelement. |
| Nein | Version des Dateiformats. Die Standard- und aktuelle Version ist |
| Nein | Anmeldeinformationen. Siehe Automatisieren Sie die Anmeldung mit Skripten. |
| Nein | Skripttext. Läuft einmal pro Anmeldung. |
| Nein | Ereignis auslösen. Eine Datei kann eine pro Ereignis haben. |
Anmerkung
Ältere Elemente wie <ScriptExtension> und alle <ScriptLanguage> Andere als C# werden von der Skript-Engine abgelehnt.)
Sonderzeichen
XML-Lesevorgänge <, >, und & Als Markup. Skriptcode einschließen <![CDATA[ … ]]>, was empfohlen wird, oder ersetzen Sie jedes Zeichen durch seine XML-Entität:
Zeichen | Entität |
|---|---|
|
|
|
|
|
|
Unterstützte Sprache
Variablen | Details |
|---|---|
Variablen |
|
Bedingungen |
|
Schleifen |
|
Bediener |
|
Zeichenketten | Es werden doppelte Anführungszeichen empfohlen (einfache Anführungszeichen werden von der Engine akzeptiert, erzeugen jedoch eine Warnung und sind nicht gültig für C#). Verknüpfen Sie Zeichenfolgen mit |
Anmerkungen |
|
Aktionen
Aktionstyp | Syntax | Anmerkungen |
|---|---|---|
Integrierte Aktionen |
| Direkte Methoden zur Verfügung gestellt von Smart Client Skript-Engine (zum Beispiel Die verfügbaren Gruppen sind |
Ansichten, Ausgänge, Ereignisse und PTZ-Voreinstellungen |
| Das Feld Beispiel: Diese Namen sind in allen Client-Anzeigesprachen identisch. Wenn sich zwei Elemente in derselben Gruppe nur durch Sonderzeichen unterscheiden (z. B. Cam 1 und Cam-1), erzeugen sie denselben Bezeichner, und nur eines ist erreichbar. Benennen Sie eines der Elemente um, um die Kollision aufzulösen. |
MIP-Plugin-Aktionen, nach Namen |
| Das Feld |
Aktionen nach ID |
| Sprachunabhängige eindeutige Kennung. Sowohl Namen als auch IDs werden in der generierten Skriptreferenzdatei aufgeführt, wenn Konfigurationselemente einschließen aktiviert ist, sodass Sie die genaue ID direkt in Ihr Skript kopieren können. |
Generieren Sie eine Skriptreferenz, um alle in Ihrem System verfügbaren Aktionen anzuzeigen.
Integrierte Funktionen
Funktion | Beschreibung |
|---|---|
| Hält das Skript an, ohne es einzufrieren XProtect Smart Client. Akzeptiert 0–30.000 ms. |
| Zeigt eine Benachrichtigung im Benachrichtigungsbereich an. Es blockiert weder das Skript noch die Benutzeroberfläche. |
| Datums- und Uhrzeitwerte. Sie können lesen |
| Eindeutige Bezeichner-Operationen. |
| Schreibt in |
| Bei einem Ereignisauslöser wird die ID des Fensters zurückgegeben, in dem das Ereignis aufgetreten ist. Gibt einen leeren Text für das Hauptfenster, den Skripttext und die Hinweis: Diese Funktion kann die ID eines eingebetteten Fensters (z. B. eines Ansichtsbereichs in einer Registerkarte) zurückgeben, das keine |
Ereignisauslöser
Definieren Sie <OnEvent> Blöcke innerhalb der <ScriptEngine> Stammelement, um auf Benutzeraktionen und Änderungen am Arbeitsbereich zu reagieren.
Ereignis | Läuft |
|---|---|
| Nach jeder abgeschlossenen Konfiguration neu laden, sobald Ansichten und Registerkarten eingerichtet sind. Läuft nicht bei der ersten Anmeldung. |
| Wenn eine andere Ansicht ausgewählt wurde, klicken Sie in einem beliebigen Fenster auf. |
| Wenn ein anderes Ansichtselement ausgewählt wurde, klicken Sie in einem beliebigen Fenster auf. |
| Wenn sich die ausgewählte Registerkarte ändert oder ein Fenster zwischen Live und Wiedergabe wechselt. AnmerkungEinige Arbeitsbereiche, z. B. Alarm-Manager und Exporte, enthalten eigene eingebettete Ansichtsbereiche. Jeder eingebettete Ansichtsbereich meldet seine Erstellung anhand einer ID, die nicht zu einem beweglichen Fenster gehört. Daher kann der Wechsel zu einer dieser Registerkarten ausgeführt werden ShownWorkSpaceChanged mehrmals (z. B. der Alarm-Manager hat zwei eingebettete Ansichtsbereiche und die Exporte haben einen, sodass der Alarm-Manager den Trigger bis zu dreimal auslösen kann). Ihr Skript sollte nicht erkannte Fenster-IDs ignorieren. |
Ereignisauslöser werden zusammen mit dem Skripttext überprüft. Ein unbekannter Ereignisname ist ein Fehler.
Ereignisauslöser werden aktiv, bevor der Skripttext ausgeführt wird, und bleiben aktiv, bis Sie sich abmelden.
Ein Ereignisauslöser wird aufgrund einer durch seine eigenen Aktionen vorgenommenen Änderung nicht erneut ausgeführt.
Bei Ereignisnamen wird zwischen Groß- und Kleinschreibung unterschieden.
Jeder Ereignistyp kann höchstens einmal in einem Skript deklariert werden.
Ansicht- oder Registerkartenänderungen, die durch den Skripttext ausgelöst werden (
<Script>) lösen auch diese Ereignisse aus.
Grenzen
Begrenzen | Wert |
|---|---|
Anweisungen pro Durchlauf | 100,000 |
Laufzeit pro Durchlauf | 30 Sekunden |
| 30 Sekunden |
Durchläufe pro Ereignisauslöser | 60 pro Minute. Alle weiteren Durchläufe in dieser Minute werden übersprungen. |
Iterationen pro Schleife | 10,000 |
Zeichenfolgenlänge | 65.536 Zeichen |
Jeder Durchlauf des Skriptkörpers oder eines Ereignisauslösers hat seine eigenen Grenzen. Wenn ein Durchlauf ein Limit erreicht oder eine Aktion fehlschlägt, wird der Rest dieses Durchlaufs gestoppt und das Ereignis protokolliert MIPLog.txt, aber XProtect Smart Client und alle anderen Ereignisauslöser laufen weiter. Wenn Sie sich abmelden oder schließen XProtect Smart Client, werden alle laufenden Skripte gestoppt.
Nicht unterstützt | Verwenden Sie stattdessen |
|---|---|
|
|
|
|
| Überprüfen Sie das Skript... bevor Sie es bereitstellen |
Bedingter Operator ( |
|
Präfix-Inkrement | Postfix-Inkrement |
String-Interpolation |
|
Kommaausdrücke, mehrere Variablendeklarationen in | Separate Anweisungen |
Arrays, Auflistungsliterale und Indizierung | Nicht unterstützt |
| Nicht unterstützt |
Methoden, Klassen, Schnittstellen, Namespaces, | MIP-Plugin |
| Verwenden Sie integrierte Skriptaktionen oder ein MIP-Plugin |
Timer, |
|
Datei-, Registrierungs-, Netzwerk- und Prozesszugriff, Reflexion | MIP-Plugin |