SoftControl 使用手冊

明確自己目前是日常使用者還是系統設定者。

1. 如果你只負責開館、閉館、播放控制與燈光控制，重點閱讀第 3 章與第 8 章。
2. 如果你需要建立設備、輸入指令、設計頁面、設定定時任務與授權，建議完整閱讀本手冊。
3. 如果你同時負責交付與培訓，請先準備設備位址表與專案交接表。

• 你已經知道自己接下來要進入前台介面還是後台管理。
• 你已經準備好設備清單，而不是邊操作邊找參數。

• 還沒整理好設備參數就直接進入編輯器做頁面。
• 把前台值班人員訓練成可修改設定的管理員。

整理出一份可直接用於輸入指令的實施資料。

1. 整理每台設備的名稱、品牌、型號、所在位置與用途。
2. 記錄每台設備使用的控制方式，例如 UDP、TCP、PJLink、串口、WOL、Modbus TCP、Modbus RTU。
3. 網路設備要記錄 IP、埠號、是否需要回應、是否需要延時。
4. 串口設備要記錄 COM 埠、鮑率、資料位、停止位與校驗方式。
5. 依區域或流程把設備分類，例如入口區、大廳區、投影系統、燈光系統、閉館流程。

• 你已能回答每台設備應該如何被控制。
• 你已能把設備按頁面或流程拆開，而不是全部放在同一頁。

• 建議用 Excel 或表格維護設備位址表，內容至少包含設備名、協議、位址、埠號與備註。
• 若後續要與第三方系統聯動，請先統一介面 ID 命名規則。

確認安裝環境可用，避免把運行問題誤判為設定問題。

1. Windows 版先解壓安裝包，再確認 Visual C++ 執行環境已安裝完整。
2. Android 版第一次啟動時，請讓應用程式完成初始化。
3. 進入首頁後，確認可以看到「進入系統」與「後台管理」入口。
4. 讓系統先自動生成預設設定，不要一開始就手動覆蓋設定目錄。
5. 進入系統資訊頁，確認設備 ID、版本與授權狀態能正常顯示。

• 首頁顯示正常，沒有白屏或啟動閃退。
• 系統資訊頁可看到設備 ID，表示授權識別鏈路正常。

SoftControl 會把頁面、元件、指令與分組資料保存在設定目錄。首次生成成功後，後續所有修改都會圍繞這些檔案進行。

用最少返工成本完成第一個專案。

1. 進入後台管理，先確認語言與授權狀態。
2. 到指令管理逐條建立並測試單設備指令。
3. 把需要順序執行的動作整理成指令組，例如一鍵開館、一鍵閉館。
4. 進入可視化編輯器，建立頁面並決定頁面名稱與背景圖。
5. 加入按鈕與文字元件，逐一綁定頁面跳轉、指令列表或控制組。
6. 儲存後切回前台運行，逐頁測試每個按鈕。
7. 主流程穩定後，再設定定時任務與第三方聯動。
8. 最後匯出設定並保留交付備份。

• 你已經建立從底層指令到前台介面的實施順序。
• 不會再出現頁面做好了、但指令還沒完成的返工情況。

透過最小專案學會完整流程。

1. 首頁放進入系統、一鍵開館、一鍵閉館、後台管理等核心入口。
2. 設備控制頁放投影機、主機、播放器等設備的開機與關機按鈕。
3. 燈光控制頁放全開、全關以及 1 到 2 個單路控制按鈕。
4. 加上返回按鈕，讓頁面路徑清楚。
5. 先確保功能正確，再做視覺優化。

• 第一次練習應優先確保按鈕真的能控制設備，而不是追求畫面複雜。
• 如果一個按鈕要控制多台設備，優先使用指令組。

• 第一次就做十幾個頁面，結果頁面越多錯誤越多。
• 還沒完成最小閉環就開始做大量美工。

完成一次安全的開館流程。

1. 進入首頁，確認沒有授權到期提示或明顯錯誤訊息。
2. 先執行一鍵開館；如果專案未設定一鍵開館，則依頁面逐項操作。
3. 若要手動操作，建議順序為主機 -> 投影 -> 播放器 -> 燈光 -> 其他環境設備。
4. 點擊按鈕後請等待設備實際反應，不要連續重複點擊。
5. 開館完成後，到主要區域確認畫面、燈光與聲音都符合預期。

• 投影設備已開機並輸出正確畫面。
• 需要播放的內容已啟動，燈光狀態符合開館標準。

• 投影尚未完全啟動就切換訊號或發送播放指令。
• 看到設備沒有立即反應就反覆點擊同一按鈕。

完成一次穩定的閉館流程。

1. 先停止播放內容或切回待機內容。
2. 關閉燈光或切換到閉館燈光場景。
3. 關閉投影機，等待投影機進入關機流程。
4. 最後關閉主機與其他可延後關閉的設備。
5. 即使專案有一鍵閉館，也要人工確認關鍵設備是否都已關閉。

• 播放器已停止或回到預設待機畫面。
• 投影、燈光、主機等設備都已進入閉館狀態。

• 若主機需要正常關機時間，可把主機關機命令放在最後並加入延時。
• 閉館後建議再巡視一次現場。

掌握前台頁面的通用操作方式。

1. 頁面跳轉按鈕通常用於進入某個區域、返回選單或返回首頁。
2. 播放控制頁常見按鈕包含播放、暫停、停止、靜音、音量加減與內容切換。
3. 燈光控制頁通常分為全開/全關與單路控制；批量控制用於流程，單路控制用於補調。
4. 每次操作後都要觀察設備實際狀態，不要只看按鈕是否被點擊。
5. 如按鈕沒有即時反應，請先等待 1 到 3 秒。

• 你能依頁面結構快速找到需要的按鈕。
• 你知道操作後應該看設備、畫面、燈光或音響哪個結果來判斷成功。

前台值班人員不建議進入後台管理，也不建議修改頁面、指令或授權。

成功進入後台，並知道常用模組在哪裡。

1. 在首頁點擊後台管理按鈕。
2. 輸入後台密碼；正式專案請盡快更改預設密碼。
3. 進入後先認識核心模組：可視化編輯器、指令管理、指令組、定時器、設定管理、授權管理、日誌、網路診斷。

• 你已能正常進入後台首頁。
• 你知道之後如果要改頁面、改指令、查日誌，應進入哪個模組。

• 前台正在使用時直接進入後台並修改專案。
• 交付後仍使用預設密碼。

完成後台的首次安全初始化。

1. 先到系統資訊或授權管理確認目前是試用版還是正式版。
2. 如果專案是正式交付，優先匯入授權檔案。
3. 進入語言設定，把介面調整成實施人員與客戶都看得懂的語言。
4. 立即修改後台密碼，並把新密碼記錄在專案交接文件。

• 授權狀態、設備 ID、版本資訊已確認。
• 後台密碼已不是預設密碼。

• 如果現場有多位維護人員，建議統一密碼管理方式。
• 即使是試用環境，也建議先了解功能限制。

知道什麼情況是授權限制，什麼情況是真正故障。

1. 在授權管理中查看設備 ID，必要時提供給供應商申請授權。
2. 收到授權檔後，使用匯入授權功能導入。
3. 匯入後再次確認授權狀態是否已更新，受限功能是否已開啟。
4. 若授權到期，請先處理授權，再排查頁面或定時器。

• 你知道目前專案是否可使用定時器、設定匯出與完整編輯能力。
• 你能區分授權限制與設定錯誤。

授權到期時，前台運行與定時器可能都會受影響。

建立一條可以被單獨測試且穩定成功的指令。

1. 進入指令管理，新增指令。
2. 使用設備名加動作名的方式命名，例如投影1_開機。
3. 選擇正確協議：UDP、TCP、PJLink、串口、WOL、Modbus TCP 或 Modbus RTU。
4. 輸入目標位址；網路協議填設備 IP，串口協議填 COM 埠。
5. 輸入埠號或鮑率，並依需要設定延時、逾時、重試與回應等待。
6. 儲存後先單獨測試這條指令，再決定是否綁到頁面按鈕。

• 單條指令測試後，設備能產生正確動作。
• 日誌頁能看到對應執行記錄。

• 指令名稱寫得太模糊，後期無法分辨是哪台設備。
• 指令尚未測試成功就直接綁定到頁面。

用固定順序排查，而不是靠猜測。

1. 先確認設備有上電、在線，且處於可接受控制的狀態。
2. 核對協議類型是否正確。
3. 核對 IP、埠號、COM 埠、鮑率與設備表是否一致。
4. 檢查指令文字格式、大小寫、空格與結尾符。
5. 若設備啟動慢，適當增加延時。
6. 到日誌頁確認系統是否真的發出了指令。
7. 必要時使用網路診斷檢查位址可達性。

• 你已能把問題縮小到連線、參數或頁面綁定其中一類。
• 你正在使用日誌與診斷工具，而不是重複猜測。

• 對會回應資料的 TCP 設備，開啟等待回應有助於聯調。
• 先讓每條單指令穩定，再去做複合流程。

在正確場景使用正確能力。

1. 當一個按鈕需要連續執行多個設備動作時，使用指令組。
2. 一鍵開館、一鍵閉館、會議模式、展示模式等，都優先用指令組。
3. 專案包含 PLC、感測器或狀態輪詢時，使用 Modbus 點位管理。
4. 需要讓 SoftPlayer 或其他系統遠端觸發按鈕時，為元件設定外部介面 ID。

• 你已清楚單條指令與流程指令組的分工。
• 不會把狀態採集、頁面邏輯與外部介面混在一起。

預設外部介面埠號為 UDP 8818 與 TCP 8819，介面 ID 必須唯一且只能使用英數字。

建立一套符合實際流程的頁面結構。

1. 進入可視化編輯器後，先查看左側頁面列表。
2. 優先建立首頁、選單頁與各功能頁。
3. 頁面名稱要直接反映用途，例如首頁、設備控制、燈光控制、投影控制。
4. 選中頁面後，再為該頁選擇背景圖。
5. 如果背景圖尚未準備好，可先完成功能配置，再補美術素材。

• 你能不打開頁面就說明每個頁面的用途。
• 整個專案的頁面結構已經清楚。

• 頁面名稱寫成頁面1、控制頁2等無法辨識的名字。
• 還沒決定頁面結構就先堆大量按鈕。

在頁面上放出清楚且可維護的佈局。

1. 在選中的頁面中新增元件。
2. 標題、說明與提示語優先使用文字元件。
3. 所有可操作項目使用按鈕元件，且同類按鈕保持一致樣式。
4. 先用拖曳擺放位置，再用方向鍵微調。
5. 需要重複樣式時可使用複製貼上。

• 使用者一眼就能看出哪些是資訊、哪些是可操作按鈕。
• 同類按鈕在尺寸與視覺上保持一致。

• 首頁按鈕建議少而大，功能頁按區域或流程分組。
• 返回按鈕固定在一致位置，可降低誤操作。

讓頁面上的每個按鈕都可預測、可測試、可維護。

1. 選中按鈕，在屬性面板中打開動作設定。
2. 若要跳頁，選擇頁面跳轉並指定正確目標頁。
3. 若要顯示提示，選擇顯示文字並填入內容。
4. 若要直接控設備，選擇執行指令並綁定正確的指令列表。
5. 若要執行流程，如一鍵開館，優先使用已驗證的控制組或指令組。
6. 每綁完一個按鈕，都立即進入預覽或前台測試。

• 你能清楚說明每個按鈕點下去會發生什麼。
• 按鈕名稱與綁定動作彼此一致。

• 標示為開館的按鈕，實際卻跳到了錯誤頁面。
• 多個按鈕名稱過於相似，後續排查困難。

建立修改一項、驗證一項的工作習慣。

1. 每完成一頁的核心按鈕後，先進行預覽。
2. 預覽通過後再儲存，不要累積大量未驗證變更。
3. 回到前台運行，走一遍主要使用流程。
4. 確認這一頁穩定後，再進入下一頁或進行備份。

• 修改後的頁面在前台能按預期使用。
• 你不是等全部做完才一次性測試。

可視化編輯器支援撤銷、刪除、複製與預覽。版面出現混亂時，先回退到正確狀態再繼續修改。

讓固定流程自動執行，同時避免建立隱藏風險。

1. 進入定時器管理，先查看現有任務，避免重複建立。
2. 用清楚的名稱命名任務，例如每日開館 08:30。
3. 設定觸發時間與規則。
4. 執行動作建議優先重用已驗證過的按鈕或指令組。
5. 正式啟用前，先用手動觸發測試一次。
6. 啟用後查看執行歷史，確認排程確實運作。

• 手動觸發能成功。
• 執行歷史能看到任務已被啟用並執行。

• 把尚未驗證的新指令直接丟進定時任務。
• 沒有先確認授權就誤判定時器故障。

確保專案可恢復、可複製、可交接。

1. 在專案達到重要節點時立即匯出一次設定備份。
2. 至少保留頁面、元件、指令、指令組、元件組與 Modbus 點位資料。
3. 在備用環境匯入一次備份，確認可以成功恢復。
4. 換設備時先匯入設定，再核對網路位址、串口設定與授權是否匹配。
5. 保留一份最終驗收版與一份可回滾版。

• 你手上有已驗證可恢復的備份，不只是正在運行的現場設備。
• 備份已在另一套環境中測試可用。

• 重大修改前先備份一次，可大幅降低誤改風險。
• 遷移後優先檢查 IP、COM 埠與授權。

交付一套別人也能接手維護的系統。

1. 聯調時保持日誌頁開啟，觀察關鍵按鈕是成功還是失敗。
2. 對網路設備，同時使用網路診斷檢查連通性。
3. 整理開館、閉館、緊急停止、恢復預設等流程的交接清單。
4. 把後台密碼、授權狀態、設備位址表、備份位置與日常操作說明一併交付。
5. 培訓時讓客戶親自做一次完整開館與閉館流程。

• 你交付的不只是介面，還包括維護資料。
• 客戶知道授權、日誌與診斷頁在什麼位置。

成熟專案的標準，是後續接手的人看資料後也能維護，而不是只能依賴原實施人員。

判斷問題在按鈕、指令、網路還是設備本身。

1. 先看日誌頁，確認按鈕點擊後是否有執行記錄。
2. 若沒有日誌，問題多半在頁面綁定或動作設定。
3. 若有日誌但失敗，繼續檢查協議、位址、埠號、指令文字與設備狀態。
4. 若設備走網路控制，再使用網路診斷檢查位址是否可達。
5. 若設備走串口控制，確認 COM 埠正確且未被其他程式占用。

• 你已能把問題縮小到頁面綁定、指令參數或設備連線其中一類。
• 你不是靠重做頁面來嘗試解決問題。

快速恢復頁面結構的清楚與一致。

1. 回到可視化編輯器，先檢查按鈕名稱是否與用途一致。
2. 確認動作類型到底是頁面跳轉、執行指令還是控制組。
3. 若跳頁錯誤，直接修正目標頁設定。
4. 若多個按鈕名稱含糊，先統一重命名再測試。
5. 每次修正後立刻預覽，不要一次改太多。

• 按鈕與頁面只要命名清楚，就能避免大部分誤操作與後續維護成本。
• 首頁、選單頁與返回路徑最好固定一致。

遇到系統級問題時，先找到正確入口。

1. 如果系統提示授權到期或功能受限，先進入授權管理，不要先改頁面。
2. 如果定時器沒有執行，先確認授權是否支援，再看任務是否啟用與是否有執行歷史。
3. 如果換設備後專案行為不同，先確認設定是否完整匯入，再核對網路、串口與授權是否匹配新設備。
4. 如果系統啟動後像是回到預設值，優先確認設定目錄與實際讀取位置。

• 你知道授權問題、定時器問題、遷移問題各自應該去哪裡檢查。
• 你不會把所有系統級問題都歸類為軟體不穩定。