Smart Client Jazyk skriptu a limity
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 |
|---|---|---|
| Ano | Kořenový prvek. |
| Ne | Verze formátu souboru. Výchozí a aktuální verze je |
| Ne | Informace o přihlášení. Viz Automatické přihlášení pomocí skriptů. |
| Ne | Tělo skriptu. Spustí se jednou za přihlášení. |
| 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 |
|---|---|
|
|
|
|
|
|
Podporovaný jazyk
Proměnné | Podrobnosti |
|---|---|
Proměnné |
|
Podmínky |
|
Smyčky |
|
Operátoř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 |
|
Akce
Typ akce | Syntaxe | Poznámky |
|---|---|---|
Vestavěné akce |
| Přímé metody poskytované Smart Client skriptovací modul (například Dostupné skupiny jsou |
Zobrazení, výstupy, události a přednastavené pozice PTZ |
| The Příklad: 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 |
| The |
Akce podle 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 |
|---|---|
| Pozastaví skript bez zmrazení XProtect Smart Client. Přijímá 0–30 000 ms. |
| Zobrazí oznámení v oblasti oznámení. Neblokuje skript ani uživatelské rozhraní. |
| Hodnoty data a času. Můžete číst |
| Operace jedinečného identifikátoru. |
| Zapisovat do |
| 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 Poznámka: Tato funkce může vrátit ID vloženého okna (například oblast zobrazení uvnitř záložky), které ne |
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í |
|---|---|
| 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í. |
| Po výběru jiného zobrazení v libovolném okně. |
| Po výběru jiné položky zobrazení v libovolném okně. |
| Poté, co se vybraná karta změní, nebo se okno přepne mezi živým videem a přehráváním. PoznámkaNě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 |
| 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 | Použít namísto |
|---|---|
|
|
|
|
| Před nasazením skriptu ověřte skript. |
Podmíněný operátor ( |
|
Přírůstek předpony | Přírůstek Postfixu |
Interpolace řetězce |
|
Výrazy čárek, deklarace více proměnných v | Samostatné příkazy |
Pole, literály kolekce a indexování | Není podporováno |
| Není podporováno |
Metody, třídy, rozhraní, jmenné prostory, | Modul plugin MIP |
| Použití vestavěných akcí skriptu nebo zásuvného modulu MIP |
Časovače, |
|
Soubor, registr, přístup k síti a procesu, reflexe | Modul plugin MIP |