get_gesture_recognize

ZumiAI.get_gesture_recognize() → str

스트리밍되는 카메라 영상에서 인식된 손의 제스처 이름을 가져옵니다.

이 함수는 gesture_detector_start() 로 손 제스처 인식이 활성화된 상태에서, 현재 영상에 감지된 손의 모양을 분석하여 다음 중 하나의 제스처 이름을 문자열로 반환합니다:

‘fist’: 주먹을 쥐었을 때
‘point’: 검지 손가락만 펴서 무언가를 가리킬 때
‘open’: 손바닥을 활짝 펴서 ‘하이 파이브’와 같은 자세를 취할 때
‘peace’: 검지와 중지 손가락을 펴서 ‘브이(V)’자를 만들 때
‘standby’: 엄지손가락만 굽히고 나머지 손가락을 폈을 때
‘thumbs_up’: 엄지손가락만 펴서 ‘최고’를 나타낼 때
‘None’: 위에 해당하지 않는 다른 모든 손 모양이나 손이 인식되지 않았을 때

매개변수:: 없음
반환:: 인식된 손 제스처의 이름. 위에 나열된 문자열 중 하나를 반환합니다.
반환 형식:: str

예제

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

>>> while True:
>>>     gesture = zumiAI.get_gesture_recognize()
>>>     if gesture != 'None':
>>>         print(f"인식된 제스처: {gesture}")
>>>         if gesture == 'peace':
>>>             print("평화! 브이(V) 제스처네요!")
>>>     else:
>>>         print("제스처 인식 대기 중...")
>>>     time.sleep(1) # 1초 대기

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

참고

이 함수를 사용하기 전에 camera_stream_start() 로 영상 스트리밍을 시작하고, gesture_detector_init() 로 손 제스처 인식 기능을 초기화한 후, gesture_detector_start() 를 호출하여 손 제스처 인식을 활성화해야 합니다.
이 기능은 주미 자체의 하드웨어 기능이 아니라, PC 기반 소프트웨어로 처리됩니다.
한 번에 하나의 손만 인식하도록 설정되어 있습니다.