Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Halaman ini diterjemahkan oleh Cloud Translation API.

Wi-Fi Aware

Fitur Wi-Fi Aware yang ditambahkan di Android 8.0 memungkinkan perangkat pendukung untuk menemukan, menghubungkan, dan menjangkau (ditambahkan di Android 9) satu sama lain secara langsung menggunakan protokol Wi-Fi Aware tanpa akses internet atau jaringan seluler. Fitur ini, dibangun berdasarkan Wi-Fi Alliance (WFA) spesifikasi Wi-Fi Aware (versi 2.0, 3.0, 3.1, dan 4.0), memungkinkan berbagi aplikasi dengan kecepatan tinggi dan data tidak aktif di antara aplikasi lain yang tepercaya.

Contoh dan sumber

Untuk menggunakan fitur ini, produsen perangkat harus menerapkan HAL Vendor Wi-Fi. Di Android 14 dan yang lebih tinggi, antarmuka HAL Vendor ditentukan menggunakan AIDL. Untuk Android 13 dan yang lebih rendah, antarmuka HAL Vendor ditentukan menggunakan HIDL.

Ikuti antarmuka Wi-Fi untuk menggunakan fitur Wi-Fi Aware. Bergantung pada antarmuka yang diimplementasikan, hal ini dapat berupa:

AIDL: hardware/interfaces/wifi/aidl
HIDL: hardware/interfaces/wifi/1.2 atau yang lebih baru

Anda dapat melihat Wi-Fi HAL lama untuk melihat korelasinya dengan antarmuka AIDL dan HIDL: hardware/libhardware_legacy/+/main/include/hardware_legacy/wifi_nan.h.

Penerapan

Produsen perangkat harus memberikan dukungan framework dan HAL/firmware:

Framework:
- Kode AOSP
- Aktifkan Aware: Memerlukan tombol fitur dan tanda build
Dukungan HAL Wi-Fi Aware (NAN) (yang menyiratkan dukungan firmware)

Untuk menerapkan fitur ini, produsen perangkat mengimplementasikan antarmuka Wi-Fi dan mengaktifkan dua tombol fitur:

Di BoardConfig.mk atau BoardConfig-common.mk yang terletak di device/<oem>/<device>, tambahkan tanda berikut:
```
WIFI_HIDL_FEATURE_AWARE := true
```

Di device.mk yang berada di device/<oem>/<device>, ubah variabel lingkungan PRODUCT_COPY_FILES guna menyertakan dukungan untuk fitur Wi-Fi Aware:

PRODUCT_COPY_FILES +=
frameworks/native/data/etc/android.hardware.wifi.aware.xml:$(TARGET_COPY_OUT_VENDOR)/etc/permissions/android.hardware.wifi.aware.xml

Wi-Fi Aware mencakup jangkauan ke perangkat peer yang menggunakan protokol IEEE 802.11mc, yang juga dikenal sebagai Waktu Round Trip (RTT). Sub-fitur Wi-Fi Aware ini bergantung pada perangkat yang mendukung fitur Wi-Fi RTT, yaitu mengharuskan perangkat mendukung Wi-Fi Aware dan Wi-Fi RTT. Untuk mengetahui detail selengkapnya, lihat Wi-Fi RTT.

Jika tidak, semua yang diperlukan untuk fitur ini sudah disertakan dalam AOSP.

Flag WIFI_HIDL_FEATURE_AWARE diabaikan jika tanda WIFI_HAL_INTERFACE_COMBINATIONS ditentukan. Untuk mengetahui informasi selengkapnya, lihat Konkurensi multi-antarmuka Wi-Fi.

Pengacakan MAC

Android mengharuskan alamat MAC penemuan Wi-Fi Aware (NMI) dan antarmuka data (NDP) diacak dan tidak identik dengan alamat MAC perangkat yang sebenarnya. Alamat MAC harus:

Diacak setiap kali Wi-Fi Aware diaktifkan atau diaktifkan kembali.
Saat Wi-Fi Aware diaktifkan, alamat MAC harus diacak pada interval reguler yang dikonfigurasi oleh parameter NanConfigRequest.macAddressRandomizationIntervalSec. Setelan ini dikonfigurasi oleh framework secara default menjadi 30 menit.

Catatan: Sesuai spesifikasi Wi-Fi Aware, pengacakan dapat ditangguhkan saat NDP dikonfigurasi. Penangguhan tidak berarti bahwa alamat MAC pabrik digunakan (tidak boleh digunakan untuk Wi-Fi Aware), tetapi alamat MAC diacak ulang lebih jarang daripada yang diperlukan.

Menangguhkan dan melanjutkan

Di Android 14 dan yang lebih tinggi, Wi-Fi Aware mendukung kemampuan aplikasi dengan hak istimewa untuk menangguhkan dan melanjutkan sesi penemuan aktif (termasuk semua jalur data yang terkait dengan sesi tersebut). Mendukung kemampuan ini memungkinkan perangkat melanjutkan sesi penemuan dengan lebih cepat dan menggunakan lebih sedikit daya karena sesi penemuan dapat ditangguhkan.

Jika perangkat mendukung kemampuan penangguhan dan melanjutkan ini, firmware akan menangguhkan sesi Wi-Fi Aware saat aplikasi dengan hak istimewa menangguhkan sesi penemuan. Saat sesi penemuan dalam status ditangguhkan, perangkat tidak mengirimkan atau menerima frame untuk sesi tersebut, termasuk NDP aktif dalam sesi tersebut. Jika semua sesi penemuan ditangguhkan, perangkat tidak akan mengirimkan atau menerima frame Wi-Fi Aware.

Saat aplikasi dengan hak istimewa melanjutkan sesi penemuan yang ditangguhkan, framework akan mengembalikan sesi tersebut ke status sebelumnya, termasuk semua sesi NDP terkait. Melanjutkan sesi penemuan yang ditangguhkan lebih cepat daripada memunculkan Wi-Fi Aware dan membuat sesi penemuan baru.

Untuk mendukung kemampuan guna menangguhkan dan melanjutkan sesi penemuan, produsen perangkat harus memberikan dukungan HAL dan firmware. Untuk detailnya, lihat IWifiNanIface.java.

Produsen perangkat dapat menggunakan komunikasi out-of-band (misalnya, BLE) untuk menyinkronkan penangguhan dan melanjutkan di beberapa perangkat.

Validasi

Android menyediakan serangkaian pengujian unit, pengujian Compatibility Test Suite (CTS), dan pengujian CTS Verifier untuk memvalidasi fitur Wi-Fi Aware. Wi-Fi Aware juga dapat diuji menggunakan Vendor Test Suite (VTS).

Pengujian Unit

Pengujian paket Wi-Fi Aware dijalankan menggunakan:

Pengujian layanan:

atest com.android.server.wifi.aware

Pengelola menguji:

atest android.net.wifi.aware

Pengujian Compatibility Test Suite (CTS)

Gunakan uji CTS untuk memvalidasi fitur Wi-Fi Aware. CTS mendeteksi saat fitur diaktifkan dan otomatis menyertakan pengujian terkait.

Uji CTS dapat dipicu menggunakan:

atest SingleDeviceTest

Uji Pemverifikasi CTS

Uji CTS Verifier memvalidasi perilaku Wi-Fi Aware menggunakan dua perangkat: perangkat uji dan perangkat berkualitas bagus. Untuk menjalankan pengujian, buka CTS Verifier dan buka bagian berjudul Pengujian Wi-Fi Aware.