get_gesture_finger

ZumiAI.get_gesture_finger() → list

스트리밍되는 카메라 영상에서 인식된 손의 각 손가락이 펴져 있는지 접혀 있는지 확인합니다.

이 함수는 gesture_detector_start() 로 손 제스처 인식이 활성화된 상태에서, 현재 영상에 감지된 손의 엄지, 검지, 중지, 약지, 새끼손가락의 상태를 리스트 형태로 반환합니다. 각 손가락은 펴져 있으면 1, 굽혀져(쥐어져) 있으면 0으로 표시됩니다.

매개변수:

없음

반환:

[엄지, 검지, 중지, 약지, 새끼] 순서로 각 손가락의 상태를 나타내는 리스트.

• 1: 해당 손가락이 펴진 상태

• 0: 해당 손가락이 굽혀진(쥐어진) 상태

손이 감지되지 않았다면 모든 값이 0인 리스트 [0, 0, 0, 0, 0]`을 반환할 수 있습니다. 예시: `[0, 1, 0, 0, 0] (검지 손가락만 펴진 상태, 즉 ‘가리키기’)

반환 형식:

list[int]

예제

>>> zumiAI.camera_stream_start()  # 카메라 스트리밍 시작
>>> zumiAI.gesture_detector_init() # 손 제스처 인식 초기화
>>> zumiAI.gesture_detector_start() # 손 제스처 인식 시작

>>> while True:
>>>     finger_status = zumiAI.get_gesture_finger()
>>>     print(f"손가락 상태 (엄지-새끼): {finger_status}")
>>>     if finger_status[1] == 1 and finger_status[2] == 1: # 검지와 중지가 펴진 경우 (브이)
>>>         print("브이(V) 제스처입니다!")
>>>     time.sleep(1) # 1초 대기

>>> zumiAI.gesture_detector_stop() # 손 제스처 인식 중지

참고

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

• 이 기능은 주미 자체의 하드웨어 기능이 아니라, PC 기반 소프트웨어로 처리됩니다.

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