Mulai tahun 2026, untuk menyelaraskan dengan model pengembangan stabil trunk kami dan memastikan stabilitas platform untuk ekosistem, kami akan memublikasikan kode sumber ke AOSP pada Q2 dan Q4. Untuk membuat dan berkontribusi ke AOSP, gunakan android-latest-release. Cabang manifes android-latest-release akan selalu merujuk ke rilis terbaru yang dikirim ke AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Input kustom OEM

Gunakan input kustom OEM untuk menambahkan peristiwa input Mobil baru untuk fitur Android baru dan non-standar. Peristiwa input non-standar tidak dipetakan oleh KeyEvent Android yang ada, yang dirancang agar bersifat umum dan berfungsi di platform Android mana pun, tetapi tidak diperluas untuk menerapkan fitur khusus OEM. Misalnya, tombol yang terletak di kontrol kemudi yang, saat ditekan, akan membuka aplikasi peta (melalui intent) dengan lokasi mobil saat ini. Fitur ini memungkinkan pengemudi memvisualisasikan lokasi mereka saat ini tanpa terganggu saat mengemudi.

Artikel ini menjelaskan cara menggunakan kembali KeyEvent Android yang ada untuk membuat CustomInputEvent untuk digunakan hanya jika tidak ada KeyEvent Android yang dapat digunakan untuk mewakili fitur tersebut.

HW_CUSTOM_INPUT

Input kustom OEM diwakili oleh HW_CUSTOM_INPUT dan CustomInputEvent.java. HW_CUSTOM_INPUT adalah peristiwa native, yang dibuat oleh hardware mobil (Vehicle HAL). OEM menentukan cara membuat peristiwa ini. Akses ke HW_CUSTOM_INPUT ditetapkan sebagai [hanya baca], dengan VehiclePropertyAccess:READ.

Untuk memastikan Vehicle HAL selalu dapat menyiarkan nilai terbaru yang tersedia, notifikasi HW_CUSTOM_INPUT ditetapkan sebagai ON_CHANGE, dengan VehiclePropertyChangeMode:ON_CHANGE.

Nilai HW_CUSTOM_INPUT terdiri dari array `int32`int32 generik, yang ditetapkan sebagai GLOBAL`GLOBAL`VehicleArea:GLOBAL (dengan `VehicleArea:GLOBAL`). Tiga bilangan bulat generik adalah:

Elemen pertama mewakili kode input yang akan ditentukan oleh OEM. Anda dapat mengaitkan semantik apa pun dengan kode input.

Catatan: Jika Anda tidak memerlukan lebih dari 10 kode input, Anda dapat menggunakan fungsi generik (lihat INPUT_CODE_F1 hingga INPUT_CODE_F10 konstanta yang ditentukan dalam CustomInputType, lihat file types.hal) untuk membantu keterbacaan. Penggunaan fungsi generik sepenuhnya bersifat opsional.
Elemen kedua menyimpan tampilan target, seperti tampilan utama atau cluster.
Elemen ketiga berisi jumlah pengulangan peristiwa. Misalnya, untuk menunjukkan berapa kali tombol ditekan.

CustomInputEvent dan Car Input API

InputHalService adalah layanan Mobil yang menerima HW_CUSTOM_INPUT masuk dari Vehicle HAL.

InputHalService mengonversi HW_CUSTOM_INPUT masuk menjadi CustomInputEvent, class parcelable Java yang terletak di car-lib/src/android/car/input, bersama dengan antarmuka aidl masing-masing.

CarInputService, layanan Input Mobil inti, menerima CustomInputEvents masuk, lalu mengirimkannya ke layanan sistem Android terdaftar.

Untuk mendaftar dan menerima CustomInputEvents masuk, layanan sistem harus:

Mengimplementasikan CarInputManager.CarInputCaptureCallback#onKeyEvents.
Mendaftar melalui CarInputManager#requestInputEventCapture, dengan meneruskan CarInputManager.INPUT_TYPE_CUSTOM_INPUT_EVENT sebagai parameter jenis input.

Untuk membatalkan pendaftaran, layanan harus memanggil CarInputManager#releaseInputEventCapture.

Diagram berikut mengilustrasikan alur kerja peristiwa Input Kustom OEM.

Alur kerja input kustom OEM

Layanan sistem Android OEM

OEM menyediakan layanan sistem Android mereka untuk menangani CustomInputEvents masuk dari CarInputService.

Hanya layanan yang ditandai dengan android.permission.INJECT_EVENTS izin hak istimewa yang dapat mendaftar dan menerima CustomInputEvents dari Car Input API (CarInputManager). Tidak ada layanan atau aplikasi pihak ketiga yang dapat ditandatangani dengan izin sistem Android ini (hanya layanan OEM). Oleh karena itu, tidak ada layanan atau aplikasi pihak ketiga yang dapat mendaftar ke Car Input API.

Layanan sistem Android OEM dapat mengakses SystemApi dan metode publik.

Penerapan referensi

Lihat penerapan referensi di packages/services/Car/tests/SampleCustomInputService, yang disediakan sebagai contoh dan panduan. Misalnya, untuk menambahkan tombol baru di kontrol kemudi. Saat ditekan, tombol baru ini akan memulai aplikasi peta dengan lokasi mobil saat ini.

Dalam contoh ini, OEM memilih INPUT_CODE_F1 (fungsi praktis CustomInputEvent pertama) untuk mewakili fitur baru ini (membuka aplikasi peta dengan lokasi mobil saat ini).

Selama startup, layanan ini mendaftarkan dirinya ke CarInputManager melalui requestInputEventCapture (lihat kode pendaftaran penerapan referensi.

Saat menerima CustomInputEvents masuk, layanan ini akan mengirimkan intent untuk memulai aplikasi peta. Untuk mempelajari cara melakukannya, lihat CustomInputEventListener.java.