MediaPipe中Holistic模型绘制关键点问题的分析与解决

问题背景

在使用MediaPipe的Holistic模型进行手部关键点检测时，开发者遇到了一个常见的错误：AttributeError: 'NormalizedLandmark' object has no attribute 'landmark'。这个问题出现在尝试使用draw_landmarks()函数绘制检测到的关键点时。

错误原因分析

这个错误的核心在于对MediaPipe数据结构的理解偏差。开发者试图直接遍历hand_landmarks.landmark，但实际上：

1. results.left_hand_landmarks已经是包含所有关键点的NormalizedLandmarkList对象
2. 当遍历results.left_hand_landmarks.landmark时，每个hand_landmarks实际上是单个的NormalizedLandmark对象
3. 直接将这些单个关键点对象传递给draw_landmarks()函数会导致错误，因为该函数期望接收的是完整的NormalizedLandmarkList

正确的使用方法

正确的代码实现应该如下：

if results.left_hand_landmarks:
    # 直接传递整个landmark列表
    mp_drawing.draw_landmarks(frame, results.left_hand_landmarks, mp_hands.HAND_CONNECTIONS)
    
    keypoint_pos = []
    # 遍历每个关键点获取坐标
    for landmark in results.left_hand_landmarks.landmark:
        x = landmark.x * frame.shape[1]
        y = landmark.y * frame.shape[0]
        keypoint_pos.append((x, y))

版本兼容性说明

值得注意的是，MediaPipe从0.10.10版本开始，已经将Holistic解决方案升级为新的Task API架构。旧版的legacy Holistic解决方案已不再维护。新版本API提供了更简洁的接口和更好的性能。

最佳实践建议

1. 对于新项目，建议直接使用最新的Holistic Task API
2. 如果必须使用旧版API，确保正确理解数据结构层级关系
3. 绘制关键点时，传递完整的LandmarkList而非单个Landmark
4. 坐标转换时注意图像尺寸的乘法运算应在最后一步进行

总结

理解MediaPipe中数据结构的设计是避免此类错误的关键。开发者需要区分LandmarkList和单个Landmark对象的区别，并正确地将它们传递给相应的处理函数。随着MediaPipe的版本更新，建议开发者及时迁移到新的API架构，以获得更好的性能和更简洁的接口。