Python#

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

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

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

VEXcode VRにおけるPythonコマンドは、使用するプレイグラウンドとロボットによって異なる場合があります。一部のロボットには、すべてのプレイグラウンドに搭載されているわけではない独自のメソッドが含まれています。

VRにおける遊び場とロボット#

Playgrounds セクションを使用して、各 Playground でどのロボットが使用されているかを確認したり、Playground 固有のセットアップの詳細、フィールド情報、チャレンジのコンテキストを見つけたりできます。

ロボット セクションを使用して、固有のメソッドを持つロボット専用の Python ページを探してください。ロボットのページには、各ロボットがどの Playgrounds で使用されているかも表示されるため、プロジェクトでロボット固有のメソッドが利用可能かどうかを確認できます。

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

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

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

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

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

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

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

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

一般的なPython API要素#

要素

それはどういう意味か

方法

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

関数

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

パラメータ

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

オプションパラメータ

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

戻り値

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

Pythonの基本用語#

学期

それはどういう意味か

変数

値を格納する名前。例えば、 angle = 90など。

弦

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

整数

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

フロート

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

ブール値

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

口論

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

メソッドエントリの例#

回転#

Rotation is how much the robot has turned, measured in degrees. At the beginning of a project, the rotation value is set to 0 degrees. rotation returns the robot’s current rotation.

右に回すと回転角度が大きくなり、左に回すと回転角度が小さくなります。例えば、右に2回転すると720度回転します。

Usage:
drivetrain.rotation(units)

パラメータ

説明

units

オプション。回転単位: DEGREES (デフォルト)。

def main():
    # Display the rotation after turning
    drivetrain.turn_for(RIGHT, 450, DEGREES)
    brain.print("Rotation: ")
    brain.print(drivetrain.rotation(DEGREES))

# VR threads - Do not delete
vr_thread(main)