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 Kuartal 2 dan Kuartal 4. Untuk membangun dan berkontribusi ke AOSP, sebaiknya gunakan android-latest-release, bukan aosp-main. Cabang manifes android-latest-release akan selalu merujuk pada rilis terbaru yang di-push 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.

Serentak STA/STA Wi-Fi

Android 12 memperkenalkan konkurensi Wi-Fi STA/STA, yang memungkinkan perangkat terhubung ke dua jaringan Wi-Fi secara serentak. Fitur opsional ini memungkinkan fungsi berikut:

Make-before-break: Perangkat membuat koneksi ke jaringan Wi-Fi baru sebelum memutuskan koneksi yang ada. Hal ini menghasilkan transisi yang lebih lancar saat beralih antar-jaringan Wi-Fi.
Koneksi internet dan lokal-saja serentak: Perangkat terhubung ke jaringan lokal-saja tanpa mengganggu koneksi penyedia internet utama perangkat.
Koneksi internet dan terbatas serentak: Perangkat terhubung ke jaringan terbatas (hanya tersedia untuk aplikasi istimewa tertentu) tanpa mengganggu koneksi penyedia internet utama perangkat.
(Android 13 atau yang lebih baru) Beberapa jaringan serentak dengan koneksi internet: Perangkat terhubung ke dua jaringan yang tidak dibatasi dan tersedia untuk semua aplikasi, serta menyediakan konektivitas internet.

Halaman ini menjelaskan perilaku perangkat saat fitur ini diaktifkan dan detail penerapan untuk produsen dan vendor perangkat.

Penerapan

Perangkat harus mendukung hal berikut untuk menerapkan konkurensi Wi-Fi STA/STA:

Chip atau firmware Wi-Fi harus mendukung dua koneksi STA serentak. Firmware harus mendukung semua kombinasi saluran dan band untuk kedua koneksi. Untuk menghindari masalah performa, sebaiknya gunakan chip Wi-Fi yang mendukung DBS 2x2+2x2.
Perangkat harus mendukung API berikut dalam penerapan AIDL atau HIDL IWifiChip.
- IWifiChip.setMultiStaPrimaryConnection(String ifName)
- IWifiChip.setMultiStaUseCase(MultiStaUseCase useCase)
Kombinasi antarmuka Wi-Fi HAL harus memiliki dua antarmuka STA serentak yang diekspos menggunakan format spesifikasi seperti [{STA} <= 2, ...]. Untuk mengetahui informasi selengkapnya, lihat Konkurensi multi-antarmuka Wi-Fi.

Jika prasyarat tersebut terpenuhi, terapkan konkurensi Wi-Fi STA/STA dengan melakukan hal berikut:

Aktifkan satu atau beberapa fungsi secara individual menggunakan overlay resource runtime (dinonaktifkan secara default).
- Make-before-break: config_wifiMultiStaNetworkSwitchingMakeBeforeBreakEnabled
- Koneksi internet dan lokal-saja serentak: config_wifiMultiStaLocalOnlyConcurrencyEnabled
- Koneksi internet dan terbatas serentak: config_wifiMultiStaRestrictedConcurrencyEnabled
- Beberapa jaringan serentak dengan koneksi internet: config_wifiMultiStaMultiInternetConcurrencyEnabled
Validasi setiap penerapan seperti yang dijelaskan di bagian masing-masing.

Untuk mendukung konkurensi Wi-Fi STA/STA dengan lebih baik, sebaiknya framework dan aplikasi yang disesuaikan OEM menggunakan metode NetworkCallback#onCapabilitiesChanged() dan bukan WifiManager#getConnectionInfo(), yang hanya menampilkan WifiInfo untuk satu jaringan dan tidak digunakan lagi di Android 12. Untuk mengetahui informasi selengkapnya, lihat API Permintaan Jaringan Wi-Fi untuk konektivitas peer-to-peer.

Make-before-break

Fungsi make-before-break memungkinkan perangkat terhubung ke jaringan Wi-Fi baru sambil mempertahankan koneksi jaringan Wi-Fi yang ada, dan hanya terputus dari jaringan lama saat berhasil terhubung ke jaringan Wi-Fi baru dan memiliki akses internet.

Kasus penggunaan make-before-break mengatasi masalah berikut di Android 11 atau yang lebih lama, dengan perangkat harus terputus dari jaringan Wi-Fi yang ada sebelum terhubung ke jaringan baru (break-before-make).

Saat terhubung ke jaringan baru, perangkat mungkin menemukan bahwa sandi Wi-Fi yang tersimpan salah atau jaringan baru tidak memiliki akses internet. Hal ini memaksa perangkat untuk beralih kembali ke jaringan lama, sehingga menyebabkan waktu yang signifikan tanpa konektivitas Wi-Fi.
Jaringan lama terputus tiba-tiba, yang berarti semua soket ditutup. Aplikasi sering kali tidak bereaksi dengan baik terhadap hilangnya konektivitas secara tiba-tiba dan hal ini dapat menyebabkan pengguna mengalami beberapa detik tanpa konektivitas internet hingga koneksi baru sepenuhnya dibuat.
Jaringan default berubah dua kali, dari jaringan Wi-Fi lama ke seluler, lalu dari seluler ke jaringan Wi-Fi baru. Hal ini menyebabkan aplikasi bereaksi terhadap perubahan jaringan dua kali. Perangkat juga harus menghabiskan waktu singkat menggunakan data seluler.

Alur make-before-break hanya digunakan untuk peralihan jaringan Wi-Fi otomatis yang dimulai oleh OS. Peralihan jaringan yang dimulai pengguna menggunakan alur break-before-make lama, dengan jaringan sebelumnya terputus sepenuhnya sebelum jaringan baru terhubung. Dalam kasus tertentu, alur break-before-make digunakan bahkan dalam peralihan otomatis yang dimulai oleh OS, misalnya, saat beralih antara dua jaringan yang dikonfigurasi untuk menggunakan alamat MAC pabrik.

Aplikasi dapat memeriksa apakah kasus penggunaan ini didukung di perangkat menggunakan WifiManager#isMakeBeforeBreakWifiSwitchingSupported() API.

Memvalidasi make-before-break

Untuk memvalidasi penerapan Anda, picu peralihan jaringan Wi-Fi otomatis (dengan memverifikasi jaringan dengan kekuatan sinyal yang lebih kuat daripada jaringan yang terhubung tersedia) dan verifikasi bahwa perangkat mempertahankan koneksi yang ada saat terhubung ke jaringan baru. Untuk melihat status kedua antarmuka Wi-Fi dan memverifikasi bahwa keduanya terhubung, gunakan perintah berikut:

adb shell wpa_cli -i wlan0 status ; echo ; adb shell wpa_cli -i wlan1 status

Jika jaringan baru tidak memiliki konektivitas, perangkat akan mencoba terhubung ke jaringan, sambil mempertahankan koneksi dengan jaringan yang ada, dan membatalkan upaya tersebut saat mendeteksi bahwa jaringan baru tidak memiliki internet. Kemudian, perangkat akan terus menggunakan koneksi yang ada sebagai jaringan Wi-Fi utama.

Koneksi internet dan lokal-saja serentak

Fungsi koneksi internet dan lokal-saja serentak memungkinkan perangkat terhubung ke koneksi lokal-saja, seperti koneksi ke perangkat IoT, secara serentak dengan jaringan penyedia internet utama. Fungsi ini meningkatkan pengalaman pengguna saat terhubung langsung ke perangkat IoT, seperti kamera, yang dapat dilakukan melalui WifiNetworkSpecifier API yang ditambahkan di Android 10.

Di Android 11 dan yang lebih lama, perangkat terputus dari jaringan Wi-Fi utama saat terhubung ke perangkat IoT, sehingga menyebabkan hilangnya konektivitas internet (kecuali jika perangkat memiliki jenis transportasi lain yang tersedia, seperti data seluler).

Aplikasi dapat memeriksa apakah fungsi ini didukung di perangkat menggunakan WifiManager#isStaConcurrencyForLocalOnlyConnectionsSupported() API.

Untuk mengetahui informasi selengkapnya tentang perubahan pada fungsi koneksi internet dan lokal-saja serentak di Android 12, lihat Wi-Fi Network Request API untuk konektivitas peer-to-peer.

Memvalidasi koneksi internet dan lokal-saja

Untuk memvalidasi fungsi ini, gunakan pengujian CTS MultiStaConcurrencyWifiNetworkSpecifierTest.

Koneksi internet dan terbatas serentak

Fungsi koneksi internet dan terbatas serentak memungkinkan perangkat terhubung secara serentak ke jaringan Wi-Fi utama untuk pengguna dan jaringan Wi-Fi terbatas yang hanya tersedia untuk aplikasi tertentu.

Aplikasi dapat memeriksa apakah fungsi ini didukung di perangkat menggunakan WifiManager#isStaConcurrencyForRestrictedConnectionsSupported() API.

Untuk memungkinkan perangkat terhubung ke jaringan Wi-Fi terbatas sekunder, ikuti langkah-langkah berikut:

Tambahkan saran jaringan Wi-Fi dengan setOemPaid atau setOemPrivate yang ditetapkan ke benar (true).
Di ConnectivityManager, ajukan NetworkRequest dengan kemampuan yang sesuai:
- NET_CAPABILITY_OEM_PAID untuk setOemPaid
- NET_CAPABILITY_OEM_PRIVATE untuk setOemPrivate

Saat perangkat mendeteksi hasil pemindaian dengan jaringan yang cocok dengan saran OEM berbayar atau OEM pribadi, perangkat akan otomatis terhubung ke jaringan tersebut sebagai jaringan sekunder.

Memvalidasi koneksi internet dan terbatas serentak

Untuk memvalidasi fungsi ini, gunakan pengujian CTS MultiStaConcurrencyRestrictedWifiNetworkSuggestionTest.

Beberapa jaringan serentak dengan koneksi internet

Tersedia untuk Android 13 atau yang lebih baru, fitur beberapa jaringan serentak dengan koneksi internet memungkinkan perangkat terhubung secara serentak ke dua jaringan (AP) yang tidak dibatasi (semua aplikasi memiliki akses) dan menyediakan akses internet.

Aplikasi dapat memeriksa apakah fitur ini didukung di perangkat menggunakan metode WifiManager#isStaConcurrencyForMultiInternetSupported().

Jika fitur ini didukung, aplikasi istimewa dapat mengaktifkan fitur ini menggunakan metode WifiManager#setStaConcurrencyForMultiInternetMode(int mode). Fitur ini memiliki mode berikut:

WifiManager#WIFI_MULTI_INTERNET_MODE_DBS_AP: Membatasi koneksi ganda ke band ganda AP DBS.
WifiManager#WIFI_MULTI_INTERNET_MODE_MULTI_AP: Terhubung ke AP arbitrer tempat koneksi individual menggunakan band yang berbeda.
WifiManager#WIFI_MULTI_INTERNET_MODE_DISABLED: Menonaktifkan fitur.

Untuk mengkueri mode fitur aktif, gunakan metode WifiManager#getStaConcurrencyForMultiInternetMode().

Saat fitur diaktifkan, gunakan langkah-langkah berikut untuk meminta jaringan Wi-Fi penyedia internet tambahan.

Buat specifier jaringan Wi-Fi menggunakan WifiNetworkSpecifier.Builder. Pilih band untuk specifier menggunakan metode setBand(). Jangan tentukan SSID atau BSSID karena jaringan tambahan untuk band yang ditentukan dipilih oleh framework Wi-Fi.
Menggunakan ConnectivityManager, buat NetworkRequest dengan kemampuan NET_CAPABILITY_INTERNET.
Tambahkan specifier ke permintaan jaringan bersama dengan a NetworkCallback instance untuk melacak status permintaan, dan kirim permintaan ke ConnectivityManager. Jika jaringan tersimpan dengan band yang diminta tersedia dalam hasil pemindaian, dan koneksi ke jaringan berhasil, NetworkCallback.onAvailable() dipanggil pada objek callback.

Memvalidasi beberapa jaringan serentak dengan koneksi internet

Untuk memvalidasi fungsi ini, gunakan pengujian CTS berikut:

CTS: MultiStaConcurrencyMultiInternetWifiNetworkTest

Panduan chip Wi-Fi vendor

Untuk vendor chip Wi-Fi, gunakan panduan berikut untuk mendukung konkurensi Wi-Fi STA/STA.

Chip Wi-Fi harus mendukung koneksi STA ganda serentak. Artinya, chip Wi-Fi mendukung hal berikut:

Setiap antarmuka STA memiliki MAC unik yang dapat diprogram oleh framework.
Antarmuka STA sekunder dapat dibuat dan dihancurkan secara dinamis.
Setiap STA dapat terhubung ke SSID yang berbeda (baik dalam band yang sama atau band yang berbeda).
Setiap STA dapat terhubung ke SSID yang sama (baik dalam band yang sama atau band yang berbeda). Kedua STA tidak boleh terhubung ke BSSID yang sama.

Fitur penting harus beroperasi berdasarkan per antarmuka dan harus tersedia di antarmuka utama. Berikut adalah daftar fitur penting ini:

Roaming harus didukung di setidaknya antarmuka utama (ditetapkan menggunakan IWifiChip.setMultiStaPrimaryConnection()). Jika roaming didukung di kedua antarmuka, keputusan pada satu koneksi tidak boleh bertentangan dengan koneksi serentak kedua. Misalnya, satu antarmuka tidak boleh melakukan roaming ke BSSID koneksi lainnya.
APF (dan offload lainnya seperti ARP dan NS) harus didukung di setidaknya antarmuka utama (ditetapkan menggunakan IWifiChip.setMultiStaPrimaryConnection()).
Statistik lapisan link harus beroperasi berdasarkan per antarmuka.

Berikut adalah penerapan chip Wi-Fi yang direkomendasikan untuk berbagai skenario konkurensi:

Chip Wi-Fi harus mengizinkan framework memanggil IWifiChip.setMultiStaUseCase() dengan salah satu konstanta berikut untuk menentukan fungsi saat ini:
- DUAL_STA_TRANSIENT_PREFER_PRIMARY: Menentukan fungsi Make-Before-Break. Kualitas koneksi utama harus diprioritaskan daripada koneksi sekunder.
- DUAL_STA_NON_TRANSIENT_UNBIASED: Menentukan fungsi koneksi internet dan lokal-saja serentak atau koneksi internet dan terbatas serentak. Kualitas kedua koneksi harus diprioritaskan secara setara.
Karena STA ganda serentak dapat menyebabkan mode operasi MCC, SCC, dan DBS, penerapan vendor harus memilih konfigurasi radio terbaik saat framework memanggil IWifiChip.setMultiStaUseCase() untuk menunjukkan fungsi. Berikut adalah panduan umum:
- DBS 2x2+2x2 lebih disukai jika tersedia.
- Hindari DBS 1x1+1x1 jika memungkinkan karena dampak yang berlebihan pada kualitas koneksi. Sebagai gantinya, sebaiknya gunakan MCC.
- Siklus tugas MCC harus dapat dikonfigurasi oleh driver atau firmware untuk berbagai fungsi. Framework tidak menetapkan siklus tugas MCC secara langsung, tetapi mengkueri informasi ini menggunakan StaLinkLayerIfaceStats.timeSliceDutyCycleInPercent.
- Jika menggunakan MCC, sebaiknya gunakan siklus tugas berikut antara koneksi utama dan sekunder:
  - DUAL_STA_TRANSIENT_PREFER_PRIMARY: 70% utama, 30% sekunder.
  - DUAL_STA_NON_TRANSIENT_UNBIASED: 50% utama, 50% sekunder.