Skip to main content

XProtect Smart Client

Smart Client Lenguaje de escritura y límites

Última actualización: 7 minutos de lectura
Versión2026 R2
IdiomaEspañol

Smart Client Las secuencias de comandos utilizan un conjunto limitado de C# dentro de XML. Cuando XProtect Smart Client Cuando carga un archivo de secuencia de comandos, lo compara con una lista de características y acciones de lenguaje permitidas. Si alguna parte de la secuencia de comandos no es válida, el cuerpo de la secuencia de comandos y los activadores de eventos no se ejecutarán; sin embargo, el <Login> El bloqueo aún se aplica.

Estructura de archivo

Guarde el archivo con el comando .scs extensión, codificada como UTF-8. Se recomienda UTF-8 sin BOM.

Elemento

Obligatorio

Descripción

<ScriptEngine>

Sí

Elemento raíz.

<SchemaVersion>

No

Versión de formato de archivo. La versión predeterminada y actual es 1. Si un archivo declara una versión más reciente que la instalada XProtect Smart Client , el archivo se rechaza.

<Login>

No

Información de inicio de sesión Consulte Inicio de sesión automatizado con secuencias de comandos.

<Script>

No

Cuerpo del guión. Se ejecuta una vez por inicio de sesión.

<OnEvent Name="…">

No

Activador de evento. Un archivo puede tener uno por evento.

Nota

Elementos heredados como <ScriptExtension> y cualquiera <ScriptLanguage> (Los archivos que no son de C# son rechazados por el motor de secuencias de comandos.)

Caracteres especiales

Lecturas XML <, >, y & como marcador. Ajustar código de secuencia de comandos <![CDATA[ … ]]>, que se recomienda, o sustituya cada carácter por su entidad XML:

Carácter

Entidad

<

&lt;

>

&gt;

&

&amp;

Idioma compatible

Variables

Detalles

Variables

var, cadenas, enteros y valores booleanos (ambos var y tipos explícitos como int son compatibles).

Condiciones

if, else if, else

Bucles

for y foreach, con break y continue. foreach Funciona solo en acciones que devuelven una lista.

Operadores

+,-,*,/,+=,-=, Operadores de comparación,&&,\|\|, y sufijo i++

Cadenas

Se recomiendan las comillas dobles (el motor acepta las comillas simples, pero generan una advertencia y no son C# válidas). Unir cadenas con +.

Comentarios

// y /* … */

Acciones

Tipo de acción

Sintaxis

Notas

Acciones integradas

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

Métodos directos proporcionados por el Smart Client motor de secuencias de comandos (por ejemplo, SCS.Application.Minimize();). La mayoría de las acciones toman argumentos.

Los grupos disponibles son Application, Views, Browse, Camera, Ptz, MultiWindow, General, y Keyboard.

Vistas, salidas, eventos y valores preestablecidos PTZ

SCS.Invoke("<name>");

El <name> no es el nombre de pantalla que se muestra en la UI. Comienza con Views.All., Outputs.All., Events.All., o Ptz.Presets., seguido de los nombres de jerarquía configurados unidos por puntos. Cualquier carácter que no sea una letra alfanumérica o un dígito se convierte en un carácter de subrayado (_).

Ejemplo: Views.All.Basic_User_Group.All_cameras_Group._10x10_All_cameras

Estos nombres son idénticos en todos los idiomas de visualización del cliente. Si dos elementos del mismo grupo difieren solo por caracteres especiales (como Cam 1 y Cam-1), generan el mismo identificador, y solo uno es accesible; cambie el nombre de uno de los elementos para resolver la colisión.

Acciones de plugins de MIP, por nombre

SCS.Invoke("<name>");

El <name> Consiste en los nombres de pantalla que el cliente muestra para los grupos y la acción del plugin, unidos por puntos. Debido a que el plugin define y puede localizar estos nombres, este formulario depende del idioma actual del cliente. Si varias acciones comparten el mismo nombre, el motor de secuencias de comandos rechaza el nombre; en su lugar, llame a la acción por su ID.

Acciones por ID

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

Identificador único independiente del idioma. Tanto los nombres como los ID aparecen en el archivo de referencia de la secuencia de comandos generado cuando se marca Incluir elementos de configuración, lo que le permite copiar el ID exacto directamente en la secuencia de comandos.

Para ver todas las acciones disponibles en su sistema, genere una referencia de secuencia de comandos.

Funciones incorporadas

Función

Descripción

Thread.Sleep(milliseconds)

Pausa la secuencia de comandos sin congelarla XProtect Smart Client. Acepta de 0 a 30.000 ms.

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

Muestra una notificación en el área de notificación. No bloquea la secuencia de comandos ni la interfaz de usuario.

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

Valores de fecha y hora. Se puede leer .Year, .Month, .Day, .Hour, .Minute y .Second.

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

Operaciones de identificador único. new Guid("<id as text>") Requiere exactamente un argumento de cadena.

SCS.Application.WriteLog(level, message)

Escribe en MIPLog.txt. El nivel es Info, Debug, o Error.

SCS.Application.GetEventWindowId()

En un desencadenador de eventos, devuelve el ID de la ventana en la que se produjo el evento. Devuelve texto vacío para la ventana principal, en el cuerpo del script y en ConfigurationReloadCompleted.

Nota: Esta función puede devolver el ID de una ventana integrada (como un área de vista dentro de una pestaña) que no SCS.MultiWindow acción reconoce. Compare el ID con los ID de ventana flotante conocidos primero, o ignore los ID de ventana no reconocidos.

Activadores de eventos

Definir <OnEvent> bloques dentro del <ScriptEngine> Elemento raíz para reaccionar a las acciones del usuario y los cambios en el espacio de trabajo.

Evento

Ejecuciones

ConfigurationReloadCompleted

Después de cada recarga de configuración completada, una vez que las vistas y las pestañas se hayan establecido. No se ejecuta en el primer inicio de sesión.

SelectedViewChanged

Después de seleccionar una vista diferente, en cualquier ventana.

SelectedViewItemChanged

Después de seleccionar un elemento de vista diferente, en cualquier ventana.

ShownWorkSpaceChanged

Después de que la pestaña seleccionada cambie, o una ventana cambie entre Directo y Reproducción.

Nota

Algunos espacios de trabajo, como el Gestor de alarmas y las exportaciones, contienen sus propias áreas de vista incrustadas. Cada área de vista incrustada informa de su creación utilizando un ID que no pertenece a una ventana flotante. Por lo tanto, el cambio a una de estas pestañas puede ejecutarse ShownWorkSpaceChanged varias veces (por ejemplo, el Gestor de alarmas tiene dos áreas de vista integradas y Exportaciones tiene una, por lo que cambiar al Gestor de alarmas puede ejecutar el activador hasta tres veces). Su secuencia de comandos debe ignorar los ID de ventana no reconocidos.

  • Los activadores de eventos se comprueban junto con el cuerpo del script. Un nombre de evento desconocido es un error.

  • Los activadores de eventos se activan antes de que se ejecute el cuerpo del script y permanecen activos hasta que se cierra la sesión.

  • Un desencadenador de eventos no se vuelve a ejecutar debido a un cambio realizado por sus propias acciones.

  • Los nombres de eventos distinguen entre mayúsculas y minúsculas.

  • Cada tipo de evento se puede declarar como máximo una vez en una secuencia de comandos.

  • Cambios de vista o pestaña iniciados por el cuerpo del script (<Script>) también desencadenan estos eventos.

Límites

Límite

Valor

Sentencias por ejecución

100,000

Tiempo de ejecución por ejecución

30 segundos

Thread.Sleep por llamada

30 segundos

Ejecuciones por activador de evento

60 por minuto. Se omitirán todas las ejecuciones que se realicen en ese minuto.

Iteraciones por bucle

10,000

Longitud de cadena

65 536 caracteres

Cada ejecución del cuerpo del script o un desencadenador de eventos tiene sus propios límites. Si una ejecución alcanza un límite o falla una acción, el resto de esa ejecución se detiene y el evento se registra MIPLog.txt, pero XProtect Smart Client y cualquier otro activador de eventos siga ejecutándose. Al cerrar sesión o cerrar sesión XProtect Smart Client, detiene cualquier secuencia de comandos en ejecución.

No compatible

No compatible

Usar en su lugar

while, do/while

for

switch

if / else if

try/catch, throw

Verifique la secuencia de comandos… antes de implementarla

Operador condicional (?:)

if / else

Incremento de prefijo (++i)

Incremento de postfijo (i++)

Interpolación de cadena ($"…")

+

Expresiones de coma, varias declaraciones de variables en for

Sentencias separadas

Matrices, literales de colección e indexación

No compatible

%, *=, /=, %=, operadores bit a bit

No compatible

Métodos, clases, interfaces, espacios de nombres, dynamic

Complemento de MIP

ScriptExtension

Utilice acciones de script integradas o un complemento de MIP.

Temporizadores, Task, new Thread(), async, delegados, lambdas

Thread.Sleep o activadores de eventos

Acceso a archivos, registros, redes y procesos, reflexión

Complemento de MIP