Smart Client Lenguaje de escritura y límites
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 |
|---|---|---|
| Sí | Elemento raíz. |
| No | Versión de formato de archivo. La versión predeterminada y actual es |
| No | Información de inicio de sesión Consulte Inicio de sesión automatizado con secuencias de comandos. |
| No | Cuerpo del guión. Se ejecuta una vez por inicio de sesión. |
| 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 |
|---|---|
|
|
|
|
|
|
Idioma compatible
Variables | Detalles |
|---|---|
Variables |
|
Condiciones |
|
Bucles |
|
Operadores |
|
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 |
|
Acciones
Tipo de acción | Sintaxis | Notas |
|---|---|---|
Acciones integradas |
| Métodos directos proporcionados por el Smart Client motor de secuencias de comandos (por ejemplo, Los grupos disponibles son |
Vistas, salidas, eventos y valores preestablecidos PTZ |
| El Ejemplo: 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 |
| El |
Acciones por 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 |
|---|---|
| Pausa la secuencia de comandos sin congelarla XProtect Smart Client. Acepta de 0 a 30.000 ms. |
| Muestra una notificación en el área de notificación. No bloquea la secuencia de comandos ni la interfaz de usuario. |
| Valores de fecha y hora. Se puede leer |
| Operaciones de identificador único. |
| Escribe en |
| 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 Nota: Esta función puede devolver el ID de una ventana integrada (como un área de vista dentro de una pestaña) que no |
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 |
|---|---|
| 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. |
| Después de seleccionar una vista diferente, en cualquier ventana. |
| Después de seleccionar un elemento de vista diferente, en cualquier ventana. |
| Después de que la pestaña seleccionada cambie, o una ventana cambie entre Directo y Reproducción. NotaAlgunos 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 |
| 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 | Usar en su lugar |
|---|---|
|
|
|
|
| Verifique la secuencia de comandos… antes de implementarla |
Operador condicional ( |
|
Incremento de prefijo | Incremento de postfijo |
Interpolación de cadena |
|
Expresiones de coma, varias declaraciones de variables en | Sentencias separadas |
Matrices, literales de colección e indexación | No compatible |
| No compatible |
Métodos, clases, interfaces, espacios de nombres, | Complemento de MIP |
| Utilice acciones de script integradas o un complemento de MIP. |
Temporizadores, |
|
Acceso a archivos, registros, redes y procesos, reflexión | Complemento de MIP |