裝置
您可以在裝置中新增、編輯、啟動、停用及刪除交易裝置。可設定交易裝置的連線方式,針對交易資料設定過濾條件,以及配對攝影機和資料疊合於影像上的樣式。
新增裝置
若要新增裝置:
- 按一下新增。新增裝置視窗將開啟。
- 在名稱欄位中輸入可辨識此裝置的名稱。
- 從交易來源下拉式選單選擇交易來源。交易來源為辨識裝置的一種方式,不影響實際運作。
- 從連接方式下拉式選單選擇下列任一種連接方式:
- 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 提供以下四種指令 (Begin、Complete、Cancel 及 AppendData) 來記錄交易資料:
Begin:
通知 Surveillance Station 開始記錄一筆交易。包含以下參數:
- device_name:字串形態,在 Surveillance Station 上的交易裝置名稱。
- session_id:字串形態,交易代碼。
- timeout:整數型態,交易時間上限(秒),超過時間將自動結束該筆交易。
Complete:
通知 Surveillance Station 結束記錄一筆交易,且該筆交易狀態為完成。包含以下參數:
- device_name:字串形態,在 Surveillance Station 上的交易裝置名稱。
- session_id:字串形態,交易代碼。
Cancel:
通知 Surveillance Station 結束記錄一筆交易,且該筆交易狀態為取消。包含以下參數:
- device_name:字串形態,在 Surveillance Station 上的交易裝置名稱。
- session_id:字串形態,交易代碼。
AppendData:
通知 Surveillance Station 記錄一筆交易的內容。包含以下參數:
- device_name:字串形態,在 Surveillance Station 上的交易裝置名稱。
- session_id:字串形態,交易代碼。
- content:字串形態,交易內容,每次進來的資料是獨立的一行,但資料中可使用 \n 進行換行。
- 基本請求格式:http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="{指令名稱}"&version=1&device_name="{交易裝置名稱}"&session_id="{交易代碼}"。
Web API 請求的範例:
- 開始交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Begin"&version=1&device_name="POS01"&session_id="1"&timeout=300
- 記錄交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Start\n2017/01/01"
- 記錄交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Pen $40\nBook $300"
- 記錄交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="AppendData"&version=1&device_name="POS01"&session_id="1"&content="Total $340\nEnd"
- 完成交易:
http://{IP}:{Port}/webapi/entry.cgi?api=SYNO.SurveillanceStation.Transactions.Transaction&method="Complete"&version=1&device_name="POS01"&session_id="1"
注意:
- 在發送 Surveillance Station WebAPI 請求前需先進行登入,詳細的登入方法請參閱 Web API 文件。
- session_id 用於區分不同交易事件,相同的 device_name 和 session_id 將視為同一筆記錄,其間若再次使用相同的參數發送 Begin 指令將被忽略,直到交易完成、取消或超過交易時間上限。之後,session_id 便可再重複使用。
- 開始交易後,若在超過交易時間上限之前仍未收到 Complete 或 Cancel 指令,將儲存交易記錄並標記為 Incomplete。