İnternet bağlantısı için Wi-Fi öneri API'sı

Android 10 (API düzeyi 29) ve sonraki sürümleri çalıştıran cihazlar, uygulamanızın bir cihazın kablosuz erişim noktasına otomatik olarak bağlanması için ağ kimlik bilgileri eklemesine olanak tanır. WifiNetworkSuggestion'i kullanarak hangi ağa bağlanacağınızla ilgili öneriler sağlayabilirsiniz. Platform, kabul edilecek erişim noktasını uygulamanızdan ve diğer kullanıcılardan gelen bilgilere göre seçer.

Android 11 (API düzeyi 30) ve sonraki sürümlerde:

  • Çerçeve, EAP-SIM tabanlı Kurumsal öneriler (EAP-SIM, EAP-AKA, EAP-AKA-PRIME) için sahiplik gereksinimlerini zorunlu kılar. Bu tür önerilere yalnızca operatör tarafından imzalanmış uygulamalar izin verir.
  • Çerçeve, operatör tarafından imzalanmış bir uygulama tarafından sağlanan öneriler için otomatik olarak uygulamanın operatör imzalamasına karşılık gelen bir operatör kimliği atar. İlgili SIM cihazdan kaldırılırsa bu tür öneriler otomatik olarak devre dışı bırakılır.

Android 12 (API düzeyi 31) ve sonraki sürümlerde:

  • Rastgele hale getirilmiş MAC adresini düzenli olarak yeniden rastgele hale getiren kalıcı olmayan MAC rastgele hale getirme özelliğiyle ek gizlilik etkinleştirilebilir. Ağınızın rastgele hale getirme düzeyini belirtmek için setMacRandomizationSetting değerini kullanın.

  • isPasspointTermsAndConditionsSupported(): Hükümler ve Koşullar, ağ dağıtımlarının açık ağlar kullanan güvenli olmayan giriş portallarını güvenli bir Passpoint ağıyla değiştirmesini sağlayan bir Passpoint özelliğidir. Hükümler ve koşulların kabul edilmesi gerektiğinde kullanıcıya bir bildirim gösterilir. Şartlar ve koşullarla korunan Passpoint ağlarını öneren uygulamalar, cihazın bu özelliği desteklediğinden emin olmak için önce bu API'yi çağırmalıdır. Cihaz bu özelliği desteklemiyorsa bu ağa bağlanamaz. Alternatif veya eski bir ağ önerilmelidir.

  • isDecoratedIdentitySupported(): Ön ek dekorasyonu olan ağlarda kimlik doğrulaması yapılırken ağ operatörleri, ağ erişim tanımlayıcısını (NAI) güncelleyerek bir AAA ağının içindeki birden fazla proxy aracılığıyla açık yönlendirme gerçekleştirmek için ağ erişim tanımlayıcısını (NAI) güncelleyebilir (daha fazla bilgi için RFC 7542'ye bakın).

    Android 12, bu özelliği PPS-MO uzantıları için WBA spesifikasyonuna uygun olacak şekilde uygular. Ayarlanmış bir kimlik gerektiren Passpoint ağlarını öneren uygulamalar, cihazın bu özelliği desteklediğinden emin olmak için önce bu API'yi çağırmalıdır. Cihaz bu özelliği desteklemiyorsa kimlik etiketlenmez ve ağ kimlik doğrulaması başarısız olabilir.

Passpoint önerisi oluşturmak için uygulamaların PasspointConfiguration, Credential ve HomeSp sınıflarını kullanması gerekir. Bu sınıflar, Wi-Fi Alliance Passpoint spesifikasyonunda tanımlanan Passpoint profilini açıklar.

Aşağıdaki kod örneğinde; bir açık, bir WPA2, bir WPA3 ağı ve bir Passpoint ağı için kimlik bilgilerinin nasıl sağlanacağı gösterilmektedir:

Kotlin

val suggestion1 = WifiNetworkSuggestion.Builder()
        .setSsid("test111111")
        .setIsAppInteractionRequired(true) // Optional (Needs location permission)
        .build();

val suggestion2 = WifiNetworkSuggestion.Builder()
        .setSsid("test222222")
        .setWpa2Passphrase("test123456")
        .setIsAppInteractionRequired(true) // Optional (Needs location permission)
        .build();

val suggestion3 = WifiNetworkSuggestion.Builder()
        .setSsid("test333333")
        .setWpa3Passphrase("test6789")
        .setIsAppInteractionRequired(true) // Optional (Needs location permission)
        .build();

val passpointConfig = PasspointConfiguration(); // configure passpointConfig to include a valid Passpoint configuration
val suggestion4 = WifiNetworkSuggestion.Builder()
        .setPasspointConfig(passpointConfig)
        .setIsAppInteractionRequired(true) // Optional (Needs location permission)
        .build();

val suggestionsList = listOf(suggestion1, suggestion2, suggestion3, suggestion4);

val wifiManager = context.getSystemService(Context.WIFI_SERVICE) as WifiManager;

val status = wifiManager.addNetworkSuggestions(suggestionsList);
if (status != WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) {
    // do error handling here
}

// Optional (Wait for post connection broadcast to one of your suggestions)
val intentFilter = IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION);

val broadcastReceiver = object : BroadcastReceiver() {
    override fun onReceive(context: Context, intent: Intent) {
        if (!intent.action.equals(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) {
            return;
        }
        // do post connect processing here
    }
};
context.registerReceiver(broadcastReceiver, intentFilter);

Java

final WifiNetworkSuggestion suggestion1 =
  new WifiNetworkSuggestion.Builder()
  .setSsid("test111111")
  .setIsAppInteractionRequired(true) // Optional (Needs location permission)
  .build();

final WifiNetworkSuggestion suggestion2 =
  new WifiNetworkSuggestion.Builder()
  .setSsid("test222222")
  .setWpa2Passphrase("test123456")
  .setIsAppInteractionRequired(true) // Optional (Needs location permission)
  .build();

final WifiNetworkSuggestion suggestion3 =
  new WifiNetworkSuggestion.Builder()
  .setSsid("test333333")
  .setWpa3Passphrase("test6789")
  .setIsAppInteractionRequired(true) // Optional (Needs location permission)
  .build();

final PasspointConfiguration passpointConfig = new PasspointConfiguration();
// configure passpointConfig to include a valid Passpoint configuration

final WifiNetworkSuggestion suggestion4 =
  new WifiNetworkSuggestion.Builder()
  .setPasspointConfig(passpointConfig)
  .setIsAppInteractionRequired(true) // Optional (Needs location permission)
  .build();

final List<WifiNetworkSuggestion> suggestionsList =
  new ArrayList<WifiNetworkSuggestion> {{
    add(suggestion1);
    add(suggestion2);
    add(suggestion3);
    add(suggestion4);
  }};

final WifiManager wifiManager =
  (WifiManager) context.getSystemService(Context.WIFI_SERVICE);

final int status = wifiManager.addNetworkSuggestions(suggestionsList);
if (status != WifiManager.STATUS_NETWORK_SUGGESTIONS_SUCCESS) {
// do error handling here…
}

// Optional (Wait for post connection broadcast to one of your suggestions)
final IntentFilter intentFilter =
  new IntentFilter(WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION);

final BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
  @Override
  public void onReceive(Context context, Intent intent) {
    if (!intent.getAction().equals(
      WifiManager.ACTION_WIFI_NETWORK_SUGGESTION_POST_CONNECTION)) {
      return;
    }
    // do post connect processing here...
  }
};
context.registerReceiver(broadcastReceiver, intentFilter);

Uygulama ilk kez öneri verdikten hemen sonra kullanıcı bilgilendirilir. Bildirim türü, cihazda çalıştırılan Android sürümüne bağlıdır:

  • Android 11 (API düzeyi 30) ve sonraki sürümlerde uygulama ön planda çalışıyorsa kullanıcı bir iletişim kutusu ve uygulama arka planda çalışıyorsa bir bildirim görür.
  • Android 10'da (API düzeyi 29) kullanıcı, uygulamanın ön planda veya arka planda çalışmasına bakılmaksızın bir bildirim görür.

Platform, ağ önerilerinden birine bağlandığında ayarlar, ağ bağlantısını ilgili önerici uygulamasıyla ilişkilendiren metni gösterir.

Kullanıcı bağlantı kesme işlemlerini yönetme

Kullanıcı, ağa bağlıyken ağ önerilerinden biriyle olan bağlantıyı açıkça kesmek için kablosuz ağ seçiciyi kullanırsa söz konusu ağ hâlâ kapsama alanındayken yoksayılır. Bu süre zarfında uygulama, ağa karşılık gelen ağ önerisini kaldırıp yeniden eklese bile bu ağ otomatik bağlantı için dikkate alınmaz. Kullanıcı, daha önce bağlantısı kesilmiş olan bir ağa açıkça bağlanmak için kablosuz ağ seçiciyi kullanırsa söz konusu ağ hemen otomatik bağlantı için değerlendirilir.

Uygulamanın onay durumunu değiştirme

Ağ önerisi bildirimini reddettiğinde CHANGE_WIFI_STATE izni uygulamadan kaldırılır. Kullanıcı bu onayı daha sonra Kablosuz kontrol menüsüne (Ayarlar > Uygulamalar ve bildirimler > Özel Uygulama erişimi > Kablosuz Kontrolü > App name) giderek verebilir.