Python#

VEX V5 Python API 참조는 각 명령, 메서드 및 함수의 기능, 사용 입력, 반환 값 및 프로젝트에서의 사용 방법을 설명합니다.

이 참조 자료는 프로젝트에 명령어를 추가하기 전에 명령어의 의미를 이해하거나, 명령어가 허용하거나 반환하는 값을 확인하거나, 같은 범주 내의 관련 명령어를 비교하려는 경우에 사용하세요.

VEXcode V5의 Python 프로젝트에서는 Python 명령어가 사용됩니다. 블록 및 C++ 프로젝트에서는 다른 API 섹션을 사용합니다.

메서드 입력값을 읽는 방법#

대부분의 파이썬 항목에는 다음과 같은 부분이 포함됩니다.

  • 명령어 이름 - 명령, 메서드 또는 함수의 공식 명칭입니다.

  • 설명 - 이 명령어가 무엇을 하는지, 그리고 언제 유용한지 설명합니다.

  • 사용법 - 명령어를 코드로 작성하는 데 사용되는 구문을 보여줍니다.

  • 매개변수 - 명령이 허용하는 입력 목록과 각 입력의 기능을 설명합니다.

  • 반환 값 - 명령이 값을 반환하는 경우, 해당 값이 무엇을 보고하는지 설명합니다.

  • 예제 코드 - 프로젝트에서 해당 명령어를 사용하는 한 가지 방법을 보여줍니다.

일반적인 파이썬 API 요소#

요소

그것이 의미하는 바는

방법

drivetrain.drive(…) 와 같은 객체에 대해 호출되는 명령입니다.

기능

wait(…) 또는 print(…) 와 같이 직접 호출되는 명령입니다.

매개변수

메서드나 함수에 전달되는 값으로, 해당 메서드나 함수의 동작을 제어합니다.

선택적 매개변수

생략해도 기본 동작이 사용되는 매개변수입니다.

반환 값

명령이 반환하는 값으로, 숫자, 텍스트 또는 부울 값 등이 있습니다.

파이썬 기본 용어#

용어

그것이 의미하는 바는

변하기 쉬운

speed = 50 와 같이 값을 저장하는 이름입니다.

끈

따옴표 안의 텍스트, 예: “Hello”.

정수

90 과 같은 양수 또는 음수.

뜨다

25.5 과 같이 소수점이 있는 숫자입니다.

부울

True False (거짓) 중 하나의 값입니다.

논쟁

메서드 또는 함수 호출에 전달되는 값(예: 360.0 in drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)).

예시 메서드 입력#

운전하다#

drive 로봇을 전진 또는 후진으로 무한히 움직이게 합니다. 로봇은 회전이나 정지와 같은 다른 동작이 주어질 때까지 계속 움직입니다. RPM 또는 초당 회전 각도의 제한은 구동계의 기어비에 따라 달라집니다.

Usage:
drivetrain.drive(direction, velocity, units)

매개변수

설명

direction

로봇의 이동 방향: FORWARD 또는 REVERSE.

velocity

선택 사항입니다. PERCENT사용할 경우 0%에서 100%까지, RPM사용할 경우 0에서 600 rpm까지, 또는 VelocityUnits.DPS를 사용할 경우 0에서 3600도/초까지 주행 속도를 지정할 수 있습니다. 이 값은 정수 integer 또는 소수(float)일 수 있습니다. 속도를 지정하지 않으면 로봇은 현재 주행 속도로 주행합니다.

units

선택 사항입니다. 속도 단위는 RPM (분당 회전수, 기본값), PERCENT또는 VelocityUnits.DPS (초당 각도)입니다.

# Drive forward, then stop
drivetrain.drive(FORWARD)
wait(2, SECONDS)
drivetrain.stop()

# Drive forward at 360 degrees per second
drivetrain.drive(FORWARD, 360.0, VelocityUnits.DPS)