Skip to main content

XProtect Smart Client

Smart Client Język skryptu i ograniczenia

Ostatnia aktualizacja: 5-minutowy odczyt
Wersja2026 R2
JęzykPolski

Smart Client W skryptach wykorzystywany jest ograniczony zestaw C# wewnątrz XML. Kiedy XProtect Smart Client Ładuje plik skryptu, sprawdza go pod kątem listy dozwolonych funkcji i czynności językowych. Jeśli jakakolwiek część skryptu jest nieprawidłowa, treść skryptu i wyzwalacze zdarzeń nie zostaną uruchomione; jednakże <Login> Blok jest nadal stosowany.

Struktura plików

Zapisz plik za pomocą przycisku .scs rozszerzenie, kodowane jako UTF-8. Zaleca się UTF-8 bez BOM.

Element

Wymagane

Opis

<ScriptEngine>

Tak

Element główny.

<SchemaVersion>

Nie

Wersja formatu pliku. Domyślna i bieżąca wersja to 1. Jeśli plik deklaruje wersję nowszą niż zainstalowana XProtect Smart Client obsługuje, plik został odrzucony.

<Login>

Nie

Dane logowania. Patrz Automatyczne logowanie za pomocą skryptów.

<Script>

Nie

Treść skryptu. Uruchamia się raz na logowanie.

<OnEvent Name="…">

Nie

Wyzwalacz zdarzenia. Plik może mieć jeden na zdarzenie.

Uwaga

Starsze elementy, takie jak <ScriptExtension> i dowolne <ScriptLanguage> inne niż C# są odrzucane przez aparat skryptu).

Znaki specjalne

Odczyty XML <, >oraz & jako narzut. Zawijaj kod skryptu w <![CDATA[ … ]]>, co jest zalecane, lub zastąp każdy znak jego jednostką XML:

Znak

Encja

<

&lt;

>

&gt;

&

&amp;

Obsługiwany język

Zmienne

Szczegóły

Zmienne

varciągi znaków, liczby całkowite i wartości logiczne (oba typy var i jawnych typów, takich jak int są obsługiwane).

Warunki

if, else if, else

Pętle

for i foreach, z break i continue. foreach Działa tylko w przypadku czynności, które zwracają listę.

Operatorzy

+,-,*,/,+=,-=, Operatory porównania,&&,\|\|, i przyrostek i++

Ciągi znaków

Zalecane są podwójne cudzysłowy (pojedyncze cudzysłowy są akceptowane przez silnik, ale generują ostrzeżenie i nie są poprawnymi C#). Łączenie ciągów znaków +.

Komentarze

// i /* … */

Akcje

Typ akcji

Składnia

Uwagi

Wbudowane działania

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

Metody bezpośrednie dostarczane przez Smart Client Silnik skryptu (na przykład, SCS.Application.Minimize();). Większość działań wymaga argumentów.

Dostępne grupy to Application, Views, Browse, Camera, Ptz, MultiWindow, Generaloraz Keyboard.

Widoki, wyjścia, zdarzenia i ustawienia wstępne PTZ

SCS.Invoke("<name>");

The <name> nie jest nazwą wyświetlaną wyświetlaną w interfejsie użytkownika. Zaczyna się od Views.All., Outputs.All., Events.All., lub Ptz.Presets., po których następują nazwy skonfigurowanej hierarchii połączone kropkami. Każdy znak inny niż litera alfanumeryczna lub cyfra jest konwertowany na znak podkreślenia (_).

Przykład: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Nazwy te są identyczne we wszystkich językach wyświetlania klienta. Jeśli dwie pozycje w tej samej grupie różnią się tylko znakami specjalnymi (np. Cam1 i Cam-1), generują ten sam identyfikator i tylko jedna z nich jest osiągalna; zmień nazwę jednej z pozycji, aby rozwiązać kolizję.

Działania wtyczki MIP według nazwy

SCS.Invoke("<name>");

The <name> Składa się z nazw wyświetlanych, które klient wyświetla dla grup wtyczek i czynności, połączonych kropkami. Ponieważ wtyczka definiuje i może lokalizować te nazwy, ten formularz zależy od bieżącego języka klienta. Jeśli wiele czynności ma tę samą nazwę, aparat skryptu odmawia nadania takiej nazwy. Wywołaj czynność za pomocą jej identyfikatora.

Akcje według identyfikatorów

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

Niepowtarzalny identyfikator niezależny od języka. Zarówno nazwy, jak i identyfikatory są wymienione w wygenerowanym pliku odniesienia skryptu, gdy zaznaczona jest opcja Uwzględnij pozycje konfiguracji, co pozwala skopiować dokładny identyfikator bezpośrednio do skryptu.

Aby wyświetlić wszystkie działania dostępne w systemie, wygeneruj odwołanie do skryptu.

Wbudowane funkcje

Funkcja

Opis

Thread.Sleep(milliseconds)

Wstrzymuje skrypt bez zamrożenia XProtect Smart Client. Akceptuje 0–30 000 ms.

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

Pokazuje powiadomienie w obszarze powiadomień. Nie blokuje skryptu ani interfejsu użytkownika.

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

Wartości daty i czasu. Można czytać .Year, .Month, .Day, .Hour, .Minute i .Second.

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

Operacje z unikatowym identyfikatorem. new Guid("<id as text>") Wymaga dokładnie jednego argumentu ciągu.

SCS.Application.WriteLog(level, message)

Zapisuje do MIPLog.txt. Poziom to Info, Debug, lub Error.

SCS.Application.GetEventWindowId()

W wyzwalaczu zdarzenia zwraca identyfikator okna, w którym wystąpiło zdarzenie. Zwraca pusty tekst dla okna głównego, w treści skryptu oraz w ConfigurationReloadCompleted.

Uwaga: Ta funkcja może zwrócić identyfikator osadzonego okna (takiego jak obszar widoku na karcie), które nie SCS.MultiWindow Akcja została rozpoznana. Najpierw porównaj identyfikator ze znanymi identyfikatorami okien przestawnych lub zignoruj nierozpoznane identyfikatory okien.

Wyzwalacze zdarzeń

Definiuj <OnEvent> bloki wewnątrz <ScriptEngine> Element główny, który reaguje na działania użytkownika i zmiany obszaru roboczego.

Zdarzenie

Przebiegi

ConfigurationReloadCompleted

Po każdej ukończonej konfiguracji ponownie załaduj po rozliczeniu widoków i kart. Nie działa przy pierwszym logowaniu.

SelectedViewChanged

Po wybraniu innego widoku w dowolnym oknie.

SelectedViewItemChanged

Po wybraniu innej pozycji widoku w dowolnym oknie.

ShownWorkSpaceChanged

Po zmianie wybranej karty lub przejściu okna między trybem na żywo a odtwarzaniem.

Uwaga

Niektóre obszary robocze, takie jak Menedżer alarmów i Eksport, zawierają własne osadzone obszary widoku. Każdy osadzony obszar widoku zgłasza swoje utworzenie za pomocą identyfikatora, który nie należy do okna przestawnego. W związku z tym można przejść do jednej z tych kart ShownWorkSpaceChanged wiele razy (na przykład Menedżer alarmów ma dwa wbudowane obszary widoku, a Eksport ma jeden, więc przejście do Menedżera alarmów może uruchomić wyzwalacz do trzech razy). Skrypt powinien ignorować nierozpoznane identyfikatory okien.

  • Wyzwalacze zdarzeń są sprawdzane razem z treścią skryptu. Nieznana nazwa zdarzenia to błąd.

  • Wyzwalacze zdarzeń uaktywniają się przed uruchomieniem treści skryptu i pozostają aktywne aż do wylogowania.

  • Wyzwalacz zdarzeń nie uruchamia się ponownie z powodu zmiany dokonanej przez jego własne działania.

  • W nazwach zdarzeń rozróżniana jest wielkość liter.

  • Każdy typ zdarzenia może być zadeklarowany w skrypcie najwyżej jeden raz.

  • Zmiany widoku lub karty zainicjowane przez treść skryptu (<Script>) również wyzwalają te zdarzenia.

Limity

Limit

Wartość

Zestawienia na przebieg

100,000

Czas wykonania na przebieg

30 sekund

Thread.Sleep na połączenie

30 sekund

Przebiegi na wyzwalacz zdarzenia

60 na minutę Kolejne przebiegi w ciągu tej minuty są pomijane.

Liczba iteracji na pętlę

10,000

Długość ciągu

65 536 znaków

Każde uruchomienie treści skryptu lub wyzwalacza zdarzenia ma swoje własne ograniczenia. Jeśli przebieg osiągnie limit lub czynność nie powiedzie się, pozostała część tego przebiegu zostanie zatrzymana, a zdarzenie zostanie zalogowane MIPLog.txt, ale XProtect Smart Client i wszelkie inne wyzwalacze zdarzeń nadal działają. Po wylogowaniu lub zamknięciu XProtect Smart Clientpowoduje zatrzymanie wszystkich uruchomionych skryptów.

Nieobsługiwane

Nieobsługiwane

Użyj zamiast

while, do/while

for

switch

if / else if

try/catch, throw

Weryfikuj skrypt przed wdrożeniem skryptu

Operator warunkowy (?:)

if / else

Przyrost prefiksu (++i)

Przyrost przyrostka (i++)

Interpolacja ciągów ($"…")

+

Wyrażenia przecinkowe, deklaracje wielu zmiennych w for

Oddzielne zestawienia

Tablice, literały kolekcji i indeksowanie

Nieobsługiwane

%, *=, /=, %=, operatory bitowe

Nieobsługiwane

Metody, klasy, interfejsy, przestrzenie nazw, dynamic

Wtyczka MIP

ScriptExtension

Korzystanie z wbudowanych czynności skryptu lub wtyczki MIP

Liczniki czasu, Task, new Thread(), asyncdelegaci, lambda

Thread.Sleep lub wyzwalacze zdarzeń

Dostęp do plików, rejestru, sieci i procesów, odbicie

Wtyczka MIP