gesture_detector_start

ZumiAI.gesture_detector_start()

스트리밍되는 카메라 영상에서 손 제스처 인식 기능을 시작합니다.

이 함수를 호출하면 주미의 카메라 영상이 PC로 스트리밍될 때, 영상 내에서 인식된 손과 제스처 정보가 자동으로 감지되고 다음과 같이 화면에 표시됩니다:

  • 손 랜드마크: 인식된 손 위에 여러 특징점(관절, 손가락 끝 등)이 표시됩니다.

  • 손 중심점: 손의 중심 x, y 좌표가 표시됩니다.

  • 손 크기: 손의 크기 정보가 표시됩니다.

  • 손가락 상태: 각 손가락(엄지부터 새끼손가락까지)이 굽혀졌는지(0) 펴졌는지(1)를 나타내는 5개의 숫자로 된 리스트(예: [0, 1, 0, 0, 0])가 표시됩니다.

  • 인식된 제스처: 인식된 손 모션에 따라 다음과 같은 제스처 이름이 화면에 표시됩니다:
    • fist (주먹): 모든 손가락이 굽혀진 상태 ([0, 0, 0, 0, 0])

    • point (가리키기): 검지 손가락만 펴진 상태 ([0, 1, 0, 0, 0])

    • open (손바닥 펴기): 모든 손가락이 펴진 상태 ([1, 1, 1, 1, 1])

    • peace (브이): 검지와 중지 손가락이 펴진 상태 ([0, 1, 1, 0, 0])

    • standby (엄지 제외 펴기): 엄지손가락만 굽혀진 상태 ([1, 1, 0, 0, 0])

    • thumbs_up (엄지척): 엄지손가락만 펴진 상태 ([1, 0, 0, 0, 0])

    • None (인식 불가): 위에 해당하지 않는 모든 제스처

이후 is_gesture_detected() , get_gesture_center() , get_gesture_size() , get_gesture_finger() , get_gesture_recognize() 와 같은 관련 함수를 사용하여 인식된 손 제스처의 다양한 정보를 프로그램 내에서 가져올 수도 있습니다.

매개변수:

없음

반환:

이 함수는 값을 반환하지 않습니다.

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.gesture_detector_init() # 손 제스처 인식 기능 초기화
>>> zumiAI.gesture_detector_start() # PC 화면에서 손 제스처 인식 및 시각화 시작
# 이제 PC 화면의 스트리밍 영상에 인식된 손과 제스처 정보가 표시됩니다.
>>> # ... 손 제스처 인식을 사용하는 로직 ...
>>> zumiAI.gesture_detector_stop() # 손 제스처 인식 중지

참고

  • 이 함수를 사용하기 전에 camera_stream_start() 로 영상 스트리밍을 시작하고, gesture_detector_init() 로 손 제스처 인식 기능을 초기화해야 합니다.

  • 이 기능은 주미 자체의 하드웨어에서 처리되는 기능과는 다릅니다.

  • 한 번에 하나의 손만 인식하도록 설정되어 있습니다.