Smart Client Linguagem de script e limites
Smart Client Os scripts usam um conjunto limitado de C# dentro de XML. Quando XProtect Smart Client Carrega um arquivo de script, ele verifica o arquivo em relação a uma lista de recursos e ações de idioma permitidos. Se qualquer parte do script for inválida, o corpo do script e os disparadores de eventos não serão executados; no entanto, o <Login> O bloco ainda está aplicado.
Estrutura de arquivo
Salve o arquivo com o .scs extensão, codificada como UTF-8. Recomenda-se UTF-8 sem BOM.
Elemento | Necessário | Descrição |
|---|---|---|
| Sim | Elemento raiz. |
| Não | Versão do formato de arquivo. A versão padrão e atual é |
| Não | Informações de login. Consulte Automatizar login com scripts. |
| Não | Corpo do script. Roda uma vez por login. |
| Não | Disparo de evento. Um arquivo pode ter um por evento. |
Nota
Elementos herdados como <ScriptExtension> e qualquer <ScriptLanguage> outros que não C# são recusados pelo mecanismo de script.)
Caracteres especiais
Leituras XML <, >e & como marcação. Envolver código de script em <![CDATA[ … ]]>, o que é recomendado ou substitua cada caractere por sua entidade XML:
Caractere | Entidade |
|---|---|
|
|
|
|
|
|
Idioma suportado
Variáveis | Detalhes |
|---|---|
Variáveis |
|
Condições |
|
Loops |
|
Operadores |
|
Sequências | Aspas duplas são recomendadas (aspas simples são aceitas pelo mecanismo, mas geram um aviso e não são C# válidas). Unir sequências com |
Comentários |
|
Ações
Tipo de ação | Sintaxe | Observações |
|---|---|---|
Ações integradas |
| Métodos diretos fornecidos pelo Smart Client mecanismo de script (por exemplo, Os grupos disponíveis são |
Visualizações, saídas, eventos e predefinições PTZ |
| O Exemplo: Esses nomes são idênticos em todos os idiomas de exibição do cliente. Se dois itens no mesmo grupo diferirem apenas por caracteres especiais (como Cam-1 e Cam-1), eles gerarão o mesmo identificador e apenas um estará acessível; renomeie um dos itens para resolver a colisão. |
Ações de plug-in do MIP, por nome |
| O |
Ações por ID |
| Identificador exclusivo independente de idioma. Ambos os nomes e IDs são listados no arquivo de referência de script gerado quando Incluir itens de configuração está marcado, permitindo que você copie o ID exato diretamente em seu script. |
Para ver todas as ações disponíveis em seu sistema, gere uma referência de script.
Funções integradas
Função | Descrição |
|---|---|
| Pausa o script sem congelamento XProtect Smart Client. Aceita de 0 a 30.000 ms. |
| Mostra uma notificação na área de notificação. Ele não bloqueia o script ou a interface do usuário. |
| Valores de data e hora. Você pode ler |
| Operações de identificador exclusivo. |
| Gravações em |
| Em um disparo de evento, retorna o ID da janela onde o evento aconteceu. Retorna texto vazio para a janela principal, no corpo do script e em Nota: Esta função pode retornar a ID de uma janela integrada (como uma área de visualização dentro de uma guia) que não |
Disparos de eventos
Definir <OnEvent> Blocos dentro do <ScriptEngine> elemento raiz para reagir às ações do usuário e alterações no espaço de trabalho.
Evento | Executar |
|---|---|
| Após cada recarga de configuração concluída, uma vez que as visualizações e guias forem definidas. Não é executado no primeiro login. |
| Depois que uma visualização diferente for selecionada, em qualquer janela. |
| Depois que um item de visualização diferente for selecionado, em qualquer janela. |
| Depois que a guia selecionada mudar, uma janela alterna entre Ao vivo e Reprodução. NotaAlguns espaços de trabalho, como Gerenciador de alarmes e Exportações, contêm suas próprias áreas de visualização integradas. Cada área de visualização integrada relata sua criação usando um ID que não pertence a uma janela flutuante. A alternância para uma dessas guias pode ser executada ShownWorkSpaceChanged várias vezes (por exemplo, o Gerenciador de Alarmes tem duas áreas de visualização integradas e o Exportações tem uma, então mudar para o Gerenciador de Alarmes pode executar o disparo até três vezes). Seu script deve ignorar IDs de janela não reconhecidas. |
Os disparos de eventos são verificados junto com o corpo do script. Um nome de evento desconhecido é um erro.
Os disparos de evento ficam ativos antes que o corpo do script seja executado e permanecem ativos até o logout.
Um disparo de evento não é executado novamente devido a uma alteração feita por suas próprias ações.
Os nomes de eventos diferenciam maiúsculas de minúsculas.
Cada tipo de evento pode ser declarado no máximo uma vez em um script.
Alterações de visualização ou guia iniciadas pelo corpo do script (
<Script>) também disparam esses eventos.
Limites
Limite | Valor |
|---|---|
Declarações por execução | 100,000 |
Tempo de execução por execução | 30 segundos |
| 30 segundos |
Execuções por disparo de evento | 60 por minuto. Mais execuções nesse minuto serão ignoradas. |
Iterações por loop | 10,000 |
Comprimento da sequência | 65.536 caracteres |
Cada execução do corpo do script ou um disparo de evento tem seus próprios limites. Se uma execução atingir um limite ou uma ação falhar, o resto dessa execução para e o evento é registrado MIPLog.txt, mas XProtect Smart Client e quaisquer outros disparos de eventos continuam em execução. Quando você fizer logoff ou fechar XProtect Smart Client, ele para qualquer script em execução.
Não suportado | Em vez disso, use |
|---|---|
|
|
|
|
| Verifique o script… antes de implantar o script |
Operador condicional ( |
|
Incremento de prefixo | Incremento de pós-fixo |
Interpolação de cadeias de caracteres |
|
Expressões de vírgula, várias declarações de variáveis em | Declarações separadas |
Matrizes, literais de coleção e indexação | Não suportado |
| Não suportado |
Métodos, classes, interfaces, namespaces, | Plug-in MIP |
| Usar ações de script integradas ou um plug-in do MIP |
Temporizadores, |
|
Acesso a arquivo, registro, rede e processo, reflexão | Plug-in MIP |