Python#

W dokumencie VEX AIM Python API Reference wyjaśniono, co robi każde polecenie, metoda i funkcja, jakich danych wejściowych używa, co zwraca i jak można je wykorzystać w projekcie.

Skorzystaj z tego odniesienia, jeśli chcesz zrozumieć polecenie przed dodaniem go do projektu, sprawdzić, jakie wartości akceptuje lub zwraca, lub porównać powiązane polecenia w danej kategorii.

Polecenia Pythona są używane w projektach VEXcode AIM Python. Projekty bloków korzystają z sekcji API bloków.

Jak czytać wpis metody#

Większość wpisów dotyczących Pythona zawiera następujące części:

Nazwa polecenia – oficjalna nazwa polecenia, metody lub funkcji.
Opis – wyjaśnia, co robi polecenie i kiedy jest przydatne.
Użycie – Pokazuje składnię użytą do zapisania polecenia w kodzie.
Parametry – wypisuje akceptowane przez polecenie dane wejściowe i wyjaśnia, co każdy z nich robi.
Wartość zwracana – wyjaśnia, co polecenie zwraca, jeśli zwraca wartość.
Przykładowy kod – Pokazuje jeden sposób wykorzystania polecenia w projekcie.

Wspólne elementy API Pythona#

Element	Co to znaczy
Metoda	Polecenie wywoływane na obiekcie takim jak `robot.move_at(…)`.
Funkcjonować	Polecenie wywoływane bezpośrednio, takie jak `wait(…)` lub `print(…)`.
Parametr	Wartość przekazywana do metody lub funkcji w celu kontrolowania jej działania.
Parametr opcjonalny	Parametr, który można pominąć, aby użyć domyślnego zachowania.
Wartość zwracana	Wartość zwracana przez polecenie, np. liczba, tekst lub wartość logiczna.

Podstawowe słownictwo Pythona#

Termin	Co to znaczy
Zmienny	Nazwa przechowująca wartość, np. `speed = 50`.
Smyczkowy	Tekst w cudzysłowie, np. `“Hello”`.
Liczba całkowita	Liczba dodatnia lub ujemna, np. `90`.
Platforma	Liczba z częścią dziesiętną, np. `25.5`.
Boolean	Wartość, która wynosi `True` lub `False`.
Argument	Wartość przekazana do wywołania metody lub funkcji, np `0` w `robot.move_at(0)`.

Przykładowy wpis metody#

ruch_w#

move_at porusza robota w nieskończoność pod określonym kątem. Robot będzie się poruszał, dopóki nie otrzyma innej akcji, takiej jak ruch pod innym kątem, obrót lub zatrzymanie.

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

Parametry	Opis
`angle`	Kąt, pod jakim porusza się robot, wyrażony w stopniach. Może to być liczba całkowita lub dziesiętna od -360 do 360.
`velocity`	Opcjonalnie. Prędkość ruchu od 0% do 100% przy użyciu `PERCENT`lub od 0 do 200 milimetrów na sekundę przy użyciu `MMPS`. Może to być liczba całkowita lub dziesiętna. Jeśli prędkość nie zostanie podana, robot porusza się z bieżącą prędkością ruchu.
`units`	Opcjonalnie. Jednostka prędkości: `PERCENT` (domyślnie) lub `MMPS` (milimetry na sekundę).

# Move forward
robot.move_at(0)