Smart Client skriptspråk och begränsningar
Smart Client skript använder en begränsad uppsättning C# i XML. När XProtect Smart Client läser in en skriptfil, kontrollerar den filen mot en lista med tillåtna språkfunktioner och åtgärder. Om någon del av skriptet är ogiltigt, körs inte skriptets brödtext och händelseutlösare, däremot <Login> Blocket tillämpas fortfarande.
Filstruktur
Spara filen med .scs tillägg, kodad som UTF-8. UTF-8 utan strukturlista rekommenderas.
Element | Obligatorisk | Beskrivning |
|---|---|---|
| Ja | Rotelement. |
| Nej | Filformatsversion. Standard och aktuell version är |
| Nej | Inloggningsinformation. Se Automatisera inloggning med skript. |
| Nej | Skripttext. Körs en gång per inloggning. |
| Nej | Händelseutlösare. En fil kan ha en per händelse. |
Notera
Äldre element som <ScriptExtension> och varje <ScriptLanguage> andra än C# nekas av skriptmotorn.)
Specialtecken
XML-läsningar <, >, och & som markering. Radbryt skriptkod i <![CDATA[ … ]]>, vilket rekommenderas, eller ersätt varje tecken med dess XML-enhet:
Tecken | Entitet |
|---|---|
|
|
|
|
|
|
Språk som stöds
Variabler | Detaljer |
|---|---|
Variabler |
|
Villkor |
|
Slingor |
|
Operatörer |
|
Strängar | Dubbla citattecken rekommenderas (enkla citattecken accepteras av motorn men genererar en varning och är inte giltiga C#). Gå med i strängar med |
Kommentarer |
|
Åtgärder
Åtgärdstyp | Syntax | Anteckningar |
|---|---|---|
Inbyggda åtgärder |
| Direkta metoder som tillhandahålls av Smart Client skriptmotor (till exempel De tillgängliga grupperna är |
Vyer, utdata, händelser och PTZ-förinställningar |
| Den Exempel: Dessa namn är identiska över alla klientvisningsspråk. Om två objekt i samma grupp bara skiljer sig åt med specialtecken (som kamera 1 och kamera 1) genererar de samma identifierare, och bara en kan nås. Byt namn på ett av objekten för att lösa konflikten. |
MIP-plugin-åtgärder, efter namn |
| Den |
Åtgärder per ID |
| Språkoberoende unik identifierare. Både namn och ID listas i den genererade skriptreferensfilen när Inkludera konfigurationsobjekt är markerat, vilket låter dig kopiera exakt ID direkt till ditt skript. |
För att se alla åtgärder tillgängliga på ditt system, generera en skriptreferens.
Inbyggda funktioner
Funktion | Beskrivning |
|---|---|
| Pausar skriptet utan att frysa XProtect Smart Client. Accepterar 0–30 000 ms. |
| Visar en avisering i aviseringsområdet. Det blockerar inte skriptet eller användargränssnittet. |
| Datum- och tidsvärden. Du kan läsa |
| Åtgärder för unik identifierare. |
| Skriver till |
| I en händelseutlösare, returnerar ID för fönstret där händelsen inträffade. Returnerar tom text för huvudfönstret, i skriptets brödtext och i Obs! Den här funktionen kan returnera ID för ett inbäddat fönster (t.ex. ett visningsområde på en flik) som inte |
Händelseutlösare
Ange <OnEvent> block inom <ScriptEngine> rotelement för att reagera på användaråtgärder och ändringar på arbetsytan.
Händelse | Kör |
|---|---|
| Efter varje slutförd konfigurationsladdning, när vyer och flikar har kvittats. Körs inte vid första inloggning. |
| Efter att en annan vy har valts, i ett fönster. |
| Efter att ett annat visningselement valts, i ett fönster. |
| Efter att den valda fliken ändras, eller ett fönster växlar mellan Live och Uppspelning. NoteraVissa arbetsytor, som Larmhanteraren och Exporter, innehåller sina egna inbäddade visningsområden. Varje inbäddat visningsområde rapporterar att det skapats med ett ID som inte tillhör ett flytande fönster. Att växla till en av dessa flikar kan därför köras ShownWorkSpaceChanged flera gånger (till exempel har Larmhanteraren två inbäddade visningsområden och Exporterna har ett, så att växla till Larmhanteraren kan köra utlösaren upp till tre gånger). Ditt skript bör ignorera okända fönster-ID. |
Händelseutlösare kontrolleras tillsammans med skripttexten. Ett okänt händelsenamn är ett fel.
Händelseutlösare blir aktiva innan skriptkroppen körs och förblir aktiva tills utloggning.
En händelseutlösare körs inte igen på grund av en ändring som gjorts av dess egna åtgärder.
Händelsenamn är skiftlägeskänsliga.
Varje händelsetyp kan deklareras högst en gång i ett skript.
Vy- eller flikändringar initierade av skripttexten (
<Script>) utlöser även dessa händelser.
Gränser
Begränsning | Värde |
|---|---|
Utdrag per körning | 100,000 |
Körtid per körning | 30 sekunder |
| 30 sekunder |
Kör per händelseutlösare | 60 per minut. Inga fler körningar under den minuten hoppas över. |
Iterationer per slinga | 10,000 |
Stränglängd | 65 536 tecken |
Varje körning av skripttexten eller en händelseutlösare har sina egna gränser. Om en körning når en gräns eller en åtgärd misslyckas, stannar resten av körningen och händelsen loggas in MIPLog.txt, men XProtect Smart Client och alla andra händelseutlösare fortsätter att köras. När du loggar ut eller stänger XProtect Smart Client, stoppar det skript som körs.
Stöds inte | Använd istället |
|---|---|
|
|
|
|
| Verifiera skript… innan du distribuerar skriptet |
Villkorlig operatör ( |
|
Prefixökning | Ökning av postfix |
Stränginterpolering |
|
Komma-uttryck, flera variabeldeklarationer i | Separata satser |
Matriser, samlingslitteraler och indexering | Stöds inte |
| Stöds inte |
Metoder, klasser, gränssnitt, namnutrymmen, | MIP-insticksmodul |
| Använd inbyggda skriptåtgärder eller en MIP-plugin |
Timer, |
|
Fil-, register-, nätverks- och processåtkomst, reflektion | MIP-insticksmodul |