Smart Client スクリプトの言語と制限
Smart Client スクリプトは、XML内のC#の限られたセットを使用します。次の場合 XProtect Smart Client スクリプトファイルを読み込み、許可されている言語の機能とアクションのリストと照らしてファイルをチェックします。スクリプトの一部が無効な場合、スクリプト本体とイベントトリガーは実行されませんが、 <Login> ブロックは引き続き適用されます。
ファイル構造
ファイルを .scs UTF-8としてエンコードされた拡張子。BOMなしのUTF-8をお勧めします。
エレメント | 必須 | 説明 |
|---|---|---|
| はい | ルート要素。 |
| いいえ | ファイル形式バージョン。デフォルトの現行バージョンは |
| いいえ | ログイン情報。スクリプトを使用した自動ログインをご参照ください。 |
| いいえ | スクリプト本体。ログインごとに1回実行されます。 |
| いいえ | イベントトリガー。ファイルはイベントごとに1つずつ含めることができます。 |
注記
レガシー要素 <ScriptExtension> および <ScriptLanguage> c#以外はスクリプトエンジンによって拒否されます。)
特殊文字
XML読み取り <, >、および & マークアップとして。スクリプト コードをラップ <![CDATA[ … ]]>、または各文字をXMLエンティティに置き換えることをお勧めします。
文字 | エンティティ |
|---|---|
|
|
|
|
|
|
対応言語
変数 | 詳細 |
|---|---|
変数 |
|
条件 |
|
ループ |
|
オペレータ |
|
文字列 | 二重引用符をお勧めします(単一引用符はエンジンで受け入れられますが、警告が生成され、有効なC#ではありません)。文字列を結合 |
コメント |
|
アクション
アクションタイプ | 構文 | メモ |
|---|---|---|
組み込みアクション |
| 直接メソッドを提供します Smart Client スクリプトエンジン(例: 使用可能なグループは次のとおりです |
ビュー、出力、イベント、PTZプリセット |
| 第 例: これらの名前は、すべてのクライアントの表示言語で同じです。同じグループ内の2つのアイテムが特殊文字によってのみ異なる場合(カメラ1やカメラ1など)、それらは同じ識別子を生成し、1つだけが到達可能です。衝突を解決するために、いずれかのアイテムの名前を変更します。 |
名前によるMIPプラグインのアクション |
| 第 |
ID別アクション |
| 言語に依存しない一意の識別子。名前とIDの両方が、Include configuration items(構成アイテムを含む)がチェックされたときに生成されたスクリプト参照ファイルに一覧表示され、スクリプトに正確なIDを直接コピーできます。 |
システムで利用可能なすべてのアクションを表示するには、スクリプト参照を生成します。
ビルトイン機能
機能 | 説明 |
|---|---|
| スクリプトをフリーズせずに一時停止します XProtect Smart Client. 0~30,000ミリ秒を受け入れます。 |
| 通知領域に通知を表示します。スクリプトやUIをブロックしません。 |
| 日時の値。読むことができます |
| 一意の識別子操作。 |
| 書き込み先 |
| イベントトリガーでは、イベントが発生したウィンドウのIDを返します。メインウィンドウの空のテキストをスクリプト本体と 注:この関数は、タブ内のビューエリアなどの埋め込みウィンドウのIDを返すことができ、その場合は |
イベントトリガー
定義 <OnEvent> 内のブロック <ScriptEngine> root要素を使用して、ユーザーアクションとワークスペースの変更に対応します。
イベント | 実行 |
|---|---|
| 設定の再読み込みが完了するたびに、ビューとタブが確定します。最初のログイン時には実行されません。 |
| 別のビューを選択した後、任意のウィンドウで。 |
| 別のビューアイテムを選択した後、任意のウィンドウで。 |
| 選択したタブが変更された後、またはウィンドウがライブと再生を切り替えた後。 注記アラームマネージャやエクスポートなどの一部のワークスペースには、独自の組み込みビューエリアがあります。各組み込みビューエリアは、フローティングウィンドウに属さないIDを使用して作成を報告します。したがって、これらのタブのいずれかに切り替えると実行できます ShownWorkSpaceChanged 複数回(たとえば、Alarm Managerには2つの組み込みビューエリアがあり、Exportsには1つがあるため、Alarm Managerに切り替えるとトリガーを最大3回実行できます)。 スクリプトは認識されないウィンドウIDを無視する必要があります。 |
イベントトリガーは、スクリプト本体と一緒にチェックされます。不明なイベント名はエラーです。
イベントトリガーはスクリプト本体が実行される前にアクティブになり、ログアウトするまでアクティブのままになります。
イベントトリガーは、それ自体のアクションによって行われた変更のため、再度実行されません。
イベント名では大文字と小文字が区別されます。
各イベントタイプは、スクリプト内で一度に宣言できます。
スクリプト本体(
<Script>)もこれらのイベントを起動します。
制限
制限 | 値 |
|---|---|
実行ごとのステートメント | 100,000 |
実行ごとの実行時間 | 30 秒 |
| 30 秒 |
イベントトリガーごとに実行 | 1分あたり60。その1分間に実行された実行はスキップされます。 |
ループごとのイテレーション | 10,000 |
文字列長 | 65,536文字 |
スクリプト本体またはイベントトリガーの実行にはそれぞれ制限があります。実行が制限に達するか、アクションが失敗すると、その実行の残りが停止し、イベントがログインします MIPLog.txt、しかし XProtect Smart Client その他のイベントトリガーは実行し続けます。ログアウトまたは閉じるとき XProtect Smart Client、実行中のスクリプトを停止します。
サポート対象外 | 代わりに使用 |
|---|---|
|
|
|
|
| スクリプトの確認… スクリプトをデプロイする前に |
条件付き演算子( |
|
接頭辞の増分 | 接尾辞の増分 |
文字列の補間 |
|
コンマ式、複数の変数宣言 | 個別のステートメント |
配列、コレクション リテラル、インデックス作成 | サポート対象外 |
| サポート対象外 |
メソッド、クラス、インターフェイス、名前空間、 | MIPプラグイン |
| 組み込みのスクリプトアクションまたはMIPプラグインを使用 |
タイマー、 |
|
ファイル、レジストリ、ネットワークおよびプロセスへのアクセス、リフレクション | MIPプラグイン |