Python#

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

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

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

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

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

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

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

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

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

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

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

一般的なPython API要素#

要素

それはどういう意味か

方法

オブジェクトに対して呼び出されるコマンド。例えば、 drone.take_off(…)。

関数

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

パラメータ

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

オプションパラメータ

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

戻り値

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

Pythonの基本用語#

学期

それはどういう意味か

変数

値を格納する名前。例えば height = 500など。

弦

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

整数

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

フロート

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

ブール値

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

口論

メソッドまたは関数呼び出しに渡される値。たとえば、 drone.take_off(climb_to=500)の 500 など。

メソッドエントリの例#

脱ぐ#

take_off はプロペラを始動させ、ドローンを空中に持ち上げます。この操作は、他の動作を行う前に必ず実行する必要があります。

使用法:

drone.take_off(climb_to, units, wait)

パラメータ

説明

climb_to

ドローンが飛行するZ座標。

units

使用する単位:

  • CM - センチメートル
  • MM - ミリメートル
  • INCHES

wait

オプション。

  • wait=True (デフォルト) - ドローンは、次のコード行を実行する前に、 take_off が完了するまで待機します。
  • wait=False - ドローンは、take_off take_off 完了を待たずに、すぐにアクションを開始して次のコード行に進みます。

# Fly for 1 second
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()