{"reference_analysis":{"provider":"Google MediaPipe","checked_at":"2026-10-08","source_access":{"en":"Official project and developer sources reviewed; no provider API was called. Expected outputs below are our illustrative contracts, not measured results.","zh-TW":"已核對官方專案與開發來源；沒有呼叫供應商 API。下方預期輸出是本站示意契約，不是實測結果。"},"selection_basis":{"en":"Ten documented technical entry points, selected by task; not ten independent SDKs or an official ranking.","zh-TW":"依任務選出的十個有文件技術入口；不是十套獨立 SDK 或官方排名。"},"about_url":"https://developers.google.com/edge/mediapipe/solutions/guide","about":[{"label":{"en":"Project","zh-TW":"專案"},"value":{"en":"MediaPipe is an open-source project within Google AI Edge.","zh-TW":"MediaPipe 是 Google AI Edge 體系的開源專案。"}},{"label":{"en":"Purpose","zh-TW":"用途"},"value":{"en":"Provides reusable ML solutions for application developers.","zh-TW":"提供應用開發者可重用的機器學習解決方案。"}},{"label":{"en":"Components","zh-TW":"組成"},"value":{"en":"Tasks APIs and compatible models provide inference; Model Maker supports selected customizations and Studio supports evaluation.","zh-TW":"Tasks API 與相容模型提供推論；Model Maker 支援部分客製化，Studio 支援評估。"}},{"label":{"en":"Platform and lifecycle","zh-TW":"平台與生命週期"},"value":{"en":"Task and platform availability vary. Use current Solutions guides; legacy solution support differs.","zh-TW":"任務與平台可用性不同。應使用現行 Solutions 指南；舊方案支援狀態不同。"}}],"items":[{"id":"face_detector","name":"Face Detector","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/face_detector","audience":{"en":"Face region UI developers","zh-TW":"人臉區域介面工程師"},"capability":{"en":"Locate faces and facial key points.","zh-TW":"定位人臉與臉部關鍵點。"},"io":{"en":"Image/frame → face boxes and key points.","zh-TW":"影像／影格 → 人臉框與關鍵點。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Detection is not identity recognition.","zh-TW":"偵測不等於身分識別。"},"validation":{"en":"Verify boxes against authorized annotated frames.","zh-TW":"對照授權標註影格驗證框選。"}},{"id":"face_landmarker","name":"Face Landmarker","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/face_landmarker","audience":{"en":"AR and animation developers","zh-TW":"AR 與動畫工程師"},"capability":{"en":"Estimate facial landmarks and supported facial outputs.","zh-TW":"估計臉部特徵點及支援的臉部輸出。"},"io":{"en":"Image/frame → facial geometry; optional outputs depend on settings.","zh-TW":"影像／影格 → 臉部幾何；選用輸出依設定。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Geometry is not evidence of a person’s feelings or intent.","zh-TW":"幾何不構成人物情緒或意圖證據。"},"validation":{"en":"Check occlusion and coordinate mapping on target devices.","zh-TW":"在目標裝置測試遮擋與座標映射。"}},{"id":"gesture_recognizer","name":"Gesture Recognizer","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/gesture_recognizer","audience":{"en":"Touchless interface developers","zh-TW":"非接觸介面工程師"},"capability":{"en":"Recognize supported hand gestures.","zh-TW":"辨識支援的手勢。"},"io":{"en":"Image/frame → gesture categories and hand landmarks.","zh-TW":"影像／影格 → 手勢類別與手部特徵點。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Only configured gesture vocabulary is meaningful.","zh-TW":"僅設定內的手勢詞彙具有指定意義。"},"validation":{"en":"Test unknown gestures without triggering a command.","zh-TW":"未知手勢不得誤觸命令。"}},{"id":"hand_landmarker","name":"Hand Landmarker","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/hand_landmarker","audience":{"en":"Hand interaction developers","zh-TW":"手部互動工程師"},"capability":{"en":"Estimate hand landmarks and handedness.","zh-TW":"估計手部特徵點與左右手。"},"io":{"en":"Image/frame → normalized and world landmarks, handedness.","zh-TW":"影像／影格 → 正規化與世界座標特徵點、左右手。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Mirroring and coordinate systems must be explicit.","zh-TW":"鏡像與座標系統須明確。"},"validation":{"en":"Compare mirrored and original input deliberately.","zh-TW":"刻意比較鏡像與原始輸入。"}},{"id":"holistic_landmarker","name":"Holistic Landmarker","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/holistic_landmarker","audience":{"en":"Whole-body interaction teams","zh-TW":"全身互動團隊"},"capability":{"en":"Combine face, pose and hand landmark estimation.","zh-TW":"整合臉部、姿態與手部特徵点估計。"},"io":{"en":"Image/frame → grouped body, face and hand landmarks.","zh-TW":"影像／影格 → 身體、臉部與手部特徵點群組。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Missing groups must remain missing rather than zero-filled people.","zh-TW":"遺失群組應保留遺失狀態，不能補零成為虛假人物。"},"validation":{"en":"Verify partial visibility and group association.","zh-TW":"驗證局部可見與群組對應。"}},{"id":"image_classifier","name":"Image Classifier","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/image_classifier","audience":{"en":"Image routing developers","zh-TW":"影像分流工程師"},"capability":{"en":"Assign categories using a compatible classification model.","zh-TW":"利用相容分類模型指派類別。"},"io":{"en":"Image → ranked categories and scores.","zh-TW":"影像 → 排序類別與分數。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Category vocabulary is determined by the chosen model.","zh-TW":"類別詞彙由選定模型決定。"},"validation":{"en":"Include out-of-domain images and review thresholds.","zh-TW":"包含領域外影像並檢討門檻。"}},{"id":"image_embedder","name":"Image Embedder","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/image_embedder","audience":{"en":"Visual retrieval developers","zh-TW":"視覺檢索工程師"},"capability":{"en":"Represent images as numeric embeddings.","zh-TW":"將影像表示成數值嵌入。"},"io":{"en":"Image → feature vector.","zh-TW":"影像 → 特徵向量。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Vectors are not semantic labels; compare compatible embeddings.","zh-TW":"向量不是語意標籤；須比較相容嵌入。"},"validation":{"en":"Evaluate relevant and irrelevant image pairs.","zh-TW":"評估相關與不相關影像配對。"}},{"id":"image_segmenter","name":"Image Segmenter","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/image_segmenter","audience":{"en":"Pixel-level UI developers","zh-TW":"像素層級介面工程師"},"capability":{"en":"Separate image regions with a compatible segmentation model.","zh-TW":"以相容分割模型區分影像區域。"},"io":{"en":"Image → category or confidence masks according to configuration.","zh-TW":"影像 → 依設定輸出類別或信心遮罩。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Resized masks must be aligned before overlay.","zh-TW":"縮放後遮罩必須對齊才能疊圖。"},"validation":{"en":"Check pixel alignment and known-region overlap.","zh-TW":"核對像素對齊與已知區域重疊。"}},{"id":"object_detector","name":"Object Detector","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/object_detector","audience":{"en":"Object-based application teams","zh-TW":"物件應用團隊"},"capability":{"en":"Locate and categorize model-supported objects.","zh-TW":"定位與分類模型支援的物件。"},"io":{"en":"Image/frame → boxes, categories and scores.","zh-TW":"影像／影格 → 框、類別與分數。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Pretrained classes do not automatically include factory defects.","zh-TW":"預訓練類別不會自動包含工廠缺陷。"},"validation":{"en":"Measure missed objects with domain-specific annotations.","zh-TW":"用領域標註量測漏偵物件。"}},{"id":"pose_landmarker","name":"Pose Landmarker","kind":"API / SDK / developer guide","url":"https://developers.google.com/edge/mediapipe/solutions/vision/pose_landmarker","audience":{"en":"Movement visualization teams","zh-TW":"動作視覺化團隊"},"capability":{"en":"Estimate body pose landmarks.","zh-TW":"估計身體姿態特徵點。"},"io":{"en":"Image/frame → normalized and world pose landmarks.","zh-TW":"影像／影格 → 正規化與世界座標姿態特徵點。"},"runtime":{"en":"Selected Tasks SDK, compatible model and supported platform","zh-TW":"選定 Tasks SDK、相容模型與支援平台"},"constraint":{"en":"Pose alone does not establish medical condition or safe operation.","zh-TW":"僅姿態不能判定醫療狀態或操作安全。"},"validation":{"en":"Review occluded joints and frame-to-frame stability.","zh-TW":"檢查遮擋關節與連續影格穩定性。"}}],"supporting_references":[{"id":"documentation","name":"Official documentation overview","url":"https://ai.google.dev/edge/mediapipe/solutions/guide","audience":{"en":"Developers and product owners selecting the supported technical path.","zh-TW":"選擇支援技術路徑的工程師與產品負責人。"},"validation":{"en":"Choose the operation, supported version and runtime before assigning implementation.","zh-TW":"安排實作前先選定操作、支援版本與執行環境。"}}]},"content_coverage":{"reference_guide":true,"developer_starter":false,"expected_results":true,"integration_test":"not-run","updated_at":"2026-10-08"},"developer_starter":{"version":"1.0.0","verification":"illustrative-contract-only;live-provider-not-run","filename":"MediaPipe-expected-results.json","format":"json-example","scope":{"en":"Illustrative object-detection contract for a selected Tasks model; other tasks return different structures. No camera or model was run.","zh-TW":"選定 Tasks 模型的物件偵測示意契約；其他任務會回傳不同結構。未啟用攝影機或執行模型。"},"setup":{"en":"Review the scenarios below and map the actual SDK response into this internal contract. No credential, API call or live output is included. Replace example data only after your own integration test.","zh-TW":"先審閱下方情境，再將實際 SDK 回應對應至此內部契約。此處不含憑證、API 呼叫或真實輸出，示意資料須在自行串接測試後替換。"},"code":"{\n  \"schema_version\": \"1.0.0\",\n  \"example\": true,\n  \"provider\": \"Google MediaPipe\",\n  \"status\": \"ok\",\n  \"input_id\": \"sample-001\",\n  \"data\": {\n    \"task\": \"object_detector\",\n    \"coordinate_system\": \"pixels-original-image\",\n    \"detections\": [\n      {\n        \"label\": \"sample-object\",\n        \"score\": 0.82,\n        \"box_xywh\": [\n          12,\n          18,\n          80,\n          60\n        ]\n      }\n    ],\n    \"model_asset\": \"record-at-integration\"\n  },\n  \"error\": null,\n  \"verification\": \"illustrative-only;not-provider-response\"\n}","expected_results":[{"scenario":{"en":"Object detected","zh-TW":"偵測到物件"},"input":{"en":"Authorized image and a compatible object model.","zh-TW":"授權影像與相容物件模型。"},"output":{"en":"ok; label, score and box in the declared coordinate system.","zh-TW":"ok；標籤、分數與明示座標系統的框。"},"acceptance":{"en":"Model labels match the UI and boxes align after resizing.","zh-TW":"模型標籤對應介面且縮放後框仍對齊。"}},{"scenario":{"en":"No detection","zh-TW":"未偵測到物件"},"input":{"en":"A valid image with no object above the chosen threshold.","zh-TW":"有效影像，沒有物件超過設定門檻。"},"output":{"en":"ok; detections: []; never reuse previous-frame boxes.","zh-TW":"ok；detections: []；不可沿用前一影格的框。"},"acceptance":{"en":"Empty state appears without an error banner.","zh-TW":"顯示空狀態而非錯誤提示。"}},{"scenario":{"en":"Model mismatch","zh-TW":"模型不相容"},"input":{"en":"A missing or incompatible task model.","zh-TW":"缺漏或不相容的任務模型。"},"output":{"en":"error; model initialization failed; data is null.","zh-TW":"error；模型初始化失敗；data 為 null。"},"acceptance":{"en":"No fabricated predictions and a recoverable setup message.","zh-TW":"不得捏造預測；提供可處理的設定訊息。"}},{"scenario":{"en":"Video sequence","zh-TW":"影片序列"},"input":{"en":"Frames with timestamps in the selected video/live mode.","zh-TW":"選定影片／即時模式中帶時間戳的影格。"},"output":{"en":"Results are associated with their input frame timestamps.","zh-TW":"結果對應各自輸入影格的時間戳。"},"acceptance":{"en":"Reject or account for invalid ordering; do not promise a result for every live frame.","zh-TW":"拒絕或處理無效順序；不保證每個即時影格皆有結果。"}}],"decisions":[[{"en":"Result states","zh-TW":"結果狀態"},{"en":"ok means the selected operation returned a valid result; a valid empty result differs from error. Pending work remains pending until a terminal result. Do not infer real-world correctness from API success.","zh-TW":"ok 表示所選操作回傳有效結構；有效空結果與 error 不同。未完成工作保持 pending 直到終態。API 成功不代表現實判斷必然正確。"}],[{"en":"Reproducibility","zh-TW":"可重現性"},{"en":"Record input ID, library/model version, configuration, runtime and coordinate/score conventions. Examples contain invented sample values.","zh-TW":"記錄輸入識別、函式庫／模型版本、設定、執行環境及座標／分數慣例。範例數值為示意。"}],[{"en":"Acceptance — proposed","zh-TW":"建議驗收"},{"en":"Use representative authorized samples plus empty, malformed and unavailable-runtime cases. Agree quality and latency targets before running tests. No measured accuracy, cost or speed is claimed.","zh-TW":"使用授權代表樣本，加上空結果、格式錯誤與環境不可用案例。測試前先約定品質與延遲目標；不宣稱已量測準確率、成本或速度。"}],[{"en":"Operation boundary","zh-TW":"操作範圍"},{"en":"Illustrative object-detection contract for a selected Tasks model; other tasks return different structures. No camera or model was run.","zh-TW":"選定 Tasks 模型的物件偵測示意契約；其他任務會回傳不同結構。未啟用攝影機或執行模型。"}]]},"schema_version":"1.0.0","type":"development-proposal","product_id":"industrial-api:MediaPipe","name":"MediaPipe","provider":"Google","url":"https://smart-tools.ai/product/MediaPipe","localized_urls":{"en":"https://smart-tools.ai/product/MediaPipe","zh-TW":"https://smart-tools.ai/zh-tw/product/MediaPipe"},"category":"vision","capability_id":"cap:computer-vision","technology_hub":"https://smart-tools.ai/industrial-ai/computer-vision","interface_kind":"SDK","deployment":"local","official_documentation":"https://developers.google.com/edge/mediapipe/solutions/guide","sources":["https://developers.google.com/edge/mediapipe/solutions/guide","https://developers.google.com/edge/mediapipe/solutions/vision/face_detector","https://developers.google.com/edge/mediapipe/solutions/vision/face_landmarker","https://developers.google.com/edge/mediapipe/solutions/vision/gesture_recognizer","https://developers.google.com/edge/mediapipe/solutions/vision/hand_landmarker","https://developers.google.com/edge/mediapipe/solutions/vision/holistic_landmarker","https://developers.google.com/edge/mediapipe/solutions/vision/image_classifier","https://developers.google.com/edge/mediapipe/solutions/vision/image_embedder","https://developers.google.com/edge/mediapipe/solutions/vision/image_segmenter","https://developers.google.com/edge/mediapipe/solutions/vision/object_detector","https://developers.google.com/edge/mediapipe/solutions/vision/pose_landmarker","https://ai.google.dev/edge/mediapipe/solutions/guide"],"source_review":{"level":"P1","status":"official-source-reviewed","checked_at":"2026-10-08"},"provider_summary":{"en":"Integrate packaged perception tasks into device applications.","zh-TW":"把封裝好的感知任務整合到裝置應用。"},"proposed_product":{"en":"On-device perception benchmark","zh-TW":"裝置端感知效能比較"},"feasibility":{"tier":"integration","rationale":{"en":"Validate runtime, schemas or hardware together before estimating a deployable product.","zh-TW":"估算可交付產品前，需共同驗證執行環境、資料結構或硬體。"},"basis":"development-judgment;not-traffic-ranked"},"proposed_inputs":{"en":"A small authorized image dataset, task definition and reference annotations.","zh-TW":"少量經授權影像、任務定義與參考標註。"},"proposed_deliverable":{"en":"A reviewable result with image references, labels or annotation state; keep original files.","zh-TW":"可審核的影像引用、標籤或標註狀態；保留原始檔案。"},"acceptance_criterion":{"en":"Compare the supported operation against a labeled sample; report errors and missing results separately.","zh-TW":"用已標註樣本比對支援的操作；錯誤與缺漏結果分開呈現。"},"dependencies":{"en":"Dataset access, image rights and a supported model or annotation project.","zh-TW":"資料集存取、影像使用權與支援的模型或標註專案。"},"integration_condition":null,"proposed_adapter_envelope":{"provider":"Google","operation":"chosen-documented-operation","source_url":"https://developers.google.com/edge/mediapipe/solutions/guide","captured_at":"ISO-8601 timestamp","status":"ok|pending|unknown|failed","data":"provider response mapped by the team","evidence":"source references","errors":"explicit error details"},"adapter_envelope_status":"proposed-internal-contract;not-a-provider-response","development_status":"concept-specification","integration_test":"not-run","pricing_status":"provider-terms-review-required","estimate_status":"requires-access-and-sample-validation","traffic_status":"not-measured-in-this-assessment","measurement_events":["product_view","product_to_docs","product_to_spec","bridge_to_industrial_ai"]}