API / SDK / developer guide
Connections
| 目標讀者 TA | 無人機應用開發者 |
|---|---|
| 官方文件能力 | 設定與 MAVLink 系統的傳輸連線。 |
| 輸入 → 輸出 | 連線 URL → 連線結果與發現的系統。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 建立傳輸不代表自動駕駛系統可用。 |
| 本站建議驗證 | 區分傳輸錯誤、探索逾時及實際系統識別。 |
UAV／任務整合 · SDK
MAVSDK
Dronecode / MAVSDK
利用高階 API 整合支援 MAVLink 的載具。
參考使用 main／v4 文件，不保證與安裝版本相容。遙測可用不等於飛行許可；須逐一核對包裝器。
MAVSDK / DEVELOPER FIELD GUIDE
選對接口，定義可驗證的結果。
公司／專案背景、十個技術入口，以及每份引用的實作分析。
2026-10-08 · 串接尚未實測
公司／專案背景全貌
依官方公司或專案自述撰寫的原創概要；完整原文請見來源。
| 專案 | MAVSDK 提供應用與 MAVLink 系統互動的函式庫，包括載具、相機及地面系統。核心為 C++，另有語言包裝器。 |
|---|---|
| 治理與適用性 | 專案受 Dronecode 治理並由志願者維護。適合伴飛電腦與地面應用；不同語言包裝器成熟度有別。 |
| 適用角色 | 進行 AI 供應商初選的採購、合作夥伴與產品負責人。 |
|---|---|
| 本站評估 | 用定位與公司背景判斷初步適配度；另行取得專案部署、支援與商務條件。 |
已核對官方來源；未執行真實 API、推論或效能測試。預期結果為建議內部契約。
十項技術入口比較
依開發任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。
| 接口 | 用途與 TA |
|---|---|
| 01 · ConnectionsAPI / SDK / developer guide | 設定與 MAVLink 系統的傳輸連線。無人機應用開發者 |
| 02 · System/plugin selectionAPI / SDK / developer guide | 將外掛關聯至指定系統。多載具開發者 |
| 03 · System informationAPI / SDK / developer guide | 讀取版本與產品資訊。機隊整合工程師 |
| 04 · TelemetryAPI / SDK / developer guide | 透過遙測訂閱觀察載具狀態。遙測儀表板開發者 |
| 05 · Mission state and plansAPI / SDK / developer guide | 表示任務計畫並觀察任務進度。模擬器任務工具開發者 |
| 06 · Camera pluginAPI / SDK / developer guide | 存取相機資訊及相機操作。巡檢應用開發者 |
| 07 · Gimbal discovery and attitudeAPI / SDK / developer guide | 探索雲台並觀察姿態。酬載整合工程師 |
| 08 · MavlinkDirectAPI / SDK / developer guide | 以名稱及 JSON 欄位存取 MAVLink 訊息。自訂訊息整合者 |
| 09 · Heartbeat watchdogAPI / SDK / developer guide | 按應用存活性控制輸出心跳。可靠性工程師 |
| 10 · Param typed parameter APIAPI / SDK / developer guide | 讀取具型別參數並檢視可用設定。設定盤點開發者 |
逐份文件分析
能力摘要依據官方文件；限制與建議測試為本站工程評估。
API / SDK / developer guide
System/plugin selection
| 目標讀者 TA | 多載具開發者 |
|---|---|
| 官方文件能力 | 將外掛關聯至指定系統。 |
| 輸入 → 輸出 | 發現的 System → 外掛實例。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 避免將首個發現系統當成指定載具。 |
| 本站建議驗證 | 記錄系統識別與元件能力。 |
API / SDK / developer guide
System information
| 目標讀者 TA | 機隊整合工程師 |
|---|---|
| 官方文件能力 | 讀取版本與產品資訊。 |
| 輸入 → 輸出 | Info 要求 → 識別／版本結果。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 可用性取決於回應元件。 |
| 本站建議驗證 | 未知資訊保留為未知，不捏造韌體版本。 |
API / SDK / developer guide
Telemetry
| 目標讀者 TA | 遙測儀表板開發者 |
|---|---|
| 官方文件能力 | 透過遙測訂閱觀察載具狀態。 |
| 輸入 → 輸出 | 訂閱 → 位置、健康或其他具型別樣本。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 存在樣本不代表資料最新或允許飛行。 |
| 本站建議驗證 | 保留欄位單位、座標框架及接收年齡。 |
API / SDK / developer guide
Mission state and plans
| 目標讀者 TA | 模擬器任務工具開發者 |
|---|---|
| 官方文件能力 | 表示任務計畫並觀察任務進度。 |
| 輸入 → 輸出 | 任務項目／進度要求 → 計畫或進度結果。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | Mission 支援部分項目；完整項目需求可評估 MissionRaw。 |
| 本站建議驗證 | 將下載／上傳計畫與任務完成視為不同狀態。 |
API / SDK / developer guide
Camera plugin
| 目標讀者 TA | 巡檢應用開發者 |
|---|---|
| 官方文件能力 | 存取相機資訊及相機操作。 |
| 輸入 → 輸出 | 相機選擇／要求 → 相機結果或資訊。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 連線載具不一定提供相容相機。 |
| 本站建議驗證 | 分別呈現無相機與相機通訊失敗。 |
API / SDK / developer guide
Gimbal discovery and attitude
| 目標讀者 TA | 酬載整合工程師 |
|---|---|
| 官方文件能力 | 探索雲台並觀察姿態。 |
| 輸入 → 輸出 | 雲台列表／姿態訂閱 → 已識別酬載資料。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 指南適用 MAVLink Gimbal Protocol v2。 |
| 本站建議驗證 | 保留雲台 ID 及框架／模式；此示例不發送控制。 |
API / SDK / developer guide
MavlinkDirect
| 目標讀者 TA | 自訂訊息整合者 |
|---|---|
| 官方文件能力 | 以名稱及 JSON 欄位存取 MAVLink 訊息。 |
| 輸入 → 輸出 | 訊息訂閱 → fields_json 及發送者中繼資料。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 保留原生比例；NaN／無限值轉為 null。 |
| 本站建議驗證 | 套用訊息定義單位並將 null 保留為不可用。 |
API / SDK / developer guide
Heartbeat watchdog
| 目標讀者 TA | 可靠性工程師 |
|---|---|
| 官方文件能力 | 按應用存活性控制輸出心跳。 |
| 輸入 → 輸出 | 看門狗設定／餵入 → 心跳可發送狀態。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | gRPC 包裝器與直接繫結有不同整合路徑。 |
| 本站建議驗證 | 餵入須反映實際應用健康，不是無關計時器。 |
API / SDK / developer guide
Param typed parameter API
| 目標讀者 TA | 設定盤點開發者 |
|---|---|
| 官方文件能力 | 讀取具型別參數並檢視可用設定。 |
| 輸入 → 輸出 | 參數名稱／型別 → 結果／值。 |
| 執行環境 | C++ MAVSDK 應用；包裝器行為有所差異。 |
| 本站選型評估 | 變更參數可能改變載具行為；此示例唯讀。 |
| 本站建議驗證 | 區分缺少參數、逾時及有效零值。 |
04 / INPUT · EXPECTED OUTPUT · ACCEPTANCE
實作前先看懂預期結果
唯讀虛構遙測與診斷契約；未連接真實設備、發送飛行命令、上傳任務或寫入參數。
示意契約 · 未呼叫 API 或執行模型 · 不是供應商實測輸出
唯讀位置樣本
| 輸入 | 虛構遙測樣本，以大地經緯度及相對公尺表示。 |
|---|---|
| 預期結果 | 內部位置包含單位、參考框架及可空樣本／接收時間。 |
| 驗收條件 | 沒有證據不得宣稱最新或可飛行。 |
無相容相機
| 輸入 | 已發現系統但相機列表為空。 |
|---|---|
| 預期結果 | 內部 status=empty；cameras=[]。 |
| 驗收條件 | 不得將空酬載列表轉為載具斷線。 |
遙測斷線
| 輸入 | 傳輸／系統連線中斷。 |
|---|---|
| 預期結果 | 內部 status=disconnected；stale=true；live_position=null。 |
| 驗收條件 | 最後樣本保留為歷史資料及原有單位／時間。 |
參數不可用
| 輸入 | 唯讀要求不支援的示意參數。 |
|---|---|
| 預期結果 | 內部 status=error，包含實際 SDK 結果類別。 |
| 驗收條件 | 不捏造預設參數值或發送寫入。 |
將預期結果對應至你的應用
整合後將實際 SDK 或服務回應對應至此建議內部契約。下列識別碼與數值均為示意；不含憑證或真實請求。
預期輸出 JSON — 示意，非實測 · MAVSDK-expected-results.json
{
"schema_version": "1.0.0",
"example": true,
"provider": "MAVSDK",
"status": "ok",
"input_id": "sample-001",
"data": {
"system_id": 1,
"frame": "geodetic latitude/longitude; altitude relative to home",
"latitude_deg": 25.0,
"longitude_deg": 121.0,
"relative_altitude_m": 0.0,
"sample_time": null,
"received_at": null,
"freshness": "unmeasured",
"connection_state": "illustrative_connected"
},
"error": null,
"verification": "illustrative-only;not-provider-response"
}| 結果解讀 | 傳輸或執行成功不代表模型準確。有效空結果須與操作失敗分開。 |
|---|---|
| 可重現性 | 記錄模型、環境、設定與輸入識別；代表性測試前約定品質及延遲條件。不宣稱已實測效能。 |
| 操作範圍 | 唯讀虛構遙測與診斷契約；未連接真實設備、發送飛行命令、上傳任務或寫入參數。 |
開發評估
模擬器遙測工作台
開發構想規格・串接尚未實測
接口能力依據官方文件或程式庫；以下產品方向、輸入、交付與驗收條件則是我們的開發評估。
需整合驗證
估算可交付產品前，需共同驗證執行環境、資料結構或硬體。
- 原型輸入規劃
- 支援的模擬器或測試載具、鎖定韌體版本與遙測通道。
- 原型交付規劃
- 附載具、座標框架、時間與連線狀態的唯讀任務檢視。
- 驗收條件
- 對照參考紀錄檢查位置、電池與連線；明確顯示過期資料及斷線。
- 依賴條件
- 逐機型及韌體相容性、模擬器，以及另外審核的實體作業流程。
串接前置條件
參考使用 main／v4 文件，不保證與安裝版本相容。遙測可用不等於飛行許可；須逐一核對包裝器。
開發順序
- 確認 MAVSDK 的存取、授權與支援版本。
- 準備上述樣本，針對「模擬器遙測工作台」先實作一個有官方文件的操作。
- 整理輸出時保留來源、時間與錯誤狀態，並保留供應商回應供審核。
- 通過驗收條件後，再估算擴展投入與客戶交付。
如何驗證需求
記錄產品瀏覽、官方文件點擊、規格下載與技術 Hub 點擊。這些是事件次數，不等於獨立人數或已完成串接。
本次可行性評估依實作條件判斷；尚未給定流量排名或交期承諾。