Instrumen kustom

Gunakan JavaScript dan JSX untuk menentukan konten dan tampilan instrumen. CapDrive menjalankan skrip dasbor, menggambar teks, grafik, kurva, dan peta ke dasbor, dan menyegarkan layar saat data diperbarui.

Cara kerja meteran

Setiap meteran khusus memiliki skrip. main() dalam skrip adalah entri gambar dan mengembalikan layar yang terdiri dari View bawaan: Text menampilkan teks, Circle menggambar lingkaran, LineChart menampilkan kurva, dan wadah tata letak bertanggung jawab untuk mengatur konten ini.

Skrip dapat memperoleh kecepatan saat ini, kecepatan putaran (RPM) dan pembacaan lainnya di main(), menghitung jumlah, warna atau sudut yang akan ditampilkan, dan kemudian mengembalikan hasilnya sebagai konten dan atribut View. Misalnya, setelah membaca kecepatan, Anda dapat menulis nilainya menjadi Text atau mengubahnya menjadi sudut busur Circle.

CapDrive akan memanggil main() lagi ketika perlu memperbarui layar dan menggambar hasil yang dikembalikan. Kode instrumen hanya perlu mendeskripsikan layar berdasarkan masukan ini, dan animasi atribut juga dijalankan pada akhir gambar. Sumber daya gambar dapat disimpan dengan instrumen dan digunakan berdasarkan nama sumber daya dalam kode.

Instalasi dan tampilan

Instrumen diimpor dan dibagikan melalui file .instrument. File yang ada dapat dibuka dari Impor instrumen di menu instrumen khusus, atau file dapat dibuka menggunakan CapDrive. Karya yang diimpor perlu ditambahkan ke dashboard secara terpisah.

Instrumen yang diimpor disimpan di Lainnya(…)→ Instrumen khusus. Pilih melalui Lainnya(…)→ Edit dasbor → + dan klik Selesai untuk melihatnya di dashboard.

Pekerjaan yang menggunakan parameter kendaraan juga perlu memilih parameter kendaraannya sendiri di Pengaturan instrumen → Pengikatan masukan untuk masukan OBD yang ada. Menjaga pengidentifikasi masukan tidak berubah memungkinkan Anda mewarisi kode pekerjaan tanpa menulis pengidentifikasi perangkat ke dalam skrip.

Menulis dan mempratinjau

Pilih Tambahkan instrumen baru di Lainnya(…)→ Instrumen khusus untuk masuk ke editor. Area pengeditan digunakan untuk menulis main() dan View; klik nama di bagian atas untuk mengatur nama instrumen, input binding, dan opsi lainnya. Roda gigi membuka Konfigurasi parameter, yang dapat mengelola enam jenis input: nilai numerik, teks, saklar, item pilihan, data dasar, dan data OBD. Meteran baru sudah memiliki input kecepatan dasar dengan pengenal speed.

Anda dapat melihat pratinjau teks, tata letak, grafik, dan animasi kapan saja saat mengedit. Pratinjau menyediakan input analog untuk memudahkan pemeriksaan instrumen saat diparkir. Ketika terjadi kesalahan kode, itu dapat ditemukan dari nomor baris di log. Setelah menyimpan, tambahkan meteran ke dasbor untuk menggunakan pembacaan sebenarnya.

"Pengukur Kecepatan Pertama" memberikan kode dan deskripsi lengkap; referensi API mencantumkan View, properti, tipe, dan antarmuka runtime yang tersedia.

Buat instrumen kecepatan pertama

Gunakan data mengemudi

$data memberikan pembacaan terkini dan sampel terkini ke skrip. Bidang dasar seperti kecepatan dan jarak dapat langsung digunakan untuk tampilan numerik; parameter seperti kecepatan kendaraan (RPM) dan suhu cairan pendingin disediakan melalui perangkat OBD yang dikonfigurasi. Skrip juga dapat menghasilkan kurva menggunakan pengambilan sampel historis.

Setiap kali main() dijalankan, bidang yang diperlukan dibaca, nilai diproses, dan View dibuat. Pembacaan mungkin tidak tersedia untuk sementara, sehingga kode tampilan harus menyediakan konten yang sesuai untuk pengukuran yang hilang. Dokumen data instrumen secara terpusat menggambarkan struktur lapangan, referensi OBD, pengambilan sampel historis, dan penanganan nilai nol.

Data instrumen

Lanjutkan membaca