Smart Client Język skryptu i ograniczenia
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 |
|---|---|---|
| Tak | Element główny. |
| Nie | Wersja formatu pliku. Domyślna i bieżąca wersja to |
| Nie | Dane logowania. Patrz Automatyczne logowanie za pomocą skryptów. |
| Nie | Treść skryptu. Uruchamia się raz na logowanie. |
| 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 |
|---|---|
|
|
|
|
|
|
Obsługiwany język
Zmienne | Szczegóły |
|---|---|
Zmienne |
|
Warunki |
|
Pętle |
|
Operatorzy |
|
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 |
|
Akcje
Typ akcji | Składnia | Uwagi |
|---|---|---|
Wbudowane działania |
| Metody bezpośrednie dostarczane przez Smart Client Silnik skryptu (na przykład, Dostępne grupy to |
Widoki, wyjścia, zdarzenia i ustawienia wstępne PTZ |
| The Przykład: 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 |
| The |
Akcje według identyfikatorów |
| 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 |
|---|---|
| Wstrzymuje skrypt bez zamrożenia XProtect Smart Client. Akceptuje 0–30 000 ms. |
| Pokazuje powiadomienie w obszarze powiadomień. Nie blokuje skryptu ani interfejsu użytkownika. |
| Wartości daty i czasu. Można czytać |
| Operacje z unikatowym identyfikatorem. |
| Zapisuje do |
| 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 Uwaga: Ta funkcja może zwrócić identyfikator osadzonego okna (takiego jak obszar widoku na karcie), które nie |
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 |
|---|---|
| Po każdej ukończonej konfiguracji ponownie załaduj po rozliczeniu widoków i kart. Nie działa przy pierwszym logowaniu. |
| Po wybraniu innego widoku w dowolnym oknie. |
| Po wybraniu innej pozycji widoku w dowolnym oknie. |
| Po zmianie wybranej karty lub przejściu okna między trybem na żywo a odtwarzaniem. UwagaNiektó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 |
| 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 | Użyj zamiast |
|---|---|
|
|
|
|
| Weryfikuj skrypt przed wdrożeniem skryptu |
Operator warunkowy ( |
|
Przyrost prefiksu | Przyrost przyrostka |
Interpolacja ciągów |
|
Wyrażenia przecinkowe, deklaracje wielu zmiennych w | Oddzielne zestawienia |
Tablice, literały kolekcji i indeksowanie | Nieobsługiwane |
| Nieobsługiwane |
Metody, klasy, interfejsy, przestrzenie nazw, | Wtyczka MIP |
| Korzystanie z wbudowanych czynności skryptu lub wtyczki MIP |
Liczniki czasu, |
|
Dostęp do plików, rejestru, sieci i procesów, odbicie | Wtyczka MIP |