Skip to main content

XProtect Smart Client

Smart Client Limba și limitele scriptului

Ultima actualizare: 6 minute de lectură
Versiune2026 R2
LimbăRomână

Smart Client script-urile folosesc un set limitat de C# în interiorul XML. Când XProtect Smart Client Dacă încarcă un fișier script, acesta verifică fișierul în raport cu o listă de funcții și acțiuni lingvistice permise. Dacă orice parte a scriptului este nevalidă, corpul scriptului și declanșatoarele de evenimente nu vor rula; cu toate acestea, <Login> Blocul este încă aplicat.

Structura fișierului

Salvați fișierul cu .scs extensie, codificată ca UTF-8. Se recomandă UTF-8 fără BOM.

Element

Obligatoriu

Descriere

<ScriptEngine>

Da

Element rădăcină.

<SchemaVersion>

Nu

Versiune în format de fișier. Versiunea implicită și cea curentă este 1. Dacă un fișier declară o versiune mai nouă decât versiunea instalată XProtect Smart Client acceptă, fișierul este refuzat.

<Login>

Nu

Informații de conectare. Vedeți Automatizați conectarea cu ajutorul scripturilor.

<Script>

Nu

Corpul scriptului. Rulează o dată per conectare.

<OnEvent Name="…">

Nu

Trigger de evenimente. Un fișier poate avea unul pentru fiecare eveniment.

Notă

Elemente moștenite, cum ar fi <ScriptExtension> și orice <ScriptLanguage> altele decât C# sunt refuzate de motorul de script.)

Caractere speciale

Citiri XML <, >,și & ca marcaj. Încadrați codul de script în <![CDATA[ … ]]>, care se recomandă, sau înlocuiți fiecare caracter cu entitatea sa XML:

Caracter

Entitate

<

&lt;

>

&gt;

&

&amp;

Limbă acceptată

Variabile

Detalii

Variabile

var, șiruri de caractere, numere întregi și valori booleene (ambele var și tipuri explicite, cum ar fi int sunt acceptate).

Condiții

if, else if, else

Bucle

for și foreach, cu break și continue. foreach Funcționează numai asupra acțiunilor care returnează o listă.

Operatori

+,-,*,/,+=,-=, Operatori de comparare,&&,\|\|, și postfix i++

Șiruri

Se recomandă ghilimele duble (ghilimelele simple sunt acceptate de motor, dar generează un avertisment și nu sunt C# valide). Alăturați-vă șirurilor cu +.

Comentarii

// și /* … */

Acțiuni

Tipul acțiunii

Sintaxă

Note

Acțiuni încorporate

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

Metode directe furnizate de Smart Client motor cu script (de exemplu, SCS.Application.Minimize();). Cele mai multe acțiuni iau argumente.

Grupurile disponibile sunt Application, Views, Browse, Camera, Ptz, MultiWindow, General,și Keyboard.

Vizualizări, ieșiri, evenimente și poziții presetate

SCS.Invoke("<name>");

The <name> Nu este numele afișat în IU. Începe cu Views.All., Outputs.All., Events.All.,sau Ptz.Presets., urmate de numele ierarhiei configurate unite prin puncte. Orice caracter, altul decât o literă sau o cifră alfanumerică, este convertit la un caracter de subliniere (_).

Exemplu: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Aceste nume sunt identice în toate limbile de afișare ale clientului. Dacă două elemente din același grup diferă doar prin caractere speciale (cum ar fi Cam 1 și Cam-1), ele generează același identificator și doar unul este accesibil; redenumiți unul dintre elemente pentru a rezolva coliziunea.

Comenzi pentru pluginuri MIP, după nume

SCS.Invoke("<name>");

The <name> Constă din numele de afișare pe care clientul le afișează pentru grupurile și acțiunile pluginului, unite prin puncte. Deoarece pluginul definește și poate localiza aceste nume, acest formular depinde de limba curentă a clientului. Dacă mai multe acțiuni au același nume, motorul de scriptare refuză numele; apelați acțiunea prin ID-ul său.

Acțiuni după ID

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

Identificator unic independent de limbă. Atât numele, cât și ID-urile sunt listate în fișierul de referință al scriptului generat atunci când este bifată Includere elemente de configurare, permițându-vă să copiați ID-ul exact direct în script.

Pentru a vedea toate acțiunile disponibile în sistemul dvs., generați o referință de script.

Funcții încorporate

Funcție

Descriere

Thread.Sleep(milliseconds)

Întrerupe scriptul fără a îngheța XProtect Smart Client. Acceptă 0–30.000 ms.

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

Afișează o notificare în zona de notificare. Nu blochează scriptul sau interfața utilizator.

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

Valori pentru dată și oră. Puteți citi .Year, .Month, .Day, .Hour, .Minute și .Second.

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

Operațiuni cu identificator unic. new Guid("<id as text>") Necesită exact un argument de tip șir.

SCS.Application.WriteLog(level, message)

Scriere către MIPLog.txt. Nivelul este Info, Debug,sau Error.

SCS.Application.GetEventWindowId()

Într-un activator de eveniment, returnează ID-ul ferestrei în care s-a întâmplat evenimentul. Returnează textul gol pentru fereastra principală, în corpul scriptului și în ConfigurationReloadCompleted.

Notă: Această funcție poate returna ID-ul unei ferestre încorporate (cum ar fi o zonă de vizualizare în interiorul unei file) care nu SCS.MultiWindow Acțiunea recunoaște. Comparați mai întâi ID-ul cu ID-urile ferestrei separate cunoscute sau ignorați ID-urile ferestrei nerecunoscute.

Declanșatoare de evenimente

Definiți <OnEvent> Blocuri în interiorul <ScriptEngine> Element rădăcină pentru a reacționa la acțiunile utilizatorului și la modificările spațiului de lucru.

Eveniment

Rulează

ConfigurationReloadCompleted

După fiecare reîncărcare finalizată a configurării, odată ce vizualizările și filele s-au stabilit. Nu rulează la prima conectare.

SelectedViewChanged

După ce este selectată o altă vizualizare, în orice fereastră.

SelectedViewItemChanged

După ce este selectat un alt element de vizualizare, în orice fereastră.

ShownWorkSpaceChanged

După ce fila selectată se schimbă sau o fereastră comută între Live și Redare.

Notă

Unele spații de lucru, cum ar fi Manager de alarme și Exporturi, conțin propriile zone de vizualizare încorporate. Fiecare zonă de vizualizare încorporată raportează crearea sa utilizând un ID care nu aparține unei ferestre separate. Prin urmare, trecerea la una dintre aceste file poate rula ShownWorkSpaceChanged de mai multe ori (de exemplu, Manager de alarmă are două zone de vizualizare încorporate și Exporturi are una, astfel încât trecerea la Manager de alarmă poate rula declanșatorul de până la trei ori). Scriptul trebuie să ignore ID-urile de fereastră nerecunoscute.

  • Trigggerele de evenimente sunt verificate împreună cu corpul scriptului. Un nume necunoscut de eveniment este o eroare.

  • Declanșatoarele de evenimente devin active înainte ca corpul scriptului să ruleze și să rămână activ până la deconectare.

  • Un activator de eveniment nu rulează din nou, din cauza unei modificări efectuate de propriile acțiuni.

  • Numele evenimentelor sunt sensibile la litere mari și mici.

  • Fiecare tip de eveniment poate fi declarat cel mult o dată într-un script.

  • Vizualizarea sau modificările de filă inițiate de corpul scriptului (<Script>) declanșează și aceste evenimente.

Limite

Limită

Valoare

Declarații per rulare

100,000

Timp de rulare per rulare

30 de secunde

Thread.Sleep per apel

30 de secunde

Rulează pe activator de eveniment

60 pe minut. Toate rulările din acel minut sunt omise.

Iterații per buclă

10,000

Lungime șir

65.536 caractere

Fiecare rulare a corpului scriptului sau a unui declanșator de eveniment are propriile limite. Dacă o rulare atinge o limită sau o acțiune eșuează, restul rulării se oprește și evenimentul este conectat MIPLog.txt, dar XProtect Smart Client și orice alte declanșatoare de evenimente continuă să ruleze. Când vă deconectați sau închideți XProtect Smart Client, se oprește orice script-uri care rulează.

Neacceptat

Neacceptat

Utilizați în schimb

while, do/while

for

switch

if / else if

try/catch, throw

Verificați scriptul… înainte de a implementa scriptul

Operator condițional (?:)

if / else

Incrementare prefix (++i)

Increment postfix (i++)

Interpolare șir ($"…")

+

Expresii virgulă, declarații multiple de variabile în for

Declarații separate

Matrice, literali de colecție și indexare

Neacceptat

%, *=, /=, %=, operatori pe biți

Neacceptat

Metode, clase, interfețe, spații de nume, dynamic

Plugin MIP

ScriptExtension

Folosiți comenzi de script încorporate sau un plugin MIP

Cronometre, Task, new Thread(), async, delegați, lambda

Thread.Sleep sau declanșatoare de evenimente

Fișier, registry, rețea și acces la proces, reflecție

Plugin MIP