Skip to main content

XProtect Smart Client

Smart Client Linguaggio e limiti dello script

Ultimo aggiornamento: 6 min di lettura
Versione2026 R2
LinguaItaliano

Smart Client Gli script utilizzano un set limitato di C# all'interno di XML. Quando XProtect Smart Client Carica un file di script e lo confronta con un elenco di funzioni e azioni linguistiche consentite. Se una parte qualsiasi dello script non è valida, il corpo dello script e i trigger di eventi non verranno eseguiti; tuttavia, <Login> Il blocco è ancora applicato.

Struttura del file

Salva il file con .scs estensione, codificata come UTF-8. Si consiglia di utilizzare UTF-8 senza DBA.

Elemento

Richiesto

Descrizione

<ScriptEngine>

Sì

Elemento radice.

<SchemaVersion>

No

Versione del formato del file. La versione predefinita e quella corrente sono 1. Se un file dichiara una versione più recente di quella installata XProtect Smart Client Supporta, il file viene rifiutato.

<Login>

No

Informazioni di login. Consultare Automatizza l'accesso con gli script.

<Script>

No

Corpo dello script. Viene eseguito una volta per ogni accesso.

<OnEvent Name="…">

No

Attivazione evento. Un file può avere uno per evento.

Nota

Elementi legacy come <ScriptExtension> e qualsiasi <ScriptLanguage> diverse da C# vengono rifiutate dal motore di script.)

Caratteri speciali

Letture XML <, >e & come markup. Involucro codice script in <![CDATA[ … ]]>, consigliato o sostituire ogni carattere con la relativa entità XML:

Carattere

Entità

<

&lt;

>

&gt;

&

&amp;

Lingua supportata

Variabili

Dettagli

Variabili

var, stringhe, numeri interi e valori booleani (entrambi var e tipi espliciti come int sono supportati).

Condizioni

if, else if, else

Loop

for e foreach, con break e continue. foreach funziona solo sulle azioni che restituiscono un elenco.

Operatori

+,-,*,/,+=,-=, operatori di confronto,&&,\|\|, e suffisso i++

Stringhe

Si consiglia di utilizzare le virgolette doppie (le virgolette singole vengono accettate dal motore ma generano un avviso e non sono valide C#). Unisci stringhe con +.

Commenti

// e /* … */

Azioni

Tipo di azione

Sintassi

Note

Azioni integrate

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

Metodi diretti forniti dalla Smart Client motore di script (ad esempio, SCS.Application.Minimize();). La maggior parte delle azioni accetta argomenti.

I gruppi disponibili sono Application, Views, Browse, Camera, Ptz, MultiWindow, Generale Keyboard.

Viste, output, eventi e predefiniti PTZ

SCS.Invoke("<name>");

La <name> non è il nome visualizzato nell'interfaccia utente. Inizia con Views.All., Outputs.All., Events.All.o Ptz.Presets., seguito dai nomi della gerarchia configurati uniti da punti. Qualsiasi carattere diverso da una lettera alfanumerica o da una cifra viene convertito in un trattino basso (_).

Esempio: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Questi nomi sono identici in tutte le lingue di visualizzazione del client. Se due elementi nello stesso gruppo differiscono solo per caratteri speciali (come Cam 1 e Cam-1), generano lo stesso identificatore e solo uno è raggiungibile; rinominare uno degli elementi per risolvere la collisione.

Azioni del plugin di MIP, per nome

SCS.Invoke("<name>");

La <name> È costituito dai nomi visualizzati dal client per i gruppi e le azioni del plugin, uniti da punti. Poiché il plugin definisce e può localizzare questi nomi, questo modulo dipende dalla lingua del client corrente. Se più azioni condividono lo stesso nome, il motore di script rifiuta il nome; chiamare invece l'azione con il suo ID.

Azioni per ID

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

Identificatore univoco indipendente dalla lingua. Entrambi i nomi e gli ID sono elencati nel file di riferimento dello script generato quando è selezionata l'opzione Includi elementi di configurazione, che consente di copiare l'ID esatto direttamente nello script.

Per visualizzare tutte le azioni disponibili sul sistema, generare un riferimento allo script.

Funzioni integrate

Funzione

Descrizione

Thread.Sleep(milliseconds)

Sospende lo script senza bloccarlo XProtect Smart Client. Accetta 0-30.000 ms.

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

Mostra una notifica nell'area di notifica. Non blocca lo script o l'interfaccia utente.

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

Valori di data e ora. Si può leggere .Year, .Month, .Day, .Hour, .Minute e .Second.

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

Operazioni identificatore univoco. new Guid("<id as text>") Richiede esattamente un argomento stringa.

SCS.Application.WriteLog(level, message)

Scrittura su MIPLog.txt. Il livello è Info, Debugo Error.

SCS.Application.GetEventWindowId()

In un'attivazione evento, restituisce l'ID della finestra in cui si è verificato l'evento. Restituisce il testo vuoto per la finestra principale, nel corpo dello script e in ConfigurationReloadCompleted.

Nota: questa funzione può restituire l'ID di una finestra incorporata (come un'area della vista all'interno di una scheda) che non SCS.MultiWindow L'azione viene riconosciuta. Confronta prima l'ID con gli ID noti della finestra separata o ignora gli ID della finestra non riconosciuti.

Attivazione di eventi

Definisci <OnEvent> blocchi all'interno della <ScriptEngine> Elemento radice per reagire alle azioni dell'utente e alle modifiche dell'area di lavoro.

Evento

Esecuzioni

ConfigurationReloadCompleted

Dopo ogni ricarico di configurazione completato, una volta che le viste e le schede sono state regolate. Non viene eseguito al primo accesso.

SelectedViewChanged

Dopo aver selezionato una vista diversa, in qualsiasi finestra.

SelectedViewItemChanged

Dopo aver selezionato un altro elemento della vista, in qualsiasi finestra.

ShownWorkSpaceChanged

Dopo che la scheda selezionata è cambiata o una finestra passa da Live a Riproduzione.

Nota

Alcune aree di lavoro, come Alarm Manager ed Exports, contengono le proprie aree di vista integrate. Ogni area della vista incorporata riporta la sua creazione utilizzando un ID che non appartiene a una finestra separata. È quindi possibile passare a una di queste schede ShownWorkSpaceChanged più volte (ad esempio, Alarm Manager ha due aree di vista integrate e Exports ne ha una, quindi il passaggio a Alarm Manager può eseguire l'attivazione fino a tre volte). Lo script dovrebbe ignorare gli ID finestra non riconosciuti.

  • I trigger degli eventi vengono controllati insieme al corpo dello script. Un nome di evento sconosciuto è un errore.

  • I trigger degli eventi diventano attivi prima dell'esecuzione del corpo dello script e rimangono attivi fino al logout.

  • L'attivazione di un evento non viene rieseguita a causa di una modifica apportata dalle proprie azioni.

  • I nomi degli eventi fanno distinzione tra maiuscole e minuscole.

  • Ogni tipo di evento può essere dichiarato al massimo una volta in uno script.

  • Modifiche alla vista o alla scheda avviate dal corpo dello script (<Script>) attivano anche questi eventi.

Limiti

Limite

Valore

Istruzioni per esecuzione

100,000

Tempo di esecuzione per esecuzione

30 secondi

Thread.Sleep per chiamata

30 secondi

Esecuzioni per attivazione evento

60 al minuto. Le altre corse in quel minuto vengono saltate.

Iterazioni per loop

10,000

Lunghezza stringa

65.536 caratteri

Ogni esecuzione del corpo dello script o di un trigger di evento ha i propri limiti. Se un'esecuzione raggiunge un limite o un'azione non riesce, il resto dell'esecuzione si interrompe e l'evento viene connesso MIPLog.txt, ma XProtect Smart Client e qualsiasi altro evento che si attiva continua a funzionare. Quando si esce o si chiude XProtect Smart Client, arresta l'esecuzione di eventuali script.

Non supportato

Non supportato

Usa invece

while, do/while

for

switch

if / else if

try/catch, throw

Verifica dello script prima di distribuire lo script

Operatore condizionale (?:)

if / else

Incremento prefisso (++i)

Incremento suffisso (i++)

Interpolazione stringa ($"…")

+

Espressioni di virgole, più dichiarazioni variabili in for

Istruzioni separate

Array, valori letterali di raccolta e indicizzazione

Non supportato

%, *=, /=, %=, operatori bit per bit

Non supportato

Metodi, classi, interfacce, spazi dei nomi, dynamic

Plugin di MIP

ScriptExtension

Utilizzare azioni script integrate o un plugin di MIP

Timer, Task, new Thread(), async, delegati, lambda

Thread.Sleep o attivatori di eventi

Accesso a file, registri, reti e processi, reflection

Plugin di MIP