Python#

Referensi API Python VEX AIR menjelaskan apa yang dilakukan oleh setiap perintah, metode, dan fungsi, input apa yang digunakan, apa yang dikembalikan, dan bagaimana cara menggunakannya dalam sebuah proyek.

Gunakan referensi ini ketika Anda ingin memahami suatu perintah sebelum menambahkannya ke proyek, memeriksa nilai apa yang diterima atau dikembalikan, atau membandingkan perintah terkait dalam suatu kategori.

Perintah Python digunakan dalam proyek Python VEXcode AIR. Proyek Blocks menggunakan bagian API Blocks sebagai gantinya.

Cara Membaca Entri Metode#

Sebagian besar entri Python mencakup bagian-bagian berikut:

  • Nama perintah - Nama resmi dari perintah, metode, atau fungsi.

  • Deskripsi - Menjelaskan fungsi perintah dan kapan perintah tersebut berguna.

  • Penggunaan - Menunjukkan sintaks yang digunakan untuk menulis perintah dalam kode.

  • Parameter - Mencantumkan input yang diterima oleh perintah dan menjelaskan fungsi masing-masing input.

  • Nilai kembalian - Menjelaskan apa yang dilaporkan oleh perintah, jika perintah tersebut mengembalikan nilai.

  • Contoh kode - Menunjukkan salah satu cara perintah ini dapat digunakan dalam sebuah proyek.

Elemen API Python Umum#

Elemen

Apa artinya

Metode

Perintah yang dipanggil pada suatu objek seperti drone.take_off(…).

Fungsi

Perintah yang dipanggil secara langsung, seperti wait(…) atau print(…).

Parameter

Nilai yang diteruskan ke suatu metode atau fungsi untuk mengontrol apa yang dilakukannya.

Parameter opsional

Parameter yang dapat diabaikan sehingga perilaku default yang digunakan.

Nilai kembalian

Nilai yang dilaporkan kembali oleh suatu perintah, seperti angka, teks, atau Boolean.

Kosakata Dasar Python#

Ketentuan

Apa artinya

Variabel

Nama yang menyimpan nilai, seperti height = 500.

Rangkaian

Teks di dalam tanda kutip, seperti “Hello”.

Bilangan bulat

Angka positif atau negatif, seperti 90.

Mengambang

Angka dengan desimal, seperti 25.5.

Boolean

Nilai yang berupa True atau False.

Argumen

Nilai yang diteruskan ke panggilan metode atau fungsi, seperti 500 in drone.take_off(climb_to=500).

Contoh Entri Metode#

lepas landas#

Perintah take_off menghidupkan baling-baling dan mengangkat drone ke udara. Metode ini harus digunakan sebelum gerakan lain dapat dilakukan.

Penggunaan:

drone.take_off(climb_to, units, wait)

Parameter

Keterangan

climb_to

Posisi z yang akan dituju oleh drone.

units

Satuan yang digunakan:

  • CM - Sentimeter
  • MM - Milimeter
  • INCHES

wait

Opsional.

  • wait=True (default) - Drone menunggu hingga take_off selesai sebelum mengeksekusi baris kode berikutnya.
  • wait=False - Drone memulai aksi dan langsung melanjutkan ke baris kode berikutnya, tanpa menunggu take_off selesai.

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