埠口和網路行為
Insight 在正常運作期間會使用多個埠。預設埠是 SDK 容器內部或直接安裝的 DevKit 中使用的埠。在 Neat 開發環境中，SDK 會將這些服務發佈到主機埠。如果預設主機埠已經在使用中，sima-cli 可以分配另一個可用的主機埠。
| 埠對應名稱 | 預設的連接埠或範圍 | 協定 | 目的 |
|---|---|---|---|
mainUI | 9900 | HTTPS/TCP | 主要 Insight 網頁使用者介面、HTTP API 以及 HTTP MJPEG 串流來源。 |
videoUI | 8081 | HTTPS/TCP | WebRTC 視訊檢視器使用者介面。 |
rtsp.tcp | 8554 | RTSP/TCP | 從上傳的媒體建立的 RTSP 串流來源。 |
videoUDP | 9000-9079 | UDP | 將影片導入至觀眾頻道 0-79，以供 RTP 播放。 |
metadataUDP | 9100-9179 | UDP | 中繼資料 JSON 用於觀眾頻道 0-79. |
webRTC | 40000-40199 | UDP | WebRTC 媒體和中繼資料 DataChannel 從虛擬顯示器傳輸到瀏覽器。 |
webSSH | 8022 | HTTPS/TCP | 如果有的話，將瀏覽器外殼與配對的 DevKit 連接。 |
找到實際的 SDK 連接埠對應表。
在 SDK 中，請勿假設預設主機連接埠可用。請執行：
neat --json
輸出內容包含 insight.webUiUrl 以及一個 exposedPorts 陣列：
{
"exposedPorts": [
{"hostPortEnd": null, "hostPortStart": 9900, "name": "mainUI", "protocol": "tcp"},
{"hostPortEnd": 9179, "hostPortStart": 9100, "name": "metadataUDP", "protocol": "udp"},
{"hostPortEnd": null, "hostPortStart": 8554, "name": "rtsp.tcp", "protocol": "tcp"},
{"hostPortEnd": 9079, "hostPortStart": 9000, "name": "videoUDP", "protocol": "udp"},
{"hostPortEnd": null, "hostPortStart": 8081, "name": "videoUI", "protocol": "tcp"},
{"hostPortEnd": 40199, "hostPortStart": 40000, "name": "webRTC", "protocol": "udp"},
{"hostPortEnd": null, "hostPortStart": 8022, "name": "webSSH", "protocol": "tcp"}
],
"insight": {
"serviceState": "Running",
"venv": "/opt/neat-insight/venv",
"webUiUrl": "https://10.0.0.210:9900"
}
}
如果主機連接埠已重新映射，則 hostPortStart 值就是外部用戶端應使用的連接埠。hostPortEnd 則用於指定連接埠範圍，例如視訊、中繼資料和 WebRTC。
頻道對應
視訊檢 視器使用配對的視訊和中繼資料連接埠。對於頻道 N：
video: UDP 9000 + N
metadata: UDP 9100 + N
例如：
| 觀看頻道 | 視訊埠 | 中繼資料埠 |
|---|---|---|
0 | 9000 | 9100 |
1 | 9001 | 9101 |
2 | 9002 | 9102 |
請確保影片和中繼資料的頻道編號一致。如果您的應用程式將影片傳送到頻道 3，則請將對應的中繼資料傳送到頻道 3 的中繼資料端口。
SDK 埠對應
在 Neat 開發環境中，SDK 容器可能會重新映射端口。Insight 會在可用時讀取 SDK 端口映射配置，以便 UI 連結指向瀏覽器可存取的宿主端口。
這對於影片檢視器來說至關重要。內部預設檢視器端口為 8081，但當 SDK 將 videoUI 映射到另一個宿主端口時，面向瀏覽器的端口可能會有所不同。
使用 Insight UI 中的系統資訊來檢查實際暴露的端口，然後再假設 URL 錯誤。
使用連接埠對應表來設定應用程式。
使用應用程式的位置來決定是否使用預設的容器連接埠，或使用 SDK 主機公開的連接埠。
| 應用程式位置 | 來自 Insight 的 RTSP 輸入。 | 將影片/中繼資料輸出至 Insight。 |
|---|---|---|
| 在 SDK 容器內部 | rtsp://127.0.0.1:8554/srcN | 127.0.0.1:9000 + channel 和 127.0.0.1:9100 + channel |
| 在 DevKit 或其他外部機器上 | rtsp://<sdk-host-ip>:<rtsp.tcp hostPortStart>/srcN | <sdk-host-ip>:<videoUDP hostPortStart + channel> 和 <sdk-host-ip>:<metadataUDP hostPortStart + channel> |
HTTP MJPEG 來源使用主要 Insight UI/API 連接埠。在 SDK 中，對於這些 URL，請使用來自 neat --json 的 mainUI 主機連接埠。
例如，如果 neat --json 報告：
{"name": "rtsp.tcp", "hostPortStart": 18554, "protocol": "tcp"}
{"name": "videoUDP", "hostPortStart": 19000, "hostPortEnd": 19079, "protocol": "udp"}
{"name": "metadataUDP", "hostPortStart": 19100, "hostPortEnd": 19179, "protocol": "udp"}
接著，在 DevKit 上的應用程式應使用：
RTSP source src1: rtsp://<sdk-host-ip>:18554/src1
video channel 0: <sdk-host-ip>:19000
metadata channel 0: <sdk-host-ip>:19100
video channel 3: <sdk-host-ip>:19003
metadata channel 3: <sdk-host-ip>:19103
如果應用程式和 Insight 在同一個 SDK 容器中執行，請改用預設的本機連接埠。
相關工具
- Neat 開發環境 提供容器化的建置和執行環境，其中包含 Insight。
- Neat 函式庫提供應用程式介面 (API)，用於建立和執行視覺處理工作負載。
- sima-cli 會安裝和升級 Insight 套件以及其他 Neat 相關檔案。
- 模型編譯器和 LLiMa 會產生模型成品，您可以透過工作區來檢視這些成品，並透過與 Insight 一起運行的應用程式來驗證。