脚本

登录脚本（已解释）

您可使用指令檔控制 XProtect Smart Client 中的部分或全部登入程序。

  • 如果采用基本身份验证或 Windows 身份验证，则可以打开预填写了服务器地址和用户名字段的 XProtect Smart Client 登录窗口，用户只要输入密码即可登录。
  • 如果采用 Windows 身份验证（当前用户），则可在用户当前的 Windows 登录的基础上使 XProtect Smart Client 自动连接到监控系统。

根據基本驗證或 Windows 驗證對登入程序進行指令檔處理，需要您將非加密的機密資訊新增至與 XProtect Smart Client 程式檔一起本機儲存的 SCS 檔案。

  • 主機名稱
  • 使用者名稱
  • 密码

儲存非加密資訊可能會危及您的系統或 DGPR 合規性的安全性。可讀取 SCS 檔案中的資訊：

  • 由可存取此檔案的任何人執行
  • 在 XProtect Smart Client 應用程式 (由 SCS 檔案或提供使用者名稱和密碼的命令列啟動) 的磁碟使用量中

Milestone 建議您使用 Windows 驗證 (目前使用者)。如果您必須進行基本驗證或 Windows 驗證，您應該限制對 SCS 檔案的存取。

登录脚本 - 参数

您可以使用以下参数：

ServerAddress

引用 XProtect Smart Client 所连接服务器的 URL。

對於上述產品，這是管理伺服器的 URL：

  • XProtect Corporate

  • XProtect Expert

  • XProtect Professional+

  • XProtect Express+

  • XProtect Essential+

對於上述產品，這是影像伺服器的 URL：

XProtect Professional

XProtect Express

下面的示例将显示 XProtect Smart Client 的登录窗口，其中服务器地址字段为http://ourserver：

Client.exe -ServerAddress="http://ourserver"

默认身份验证类型为 Windows 身份验证（当前用户）。 除非使用 AuthenticationType 参数（参见下文）对此进行更改，否则登录窗口会在用户名字段自动显示当前 Windows 用户。

表示特定的用户名。

下面的示例将显示 XProtect Smart Client 登录窗口，其中服务器地址字段为 http://ourserver，用户名字段为 Tommy：

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy"

此参数只与 Windows 身份验证和基本身份验证相关。 可使用 AuthenticationType 参数选择身份验证方法。

表示特定的密码。

下面的示例显示 XProtect Smart Client 的登录窗口，其中服务器地址字段为 http://ourserver，用户名字段为 Tommy，密码字段为 T0mMy5Pa55w0rD：

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy" -Password="T0mMy5Pa55w0rD"

此参数只与 Windows 身份验证和基本身份验证相关。 可使用 AuthenticationType 参数选择身份验证方法。

表示 XProtect Smart Client 三种身份验证方法中的一种：Windows 身份验证（当前用户）（在启动脚本中称为 WindowsDefault）、Windows 身份验证（在启动脚本中称为 Windows）或基本身份验证（在启动脚本中称为 Simple）。

下面的示例显示 XProtect Smart Client 的登录窗口，其中服务器地址字段为 http://ourserver，身份验证字段为基本身份验证，用户名字段为 Tommy，密码字段为 T0mMy5Pa55w0rD（显示为星号）：

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy" -Password="T0mMy5Pa55w0rD" -AuthenticationType="Simple"

如果使用 Windows 身份验证，则示例为：

Client.exe -ServerAddress="http://ourserver" -UserName="Tommy" -Password="T0mMy5Pa55w0rD" -AuthenticationType="Windows"

如果使用 Windows 身份验证（当前用户），则不需要指定 UserName 和 Password 参数，示例应为：

Client.exe -ServerAddress="http://ourserver" -AuthenticationType="WindowsDefault"

表示 .scs 脚本（用于控制 XProtect Smart Client 的脚本类型）的完整路径。

以下是使用 .scs 脚本登录的示例：

Client.exe -Script=c:\startup.scs

使用 .scs 脚本以当前 Windows 用户登录 http://ourserver 的示例：

<ScriptEngine>

 <Login>

   <ServerAddress>http://ourserver</ServerAddress>

   <AuthenticationType>WindowsDefault</AuthenticationType>

 </Login>

</ScriptEngine>

可使用大量 XProtect Smart Client 函数调用（请参阅查看函数调用列表）向 .scs 脚本添加更多功能。在以下示例中，我们在脚本中加入一行，以使以前示例中的 .scs 脚本同样可以最小化 XProtect Smart Client 应用程序：

<ScriptEngine>

 <Login>

   <ServerAddress>http://ourserver</ServerAddress>

   <AuthenticationType>WindowsDefault</AuthenticationType>

 </Login>

 <Script>SCS. Application.Minimize();</Script>

</ScriptEngine>

有效的参数格式为：

{-,/,--}参数{ ,=,:}((",')值(",'))

示例：

-UserName Tommy

--UserName Tommy /UserName:"Tommy" /UserName=Tommy -Password 'Tommy'

导航脚本 HTML 页面

您可以使用指令檔建立 HTML 頁面，以方便您在檢視之間切換。HTML 頁面可新增至您的檢視，因此該頁面可與您的攝影機中的視訊一起顯示。

範例： 在 HTML 頁面中，您可以插入一個可點選的建築物平面圖，操作員僅需按一下平面圖的某個部分，便可立即切換至特定的檢視，此檢視顯示該建築物部分中的視訊。

  • 如果您的 XProtect VMS 系統支援 Smart Client 設定檔，您必須啟用 Smart Client 中所需的 XProtect Management Client 設定檔中的 HTML 指令檔。
  • 如果您的 XProtect VMS 系統不支援 Smart Client 設定檔，您必須啟用 Client.exe.config 檔案中的 HTML 指令檔。

您將看到下列針對 XProtect Smart Client 導覽的 HTML 頁面：

  • 一个带有按钮的简单 HTML 页面
  • 一个带有可单击图像映射的更高级 HTML 页面
  • 一个供系统管理员使用的检查表，它列出了创建 HTML 页面并将其分发给 XProtect Smart Client 操作员所涉及的任务

一种非常快捷的解决方案是创建带有导航按钮的 HTML 页面。可在 HTML 页面上创建各种按钮。在本例中，只创建两种类型的按钮：

  • 用于切换 XProtect Smart Client 的视图的按钮

    所需的 HTML 语句：

    <input type="button" value=" Buttontext" onclick="SCS. Views.SelectView('Viewstatus.Groupname. Viewname');">

    其中 Viewstatus 表示视图是共享视图还是私有视图（如果要向多个用户分发 HTML 页面，则必定是共享视图）。

    实际按钮示例：

    <input type="button" value="Go to Shared Group1 View2" onclick="SCS. Views.SelectView('Shared.Group1. View2');">

    此按钮允许用户在称为 Group1 的共享组中进入称为 View2 的视图。

    用于在选项卡之间切换的按钮：实时和播放 请记住，根据用户权限的不同，某些用户可能无法访问所有选项卡。

    所需的 HTML 语句：

    实时选项卡：<input type="button" value="Buttontext" onclick="SCS. Application.ShowLive();">

    播放选项卡：<input type="button" value="Buttontext" onclick="SCS. Application.ShowBrowse();">

高级用户可在 XProtect Smart Client 中使用约 100 种不同类型的函数调用，创建大量其他类型的按钮。

在下例中，我们在 XProtect Smart Client 中创建了两个共享组。将它们分别命名为 Group1 和 Group2。每个组包含两个视图，名称分别为 View1 和 View2。

我们还创建了一个带按钮的 HTML 页面，允许用户在上述四个不同视图之间以及 XProtect Smart Client 的两个选项卡（实时和播放）之间进行切换。在浏览器中查看此 HTML 页面时，其显示效果如下：

带有视图和选项卡导航按钮的 HTML 页面

我们将 HTML 页面在本地保存，本例保存在用户的 C: 盘。本機儲存用於導覽的 HTML 頁面是必要的，便於在相容模式下打開 HTML 頁面。另請參閱網頁屬性。

在本地保存 HTML 页面时，请将其保存在路径唯一的位置，例如保存在用户 C: 盘中的文件夹内（示例：C:\ myfolder\file.htm）。由于 Windows 构造用户的桌面或我的文档文件夹路径的方式方面的原因，如果将 HTML 页面保存在这些位置，此页面将无法正常工作）。

然后，我们将 HTML 页面导入所需的 XProtect Smart Client 视图中。

也可创建带有更多高级内容的 HTML 页面，如创建一个让用户能切换视图的图像地图。

在下例中，我们保留了上例的两个组和两个视图。不再使用按钮，而是创建了一个带有平面图图像的 HTML 页面，并基于此平面图创建一个图像地图。在浏览器中查看此 HTML 页面时，其显示效果如下：

带有视图导航式图像地图的 HTML 页面

在本例中，我们将此平面图划分为四个彩色区域，并将每个区域定义为一个图像地图区域。用户可单击区域以转到显示该区域的摄像机的视图。

例如，我们图像地图上的红色区域映射上例中的 Go to Shared Group2 View2 按钮。如果您按一下紅色區域，會移至 Group2 中的 View2。

在 XProtect Smart Client 中，将 HTML 导航页面导入视图的原理与将其他任何类型的 HTML 页面导入视图的原理并无差别。 請參閱將網頁新增至檢視。

  • HTML 页面应存储在操作员的本地计算机上
  • 为了使导航正常工作，您可能需要将 HTML 页面导入若干个视图中

要创建 HTML 导航页面并向 XProtect Smart Client 操作员分发，请执行以下操作：

  1. 创建所需的 HTML 页面。HTML 页面中的导航控件必须与用户在 XProtect Smart Client 中看到的视图相匹配。舉例來說，為了使 View1 的按鈕可用，使用者的 XProtect Smart Client 安裝必須存在名為 View1 的檢視。如果要向一组用户发布 HTML 页面，应将使用该 HTML 页面的视图放在共享组中。
  2. 将 HTML 页面保存在使用该页面的所有本地计算机上。在本地保存 HTML 页面时，请将其保存在路径唯一的位置，例如保存在用户 C: 盘中的文件夹内（示例：C:\ myfolder\file.htm）。由于 Windows 构造用户的桌面或我的文档文件夹路径的方式方面的原因，如果将 HTML 页面保存在这些位置，此页面将无法正常工作）。
  3. 将 HTML 页面导入XProtect Smart Client 中所需的视图中。 請參閱將網頁新增至檢視。
  4. 测试导入的 HTML 页面上的导航控件是否能正常工作。

如需疑難排解的相關資訊，請參閱網頁 (疑難排解)。