UniPRT_Cloud SDK

歡迎使用 SDK 文件

歡迎使用 SDK 文件！本指南將幫助您開始使用我們的 SDK，並提供關鍵類別和功能的鏈接。

快速開始

要開始，請參考以下關鍵類別：

通訊：

• MqttComm

備註

請不要呼叫未在文件中說明的方法或類別。

概覽

我們的 SDK 提供了一整套工具，幫助您將功能整合到您的應用程式中。請閱讀我們的範例程式碼，您將會看到 SDK 的主要類別以及其運作方式的簡要概述。

希望本指南能幫助您快速上手。如果您有任何問題或需要進一步幫助，請參考詳細指南或聯絡我們的支援團隊。

1. 讓印表機透過 Wi-Fi 連接至網際網路。
   
2. 打開瀏覽器並輸入面板上顯示的 IP 位址。
   
   

   面板
   
   
3. 選擇「檔案管理器」，並上傳 "ca.crt, client.crt, client.key" 檔案。
   
   

   選擇檔案管理器並上傳檔案
   
   
4. 選擇「MQTT 設定」。
   
   

   選擇 MQTT 設定
   
   
5. 填寫空白並點擊「設定」按鈕。
   

填寫資訊

在 Visual Studio Code 中匯入 SDK

1. 將 SDK 套件下載到您的本機目錄。
   
2. 建立一個 Visual Studio Code 專案。
   
3. 將 UniPRT_Cloud-1.0.0-py3-none-any.whl 加入到專案檔案中。
   
4. 使用指令建立虛擬環境：
   

   python -m venv ENVNAME

5. 使用指令啟動虛擬環境：
   linux/macOS:

   source myenv/bin/activate

   PowerShell(Windows)：

   .\ENVNAME\Scripts\Activate

   CMD(Windows):

   ENVNAME\Scripts\activate.bat

6. 使用指令安裝 SDK 套件：
   

   pip install UniPRT_Cloud-1.0.0-py3-none-any.whl

7. 在專案中匯入 MQTTSDK：
   

   from UniPRT_Cloud.Comm.MqttComm import MqttComm

TSC Topic 字首設定

此 Topic 結構允許使用者自訂字首，以便更靈活地進行整合。

Topic 結構

Topic 遵循以下格式：

{Tenant ID}/{Topic Prefix}/{Topic Subject}/{Agent ID} 

備註

若要連線至 TSC CloudConnect，Topic需設置為 TSCCloudConnect

其中 Topic Subject 包含：

• request/json
• status/json
• response/json
• alert/json

範例

若某租戶的 ID 為 02bfda5a55d15f29214b99287a4e623f，使用的 Topic 字首為 CloudConnect，且 Topic 內容為 status/json，裝置為 MH241-ABC-123，則完整 Topic 為：

02bfda5a55d15f29214b99287a4e623f/CloudConnect/clients/status/json/MH241-ABC-123

技術支援

若遇到任何問題或需要進一步協助，請聯絡我們的支援團隊。

---

祝您編碼愉快！

TSC