Skip to main content

XProtect Smart Client

Smart Client Jazyk skriptu a limity

Poslední aktualizace: 5 min čtení
Verze2026 R2
JazykČeština

Smart Client Skripty využívají omezenou sadu C# uvnitř XML. Kdy XProtect Smart Client Načte soubor skriptu a zkontroluje soubor s ohledem na seznam povolených jazykových funkcí a akcí. Pokud je některá část skriptu neplatná, tělo skriptu a spouštěče událostí nebudou spuštěny; <Login> Blok je stále používán.

Struktura souboru

Uložit soubor s .scs Rozšíření kódované jako UTF-8. Doporučuje se UTF-8 bez kusovníku.

Prvek

Povinný

Popis

<ScriptEngine>

Ano

Kořenový prvek.

<SchemaVersion>

Ne

Verze formátu souboru. Výchozí a aktuální verze je 1. Pokud soubor deklaruje novější verzi, než je nainstalovaná XProtect Smart Client podporuje, soubor je odmítnut.

<Login>

Ne

Informace o přihlášení. Viz Automatické přihlášení pomocí skriptů.

<Script>

Ne

Tělo skriptu. Spustí se jednou za přihlášení.

<OnEvent Name="…">

Ne

Spouštěč události. Soubor může mít jednu událost na událost.

Poznámka

Starší prvky, například <ScriptExtension> a jakékoli <ScriptLanguage> jiné než C# jsou odmítnuty skriptovacím enginem.)

Speciální znaky

Čtení XML <, >,A & Jako značku. Zabalit kód skriptu do <![CDATA[ … ]]>, který je doporučen, nebo nahradit každý znak jeho XML entitou:

Znak

Entita

<

&lt;

>

&gt;

&

&amp;

Podporovaný jazyk

Proměnné

Podrobnosti

Proměnné

varřetězce, celá čísla a logické hodnoty (obojí var a výslovné typy, jako jsou int jsou podporovány).

Podmínky

if, else if, else

Smyčky

for A foreach, s break A continue. foreach Funguje pouze u akcí, které vracejí seznam.

Operátoři

+,-,*,/,+=,-=, Porovnávací operátory,&&,\|\|, a Postfix i++

Řetězce

Jsou doporučeny dvojité uvozovky (jednotlivé uvozovky jsou přijímány motorem, ale generují varování a nejsou platné C#). Spojit řetězce pomocí +.

Komentáře

// A /* … */

Akce

Typ akce

Syntaxe

Poznámky

Vestavěné akce

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

Přímé metody poskytované Smart Client skriptovací modul (například SCS.Application.Minimize();). Většina akcí obsahuje argumenty.

Dostupné skupiny jsou Application, Views, Browse, Camera, Ptz, MultiWindow, General,A Keyboard.

Zobrazení, výstupy, události a přednastavené pozice PTZ

SCS.Invoke("<name>");

The <name> není zobrazovaný název zobrazený v uživatelském rozhraní. Začíná se Views.All., Outputs.All., Events.All.,nebo Ptz.Presets.následované konfigurovanými názvy hierarchie spojenými tečkami. Jakýkoli znak jiný než alfanumerické písmeno nebo číslice se převede na podtržítko (_).

Příklad: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Tyto názvy jsou identické ve všech jazycích zobrazení klientů. Pokud se dvě položky ve stejné skupině liší pouze speciálními znaky (například Cam 1 a Cam-1), generují stejný identifikátor a pouze jedna je dosažitelná; přejmenujte jednu z položek, abyste kolizi vyřešili.

Akce modulů plugin pro MIP podle názvu

SCS.Invoke("<name>");

The <name> Skládá se ze zobrazovaných názvů, které klient zobrazuje pro skupiny a akce pluginu, spojené tečkami. Protože plugin definuje a může lokalizovat tyto názvy, závisí tento formulář na aktuálním jazyce klienta. Pokud má více akcí stejný název, skriptovací stroj název odmítne; místo toho akci zavolejte podle jejího ID.

Akce podle ID

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

Jedinečný identifikátor nezávislý na jazyce. Názvy i ID jsou při zaškrtnutí políčka Zahrnout konfigurační položky uvedeny ve vygenerovaném referenčním souboru skriptu, což vám umožní zkopírovat přesné ID přímo do skriptu.

Chcete-li zobrazit všechny akce dostupné ve vašem systému, vygenerujte odkaz na skript.

Vestavěné funkce

Funkce

Popis

Thread.Sleep(milliseconds)

Pozastaví skript bez zmrazení XProtect Smart Client. Přijímá 0–30 000 ms.

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

Zobrazí oznámení v oblasti oznámení. Neblokuje skript ani uživatelské rozhraní.

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

Hodnoty data a času. Můžete číst .Year, .Month, .Day, .Hour, .Minute A .Second.

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

Operace jedinečného identifikátoru. new Guid("<id as text>") Vyžaduje přesně jeden argument řetězce.

SCS.Application.WriteLog(level, message)

Zapisovat do MIPLog.txt. Úroveň je Info, Debug,nebo Error.

SCS.Application.GetEventWindowId()

V případě spuštění události vrátí ID okna, kde k události došlo. Vrátí prázdný text pro hlavní okno, v těle skriptu a v ConfigurationReloadCompleted.

Poznámka: Tato funkce může vrátit ID vloženého okna (například oblast zobrazení uvnitř záložky), které ne SCS.MultiWindow Akce byla rozpoznána. Nejprve porovnejte ID se známými ID plovoucího okna nebo ignorujte nerozpoznaná ID okna.

Spouštěče událostí

Definovat <OnEvent> bloky uvnitř <ScriptEngine> Kořenový prvek pro reakci na akce uživatele a změny pracovního prostoru.

Událost

Spustí

ConfigurationReloadCompleted

Po dokončení každé konfigurace znovu načtěte, jakmile se zobrazení a karty usadí. Nespustí se při prvním přihlášení.

SelectedViewChanged

Po výběru jiného zobrazení v libovolném okně.

SelectedViewItemChanged

Po výběru jiné položky zobrazení v libovolném okně.

ShownWorkSpaceChanged

Poté, co se vybraná karta změní, nebo se okno přepne mezi živým videem a přehráváním.

Poznámka

Některé pracovní prostory, například Správce alarmů a Exporty, obsahují vlastní integrované oblasti zobrazení. Každá vložená oblast zobrazení hlásí své vytvoření pomocí ID, které nepatří do plovoucího okna. Přepnutí na jednu z těchto karet lze proto spustit ShownWorkSpaceChanged opakovaně (například Správce alarmů má dvě integrované oblasti zobrazení a Export jednu, takže přepnutí na Správce alarmů může spustit spoušť až třikrát). Skript by měl ignorovat nerozpoznaná ID okna.

  • Spouštěče událostí se kontrolují společně s tělem skriptu. Neznámý název události je chyba.

  • Spouštěče událostí se aktivují před spuštěním těla skriptu a zůstanou aktivní až do odhlášení.

  • Spouštěč události se znovu nespustí kvůli změně provedené vlastními akcemi.

  • U názvů událostí se rozlišují malá a velká písmena.

  • Každý typ události lze ve skriptu deklarovat nejvýše jednou.

  • Zobrazení nebo změny karet iniciované tělem skriptu (<Script>) tyto události také spouštět.

Limity

Limit

Hodnota

Výkazy na jedno spuštění

100,000

Čas spuštění na jedno spuštění

30 sekund

Thread.Sleep Na volání

30 sekund

Spuštěno na spouštěč události

60 za minutu Další spuštění v této minutě budou přeskočena.

Iterací na smyčku

10,000

Délka řetězce

65 536 znaků

Každé spuštění těla skriptu nebo spouštěče události má své vlastní limity. Pokud spuštění dosáhne limitu nebo pokud akce selže, zbytek spuštění se zastaví a událost je přihlášena MIPLog.txt, ale XProtect Smart Client a všechny ostatní spouštěče událostí běží. Když se odhlásíte nebo zavřete XProtect Smart Clientzastaví spouštění skriptů.

Není podporováno

Není podporováno

Použít namísto

while, do/while

for

switch

if / else if

try/catch, throw

Před nasazením skriptu ověřte skript.

Podmíněný operátor (?:)

if / else

Přírůstek předpony (++i)

Přírůstek Postfixu (i++)

Interpolace řetězce ($"…")

+

Výrazy čárek, deklarace více proměnných v for

Samostatné příkazy

Pole, literály kolekce a indexování

Není podporováno

%, *=, /=, %=bitové operátory

Není podporováno

Metody, třídy, rozhraní, jmenné prostory, dynamic

Modul plugin MIP

ScriptExtension

Použití vestavěných akcí skriptu nebo zásuvného modulu MIP

Časovače, Task, new Thread(), async, delegátů, jehňat

Thread.Sleep nebo spouštěče událostí

Soubor, registr, přístup k síti a procesu, reflexe

Modul plugin MIP