Python

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

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

VEXcode AIMのPythonプロジェクトではPythonコマンドを使用します。ブロックプロジェクトでは、代わりにブロックAPIセクションを参照してください。

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

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

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

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

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

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

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

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

一般的なPython API要素

要素	それはどういう意味か
方法	オブジェクトに対して呼び出されるコマンドは、例えば robot.move_at(…)。
関数	wait(…) または print(…)のように直接呼び出されるコマンド。
パラメータ	メソッドや関数に渡される値で、その動作を制御するために使用されます。
オプションパラメータ	省略可能なパラメータで、省略するとデフォルトの動作が使用されます。
戻り値	コマンドが返す値。数値、テキスト、ブール値など。

Pythonの基本用語

学期	それはどういう意味か
変数	値を格納する名前。例: speed = 50。
弦	引用符内のテキスト、例: “Hello”。
整数	90のような正または負の数。
フロート	小数点を含む数値、例: 25.5。
ブール値	True または Falseのいずれかの値。
口論	メソッドまたは関数呼び出しに渡される値。たとえば、 robot.move_at(0)の 0 など。

メソッドエントリの例

move_at

move_at を指定すると、ロボットは指定された角度で永久に移動を続けます。ロボットは、別の角度での移動、旋回、停止などの別の動作が与えられるまで移動を続けます。

Usage:
robot.move_at(angle, velocity, units)

パラメータ	説明
angle	ロボットが移動する角度（度数）。整数または-360から360までの小数を指定できます。
velocity	オプション。0 PERCENTを使用する場合は % ～ 100%、 MMPSを使用する場合は 0 ～ 200 ミリメートル/秒の移動速度を指定します。整数または小数を指定できます。速度が指定されていない場合、ロボットは現在の移動速度で移動します。
units	オプション。速度の単位： PERCENT （デフォルト）または MMPS （ミリメートル毎秒）。

# Move forward
robot.move_at(0)