key_press_set

ZumiAI.key_press_set(key_str: str, callback_func: callable)

사용자 키보드의 특정 키가 눌렸을 때 실행될 콜백 함수를 등록합니다.

이 함수를 통해 사용자는 키보드 입력에 따라 주미 AI의 동작을 제어하는 맞춤형 기능을 구현할 수 있습니다.

매개변수:

• key_str (str) – 등록할 키의 이름 문자열입니다. (예: “a”, “esc”, “space”, “enter”, “up”, “down”, “left”, “right”) 대소문자를 구분하며, 특수 키는 특정 문자열로 지정됩니다.

• callback_func (callable) – 지정된 키가 눌렸을 때 호출될 함수입니다. 이 함수는 인자를 받지 않는 형태여야 합니다.

반환:

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

예외 발생:

• ValueError – ‘callback_func’가 호출 가능한 함수가 아닐 경우 오류 메시지를 출력합니다.

• Warning – ‘key_str’이 유효하지 않은 키 이름일 경우 경고 메시지를 출력합니다.

예제

>>> def my_forward_function():
>>>     print("앞으로 이동!")
>>>     zumiAI.forward(1)
>>>
>>> def my_stop_function():
>>>     print("정지!")
>>>     zumiAI.stop()
>>>
>>> zumiAI.key_press_set("w", my_forward_function) # 'w' 키를 누르면 my_forward_function 호출
>>> zumiAI.key_press_set("s", my_stop_function)    # 's' 키를 누르면 my_stop_function 호출
>>> # 이제 키보드 'w'를 누르면 앞으로 이동하고 's'를 누르면 정지합니다.