Python#

VEX EXP Python APIリファレンスでは、各コマンド、メソッド、関数が何をするのか、どのような入力を使用するのか、何を返すのか、そしてプロジェクトでどのように使用できるのかを説明しています。

このリファレンスは、コマンドをプロジェクトに追加する前にその内容を理解したい場合、コマンドが受け入れる値や返す値を確認したい場合、またはカテゴリ内の関連コマンドを比較したい場合に使用します。

VEXcode EXPのPythonプロジェクトでは、Pythonコマンドが使用されます。ブロックプロジェクトやC++プロジェクトでは、代わりに他のAPIセクションが使用されます。

メソッドエントリの読み方#

ほとんどのPythonのエントリには、以下の部分が含まれています。

  • コマンド名 - コマンド、メソッド、または関数の正式名称。

  • 説明 - コマンドの機能と、それが役立つ場面について説明します。

  • 使用方法 - コマンドをコードに記述するための構文を表示します。

  • パラメータ - コマンドが受け入れる入力の一覧と、それぞれの機能について説明します。

  • 戻り値 - コマンドが値を返す場合、そのコマンドが何を返すかを説明します。

  • サンプルコード - プロジェクト内でコマンドを使用する1つの方法を示します。

一般的なPython API要素#

要素

それはどういう意味か

方法

drivetrain.drive(…)のようなオブジェクトに対して呼び出されるコマンド。

関数

wait(…) または print(…)のように直接呼び出されるコマンド。

パラメータ

メソッドや関数に渡される値で、その動作を制御するために使用されます。

オプションパラメータ

省略可能なパラメータで、省略するとデフォルトの動作が使用されます。

戻り値

コマンドが返す値。数値、テキスト、ブール値など。

Pythonの基本用語#

学期

それはどういう意味か

変数

値を格納する名前。例: speed = 50。

弦

引用符内のテキスト、例: “Hello”。

整数

90のような正または負の数。

フロート

小数点を含む数値、例: 25.5。

ブール値

True または Falseのいずれかの値。

口論

メソッドまたは関数呼び出しに渡される値。たとえば、 drivetrain.drive(FORWARD)の FORWARD など。

メソッドエントリの例#

ドライブ#

ドライブdrive 組み合わせでは、ロボットは永久に前進または後退します。ロボットは、旋回や停止などの別の動作が与えられるまで動き続けます。

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

パラメータ

説明

direction

ロボットの移動方向: FORWARD または REVERSE。

velocity

Optional. The velocity to drive with from 0% to 100% when using PERCENT, from 0 to 120 rpm when using RPM, or from 0 to 720 degrees per second when using VelocityUnits.DPS. This can be an integer or decimal (float). If no velocity is provided, the robot drives at the current drive velocity.

units

オプション。速度単位: PERCENT (デフォルト)、 RPM (1分あたりの回転数)、または VelocityUnits.DPS (1秒あたりの角度)。

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

# Drive slowly in reverse then stop
drivetrain.drive(REVERSE, 20, PERCENT)
wait(2, SECONDS)
drivetrain.stop()