Skip to main content

XProtect Smart Client

Smart Client Scripttaal en -limieten

Laatst bijgewerkt: 5 minuten lezen
Versie2026 R2
TaalNederlands

Smart Client Scripts gebruiken een beperkte set C# in XML. Wanneer XProtect Smart Client Als je een scriptbestand laadt, wordt het bestand gecontroleerd aan de hand van een lijst met toegestane taalfuncties en -acties. Als een gedeelte van het script ongeldig is, worden de hoofdtekst van het script en de gebeurtenisactiveringen niet uitgevoerd. De <Login> Het blok wordt nog steeds toegepast.

Bestandsstructuur

Sla het bestand op met de .scs extensie, gecodeerd als UTF-8. UTF-8 zonder BOM wordt aanbevolen.

Element

Vereist

Beschrijving

<ScriptEngine>

Ja

Root-element.

<SchemaVersion>

Nee

Versie van bestandsindeling. De standaard en huidige versie is 1. Als een bestand een nieuwere versie declareert dan de geïnstalleerde versie XProtect Smart Client Ondersteunt, wordt het bestand geweigerd.

<Login>

Nee

Aanmeldingsgegevens. Zie Automatisch aanmelden met scripts.

<Script>

Nee

Tekstvak. Draait één keer per aanmelding.

<OnEvent Name="…">

Nee

Gebeurtenisactivering. Een bestand kan één gebeurtenis per gebeurtenis bevatten.

Opmerking

Oude elementen zoals <ScriptExtension> en alle <ScriptLanguage> andere dan C# worden geweigerd door de scriptengine.)

Speciale tekens

XML leest <, >,en & Als markering. Script-code inpakken <![CDATA[ … ]]>, die wordt aanbevolen, of vervang elk teken door de XML-entiteit:

Karakter

Entiteit

<

&lt;

>

&gt;

&

&amp;

Ondersteunde taal

Variabelen

Details

Variabelen

var, strings, integers en Booleaanse waarden (beide var en expliciete typen zoals int worden ondersteund).

Voorwaarden

if, else if, else

Lussen

for en foreach, met break en continue. foreach Werkt alleen op acties die een lijst retourneren.

Gebruikers

+,-,*,/,+=,-=, Vergelijkingsoperatoren,&&,\|\|, en suffix i++

Strings

Dubbele aanhalingstekens worden aanbevolen (enkele aanhalingstekens worden geaccepteerd door de engine, maar genereren een waarschuwing en zijn niet geldig C#). Word lid met strings +.

Opmerkingen

// en /* … */

Acties

Type actie

Syntaxis

Aantekeningen

Ingebouwde acties

SCS.<Group>.<Action>(<arguments>);

Directe methoden die door de Smart Client Scriptengine (bijvoorbeeld SCS.Application.Minimize();). De meeste acties voeren argumenten aan.

De beschikbare groepen zijn Application, Views, Browse, Camera, Ptz, MultiWindow, General,en Keyboard.

Weergaven, uitvoer, gebeurtenissen en PTZ-voorkeurposities

SCS.Invoke("<name>");

De camera <name> Dit is niet de weergavenaam die in de gebruikersinterface wordt weergegeven. Het begint met Views.All., Outputs.All., Events.All.,of Ptz.Presets.gevolgd door de geconfigureerde hiërarchienamen, vergezeld door puntjes. Elk teken anders dan een alfanumerieke letter of cijfer wordt omgezet in een onderstrepingswaarde (_).

Voorbeeld: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Deze namen zijn identiek in alle weergavetalen van de client. Als twee items in dezelfde groep alleen verschillen door speciale tekens (zoals Cam 1 en Cam-1), genereren ze dezelfde ID en is er slechts één bereikbaar; hernoem een van de items om de botsing op te lossen.

MIP-plug-in acties, op naam

SCS.Invoke("<name>");

De camera <name> Bestaat uit de weergavenamen die de client weergeeft voor de groepen en acties van de plug-in, vergezeld door puntjes. Omdat de plug-in deze namen definieert en kan lokaliseren, is dit formulier afhankelijk van de huidige taal van de client. Als meerdere acties dezelfde naam hebben, weigert de scriptengine de naam; roep de actie in plaats daarvan op basis van de ID.

Acties op ID

SCS.Invoke("<action-id>");

Taal-onafhankelijke unieke ID. Beide namen en ID's worden vermeld in het gegenereerde scriptreferentiebestand wanneer Inclusief configuratie-items is gecontroleerd, zodat u de exacte ID rechtstreeks naar uw script kunt kopiëren.

Genereer een scriptreferentie om alle beschikbare acties op uw systeem te bekijken.

Ingebouwde functies

Functie

Beschrijving

Thread.Sleep(milliseconds)

Onderbreekt het script zonder te bevriezen XProtect Smart Client. Accepteert 0-30.000 ms.

MessageBox.Show(message), MessageBox.Show(message, caption)

Toont een melding in het meldingsgebied. Het blokkeert het script of de gebruikersinterface niet.

DateTime.Now, DateTime.Today, DateTime.Parse(), new DateTime(…)

Datum- en tijdwaarden. U kunt lezen .Year, .Month, .Day, .Hour, .Minute en .Second.

Guid.Empty, Guid.Parse(), new Guid("<id as text>")

Unieke identificatiebewerkingen. new Guid("<id as text>") Vereist precies één string argument.

SCS.Application.WriteLog(level, message)

Schrijven naar MIPLog.txt. Het niveau is Info, Debug,of Error.

SCS.Application.GetEventWindowId()

In een gebeurtenistrigger retourneert de ID van het venster waar de gebeurtenis heeft plaatsgevonden. Geeft lege tekst voor het hoofdvenster, de scripttekst en in ConfigurationReloadCompleted.

Opmerking: Deze functie kan de ID van een ingesloten venster (zoals een weergavegebied in een tabblad) retourneren zonder SCS.MultiWindow Actie herkent. Vergelijk de ID eerst met bekende zwevende venster-ID's of negeer niet-herkende venster-ID's.

Gebeurtenisactiveringen

Definiëren <OnEvent> Blokken binnen de <ScriptEngine> rootelement om te reageren op gebruikersacties en wijzigingen in de werkruimte.

Gebeurtenis

Draait

ConfigurationReloadCompleted

Na elke voltooide configuratie wordt de configuratie opnieuw geladen, zodra weergaven en tabbladen zijn opgelost. Wordt niet uitgevoerd bij de eerste aanmelding.

SelectedViewChanged

Nadat een andere weergave is geselecteerd, in een willekeurig venster.

SelectedViewItemChanged

Nadat een ander weergave-item is geselecteerd, wordt dit in een willekeurig venster weergegeven.

ShownWorkSpaceChanged

Nadat het geselecteerde tabblad is gewijzigd of een venster is geschakeld tussen Live en Afspelen.

Opmerking

Sommige werkruimten, zoals Alarmbeheer en Exports, bevatten hun eigen ingesloten weergavegebieden. Elk ingesloten weergavegebied meldt het maken ervan met een ID die niet bij een zwevend venster hoort. Overschakelen naar een van deze tabbladen kan daarom worden uitgevoerd ShownWorkSpaceChanged meerdere keren (Alarmbeheer heeft bijvoorbeeld twee ingesloten weergavegebieden en Exports heeft er één, dus overschakelen naar Alarmbeheer kan de activering tot drie keer uitvoeren). Je script moet niet-herkende venster-ID's negeren.

  • Gebeurtenisactiveringen worden samen met de scripttekst gecontroleerd. Een onbekende gebeurtenisnaam is een fout.

  • Gebeurtenisactiveringen worden actief voordat het script wordt uitgevoerd en blijven actief tot het afmelden.

  • Een gebeurtenistrigger wordt niet meer uitgevoerd vanwege een wijziging die door de eigen acties is aangebracht.

  • Gebeurtenisnamen zijn hoofdlettergevoelig.

  • Elk gebeurtenistype kan maximaal één keer in een script worden gedeclareerd.

  • Weergave- of tabbladwijzigingen die door de scripttekst zijn gestart (<Script>) ook deze gebeurtenissen activeren.

Limieten

Limiet

Waarde

Verklaringen per uitvoering

100,000

Uitvoeren om de tijd per uitvoering

30 seconden

Thread.Sleep per oproep

30 seconden

Draait per gebeurtenistrigger

60 per minuut. Alle runs in die minuut worden overgeslagen.

Iteraties per lus

10,000

Snaarlengte

65.536 tekens

Elke uitvoering van het script of een gebeurtenistrigger heeft zijn eigen grenzen. Als een uitvoering een limiet bereikt of een actie mislukt, stopt de rest van de uitvoering en wordt de gebeurtenis aangemeld MIPLog.txt, maar XProtect Smart Client en alle andere gebeurtenisactiveringen blijven actief. Wanneer u zich afmeldt of afsluit XProtect Smart Client, worden alle draaiende scripts gestopt.

Niet ondersteund

Niet ondersteund

In plaats daarvan gebruiken

while, do/while

for

switch

if / else if

try/catch, throw

Verifieer het script voordat u het implementeert

Voorwaardelijke gebruiker (?:)

if / else

Voorvoegsel increment (++i)

Verhoging van suffix (i++)

Snaarinterpolatie ($"…")

+

Komma-expressies, meerdere variabele declaraties in for

Aparte verklaringen

Arrays, letterlijke collecties en indexering

Niet ondersteund

%, *=, /=, %=, bitsgewijze gebruikers

Niet ondersteund

Methoden, klassen, interfaces, naamruimten, dynamic

MIP-plug-in

ScriptExtension

Ingebouwde scriptacties of een MIP-plug-in gebruiken

Timers, Task, new Thread(), async, afgevaardigden, lambda's

Thread.Sleep of gebeurtenisactiveringen

Toegang tot bestand, register, netwerk en proces, reflectie

MIP-plug-in