Python#

La documentation de référence de l’API Python VEXcode VR explique le rôle de chaque commande, méthode et fonction, les entrées qu’elle utilise, les valeurs qu’elle renvoie et comment elle peut être utilisée dans un projet.

Utilisez cette référence lorsque vous souhaitez comprendre une commande avant de l’ajouter à un projet, vérifier les valeurs qu’elle accepte ou renvoie, ou comparer des commandes apparentées dans une même catégorie.

Les commandes Python sont utilisées dans les projets Python VR de VEXcode. Les projets Blocks utilisent quant à eux la section API Blocks.

Les commandes Python dans VEXcode VR peuvent varier selon le Playground et le robot utilisés. Certains robots possèdent des méthodes spécifiques qui ne sont pas disponibles dans tous les Playgrounds.

Aires de jeux et robots en réalité virtuelle#

Utilisez la section Playgrounds pour voir quel robot est utilisé dans chaque Playground et pour trouver des détails de configuration spécifiques au Playground, des informations sur le terrain et le contexte du défi.

Utilisez la section Robots pour trouver les pages Python spécifiques aux robots possédant des méthodes uniques. Ces pages indiquent également dans quels Playgrounds chaque robot est utilisé, ce qui vous permet de savoir quand une méthode spécifique à un robot est disponible dans votre projet.

Comment lire une entrée de méthode#

La plupart des entrées Python comprennent les parties suivantes :

  • Nom de la commande - Le nom officiel de la commande, de la méthode ou de la fonction.

  • Description - Explique le rôle de la commande et son utilité dans certains cas.

  • Utilisation - Affiche la syntaxe utilisée pour écrire la commande en code.

  • Paramètres - Liste les entrées acceptées par la commande et explique le rôle de chacune.

  • Valeur de retour - Explique ce que la commande renvoie, si elle renvoie une valeur.

  • Exemple de code - Illustre une façon d’utiliser la commande dans un projet.

Éléments communs de l’API Python#

Élément

Ce que cela signifie

Méthode

Une commande appelée sur un objet tel que drivetrain.rotation(…).

Fonction

Une commande appelée directement, telle que wait(…) ou print(…).

Paramètre

Une valeur passée à une méthode ou une fonction pour contrôler son comportement.

Paramètre optionnel

Un paramètre qui peut être omis afin que le comportement par défaut soit utilisé.

Valeur de retour

Une valeur renvoyée par une commande, telle qu’un nombre, du texte ou une valeur booléenne.

Vocabulaire Python de base#

Terme

Ce que cela signifie

Variable

Un nom qui stocke une valeur, comme angle = 90.

Chaîne

Texte entre guillemets, comme “Hello”.

Entier

Un nombre positif ou négatif, tel que 90.

Flotter

Un nombre décimal, tel que 25.5.

Booléen

Une valeur qui est soit True ou False.

Argument

Une valeur passée dans un appel de méthode ou de fonction, telle que DEGREES dans drivetrain.rotation(DEGREES).

Exemple de saisie de méthode#

rotation#

La rotation correspond à l’angle de rotation du robot, mesuré en degrés. Au début d’un projet, la valeur de rotation est fixée à 0 degré. La commande rotation renvoie la rotation actuelle du robot.

Tourner à droite augmente la rotation, et tourner à gauche la diminue. Par exemple, deux virages complets à droite correspondent à une rotation de 720 degrés.

Usage:
drivetrain.rotation(units)

Paramètres

Description

units

Optionnel. Unité de rotation : DEGREES (par défaut).

 
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)
Sur cette page