裝置
您可以在裝置中新增、編輯、啟動、停用及刪除交易裝置。可設定交易裝置的連線方式,針對交易資料設定過濾條件,以及配對攝影機和資料疊合於影像上的樣式。
新增裝置
若要新增裝置:
- 按一下新增。新增裝置視窗將開啟。
- 在名稱欄位中輸入可辨識此裝置的名稱。
- 從交易來源下拉式選單選擇下列任一種連接方式:
- POS:此選項僅為辨識裝置使用,不影響實際運作。
- 第三方軟體:此選項僅為辨識裝置使用,不影響實際運作。
- AXIS 條碼:此選項將會強制連接方式使用 Surveillance Station WebAPI。請參閱下方 AXIS 條碼章節來取得更多詳細資訊。
- 從連接方式下拉式選單選擇下列任一種連接方式:
- TCP:請於IP 位址和連接埠欄位輸入資料來源的網路資訊。
- 串列埠:請確認所有設定都和連接來源一致。
- Surveillance Station WebAPI:可填寫 IP 位址與連接埠來檢查連接狀態。這些為非必填欄位,但是錯誤的設定可能會導致連線失敗或其他問題。請參閱下方 Surveillance Station Web API 章節取得更多詳細資訊。
- 按一下下一步來繼續進行資料定義的設定,若連接方式選用 Surveillance Station WebAPI 則跳至顯示的設定。
- 選擇正確的編碼方式,**確認開始接收原始資料為開啟狀態後,於裝置端輸入資料,此時將接收到的資料顯示於原始資料的欄位內。
- 請設定交易開始和結束的規則。
- 您可以透過右上角的按鈕新增過濾規則,將字元忽略,或是換成斷行和其他字元。
- 過濾的結果會直接顯示於已過濾資料的欄位內。並會將對應的資料標示於原始資料內。
- 按一下下一步來繼續進行顯示的設定。
- 從配對攝影機中選擇是否要針對此裝置設定配對攝影機。
- 從螢幕資訊顯示設定在即時影像和錄影片段上,交易資料的顯示方式。
- 按一下完成來完成設定。
注意:
- 裝置名稱有區分大小寫。可設定 1 到 32 個 Unicode 字元,但不可為下列字元:
! " # $ % & ' ( ) * + , / : ; < = > ? @ [ ] \ ^ ` { } | ~
- 如編碼的列表中沒有您所使用的編碼方式,您也可以手動輸入。
- 針對過濾條件,如果想要過濾控制字元,請用 "<" 和 ">" 包起來。
- 編碼方式或過濾條件設定不正確時,會無法記錄交易資料。在資料定義頁面中,能夠被正確過濾的資料在原始資料會顯示為粗體,並呈現於已過濾資料。
- 設定配對攝影機可於即時影像上看到攝影機和交易資料,並會錄製相關的錄影片段。
編輯裝置
若要編輯裝置設定:
- 選擇您要更改設定的裝置,然後按一下編輯。您也可以在裝置上連按兩下來更改設定。
- 在事件頁面設定使用者自定義事件,此事件可用於行動規則、即時影像警報,及事件通知中。
- 在進階頁面設定忽略交易開始、交易結束或交易取消對應到的文字,被忽略的文字不會被儲存在交易資料內,也不會出現在和即時影像疊合的文字裡。
- 在進階頁面設定與即時影像疊合的文字的消失時機。可以設定若一直沒有產生文字資料,疊合的文字會在畫面上保留的秒數。也可以設定在新交易開始或收到特定文字時,清除疊合的文字。
- 按一下完成來儲存變更。
啟動或停用裝置
新增的裝置必須在啟動後才能管理和執行所有支援的行動。
若要啟動或停用裝置:
- 選取您要啟動或停用的裝置,並從啟動下拉式選單中按一下啟動或停用。
刪除裝置
- 選擇您要刪除的裝置,然後按一下刪除。
- 您將會看到確認視窗。選擇是否保留此裝置的交易資料後,按一下是來繼續。
注意:
- 刪除裝置時,如選擇刪除全部交易資料,會將鎖定的交易資料也一併從 Surveillance Station 中永久移除。
Surveillance Station WebAPI
Surveillance Station WebAPI 提供您更便利的交易裝置連結方式,透過使用符合規範的格式發送 WebAPI, Surveillance Station 能協助您記錄交易資料。
發送 Surveillance Station WebAPI 規範格式:
- API:SYNO.SurveillanceStation.Transactions 提供以下五種指令 (Insert、Begin、Complete、Cancel 及 AppendData) 來記錄交易資料:
Insert:
通知 Surveillance Station 新增一筆交易,且該筆交易狀態為完成。包含以下參數:
- dsName:字串形態,非必需的,交易裝置所在的 CMS 錄影伺服器名稱。
- deviceName:字串形態,在 Surveillance Station 上的交易裝置名稱。
- content:字串形態,整筆交易的內容。
- format:字串型態,交易資料的格式,json 表示交易內容為 JSON 格式,string 代表交易內容為純文字。
- timestamp:整數型態,非必需的,1970 年 1 月 1 日 0 時 0 分 0 秒起至交易發生時間的總秒數。
- account:字串型態,非必需的,使用者帳號。
- password:字串型態,非必需的,密碼。
Begin:
通知 Surveillance Station 開始記錄一筆交易。包含以下參數:
- dsName:字串形態,非必需的,交易裝置所在的 CMS 錄影伺服器名稱。
- deviceName:字串形態,在 Surveillance Station 上的交易裝置名稱。
- sessionId:字串形態,交易代碼。
- timeout:整數型態,交易時間上限 (秒),超過時間將自動結束該筆交易。
- timestamp:整數型態,非必需的,1970 年 1 月 1 日 0 時 0 分 0 秒起至交易開始時間的總秒數。
- account:字串型態,非必需的,使用者帳號。
- password:字串型態,非必需的,密碼。
Complete:
通知 Surveillance Station 結束記錄一筆交易,且該筆交易狀態為完成。包含以下參數:
- dsName:字串形態,非必需的,交易裝置所在的 CMS 錄影伺服器名稱。
- deviceName:字串形態,在 Surveillance Station 上的交易裝置名稱。
- sessionId:字串形態,交易代碼。
- timestamp:整數型態,非必需的,1970年 1 月 1 日 0 時 0 分 0 秒起至交易完成時間的總秒數。
- account:字串型態,非必需的,使用者帳號。
- password:字串型態,非必需的,密碼。
Cancel:
通知 Surveillance Station 結束記錄一筆交易,且該筆交易狀態為取消。包含以下參數:
- dsName:字串形態,非必需的,交易裝置所在的 CMS 錄影伺服器名稱。
- deviceName:字串形態,在 Surveillance Station 上的交易裝置名稱。
- sessionId:字串形態,交易代碼。
- timestamp:整數型態,非必需的,1970 年 1 月 1 日 0 時 0 分 0 秒起至交易取消時間的總秒數。
- account:字串型態,非必需的,使用者帳號。
- password:字串型態,非必需的,密碼。
AppendData:
通知 Surveillance Station 記錄一筆交易的內容。包含以下參數:
- dsName:字串形態,非必需的,交易裝置所在的 CMS 錄影伺服器名稱。
- deviceName:字串形態,在 Surveillance Station 上的交易裝置名稱。
- sessionId:字串形態,交易代碼。
- content:字串形態,交易內容,每次進來的資料是獨立的一行,但資料中可使用 \n 進行換行。
- timestamp:整數型態,非必需的,1970 年 1 月 1 日 0 時 0 分 0 秒起至交易內容產生時間的總秒數。
- account:字串型態,非必需的,使用者帳號。
- password:字串型態,非必需的,密碼。
- 基本請求格式:http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="{指令名稱}"&version=2&deviceName="{交易裝置名稱}"&sessionId="{交易代碼}"。
Web API 請求的範例:
- 開始交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Begin"&version=2&deviceName="POS01"&sessionId="1"&timeout=300
- 記錄交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=2&deviceName="POS01"&sessionId="1"&content="Start\n2017/01/01"
- 記錄交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=2&deviceName="POS01"&sessionId="1"&content="Pen $40\nBook $300"
- 記錄交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=2&deviceName="POS01"&sessionId="1"&content="Total $340\nEnd"
- 完成交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Complete"&version=2&deviceName="POS01"&sessionId="1"
注意:
- 在發送 Surveillance Station WebAPI 請求前需先進行登入,或在參數中加上 account 和 password。詳細的登入方法請參閱 Web API 文件。
- 若您的 Synology NAS 為 CMS 架構下的主伺服器,可以加上 dsName 參數,指定交易裝置所在的 CMS 錄影伺服器。如果沒有指定 dsName,搜尋交易裝置時,會優先選擇 CMS 主伺服器上名稱符合的交易裝置,再搜尋 CMS 錄影伺服器上名稱符合的交易裝置。如果在兩台以上 CMS 錄影伺服器有名稱符合的交易裝置,也沒有使用 dsName 指定交易裝置所在的 CMS 錄影伺服器,指令將被忽略。
- sessionId 用於區分不同交易事件,相同的 deviceName 和 sessionId 將視為同一筆記錄,其間若再次使用相同的參數發送 Begin 指令將被忽略,直到交易完成、取消或超過交易時間上限。之後,sessionId 便可再重複使用。
- 開始交易後,若在超過交易時間上限之前仍未收到 Complete 或 Cancel 指令,將儲存交易記錄並標記為 Incomplete。
AXIS 條碼
若要將 AXIS 條碼設定為交易裝置的來源:
- 新增一台以 AXIS 條碼作為資料來源的交易裝置。
- 於支援 ACAP 的攝影機安裝 AXIS Barcode Reader 及 AXIS Barcode to Synology Surveillance Station。
- 開啟攝影機的 ACAP 設定頁面,調整 AXIS Barcode Reader 的設定,設置您想要掃描的條碼類型。
- 在 ACAP 設定頁面中尋找 AXIS Barcode to Synology Surveillance Station 的設定頁面,設置您的 Synology NAS 的位址、使用者帳號、密碼、交易裝置名稱等資訊。