Kablosuz Ağ Farkındalığı özellikleri, Android 8.0 (API düzeyi 26) ve sonraki sürümleri çalıştıran cihazların, aralarında başka bir bağlantı türü olmadan birbirlerini keşfetmelerini ve doğrudan bağlanmalarını sağlar. Wi-Fi Aware, Neighbor Awareness Networking (NAN) olarak da bilinir.
Kablosuz Ağ Farkındalığı ağı, komşu cihazlarla kümeler oluşturarak veya cihaz bir bölgedeki ilk cihazsa yeni bir küme oluşturarak çalışır. Bu gruplandırma davranışı cihazın tamamı için geçerlidir ve Wi-FiAware sistem hizmeti tarafından yönetilir. Uygulamaların gruplandırma davranışı üzerinde hiçbir kontrolü yoktur. Uygulamalar, cihazdaki kablosuz ağ bağlantısı farkında donanımını yöneten kablosuz ağ bağlantısı farkında sistem hizmetiyle iletişim kurmak için kablosuz ağ bağlantısı farkında API'lerini kullanır.
Wi-Fi Aware API'leri, uygulamaların aşağıdaki işlemleri gerçekleştirmesine olanak tanır:
Diğer cihazları keşfetme: API, yakındaki diğer cihazları bulmak için bir mekanizmaya sahiptir. İşlem, bir cihaz bir veya daha fazla bulunabilir hizmeti yayınladığında başlar. Ardından, bir cihaz bir veya daha fazla hizmete abone olduğunda ve yayıncının kablosuz aralığına girdiğinde abone, eşleşen bir yayıncının bulunduğuna dair bildirim alır. Abone, bir yayıncı bulduktan sonra kısa bir mesaj gönderebilir veya bulunan cihazla ağ bağlantısı kurabilir. Cihazlar aynı anda hem yayıncı hem de abone olabilir.
Ağ bağlantısı oluşturma: İki cihaz birbirini keşfettikten sonra erişim noktası olmadan iki yönlü bir Kablosuz Farkında Ağ bağlantısı oluşturabilir.
Wi-Fi Aware ağ bağlantıları, Bluetooth bağlantılarına kıyasla daha uzun mesafelerde daha yüksek aktarım hızlarını destekler. Bu tür bağlantılar, fotoğraf paylaşımı uygulamaları gibi kullanıcılar arasında büyük miktarda veri paylaşan uygulamalar için kullanışlıdır.
Android 13 (API düzeyi 33) geliştirmeleri
Android 13 (API düzeyi 33) ve sonraki sürümleri çalıştıran ve anında iletişim modunu destekleyen cihazlarda uygulamalar, yayıncı veya abone keşif oturumu için anında iletişim modunu etkinleştirmek veya devre dışı bırakmak üzere PublishConfig.Builder.setInstantCommunicationModeEnabled() ve SubscribeConfig.Builder.setInstantCommunicationModeEnabled() yöntemlerini kullanabilir. Anında iletişim modu, mesaj alışverişini, hizmet keşfini ve yayıncı veya abone keşif oturumu kapsamında ayarlanan tüm veri yollarını hızlandırır. Bir cihazın anlık iletişim modunu destekleyip desteklemediğini belirlemek için isInstantCommunicationModeSupported() yöntemini kullanın.
Android 12 (API düzeyi 31) geliştirmeleri
Android 12 (API düzeyi 31), kablosuz ağ farkındalığı özelliğine bazı iyileştirmeler ekler:
- Android 12 (API düzeyi 31) veya sonraki sürümleri çalıştıran cihazlarda, uygulamanız bir hizmeti durdurması veya kapsama alanından çıkması nedeniyle kaybettiğinde uyarı almak için
onServiceLost()geri çağırma işlevini kullanabilirsiniz. - Wi-Fi Aware veri yollarının kurulumu basitleştirildi. Önceki sürümlerde, başlatıcının MAC adresini sağlamak için L2 mesajlaşma kullanılıyordu. Bu da gecikmeye neden oluyordu. Android 12 ve sonraki sürümleri çalıştıran cihazlarda yanıtlayan (sunucu), herhangi bir eşlemeyi kabul edecek şekilde yapılandırılabilir. Yani başlatıcının MAC adresini önceden bilmesi gerekmez. Bu, veri yolunun başlatılmasını hızlandırır ve yalnızca bir ağ isteğiyle birden fazla noktadan noktaya bağlantı sağlar.
- Android 12 veya sonraki sürümleri çalıştıran uygulamalar, mevcut veri yollarının sayısını almak, oturum yayınlamak ve oturumlara abone olmak için
WifiAwareManager.getAvailableAwareResources()yöntemini kullanabilir. Bu, uygulamanın istenen işlevi yürütmek için yeterli kaynak olup olmadığını belirlemesine yardımcı olabilir.
İlk kurulum
Uygulamanızı, kablosuz ağ bilinirliği keşfini ve ağ oluşturmayı kullanacak şekilde ayarlamak için aşağıdaki adımları uygulayın:
Uygulamanızın manifest dosyasında aşağıdaki izinleri isteyin:
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <!-- If your app targets Android 13 (API level 33) or higher, you must declare the NEARBY_WIFI_DEVICES permission. --> <uses-permission android:name="android.permission.NEARBY_WIFI_DEVICES" <!-- If your app derives location information from Wi-Fi APIs, don't include the "usesPermissionFlags" attribute. --> android:usesPermissionFlags="neverForLocation" /> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" <!-- If any feature in your app relies on precise location information, don't include the "maxSdkVersion" attribute. --> android:maxSdkVersion="32" />
Cihazın, aşağıdaki gibi
PackageManagerAPI ile kablosuz ağ farkındalığını destekleyip desteklemediğini kontrol edin:Kotlin
context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE)
Java
context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE);
Wi-Fi Aware'in şu anda kullanılıp kullanılamadığını kontrol edin. Kablosuz Ağ Farkındalığı cihazda mevcut olabilir ancak kullanıcı kablosuz bağlantıyı veya konumu devre dışı bıraktığı için şu anda kullanılamayabilir. Donanım ve donanım yazılımı özelliklerine bağlı olarak bazı cihazlar, kablosuz bağlantı doğrudan, SoftAP veya tethering kullanılıyorsa kablosuz bağlantıyı desteklemeyebilir. Wi-Fi Aware'ın şu anda kullanılıp kullanılamadığını kontrol etmek için
isAvailable()numaralı telefonu arayın.Kablosuz Ağ Farkındalığı'nın kullanılabilirliği herhangi bir zamanda değişebilir. Uygulamanız, kullanılabilirlik durumu değiştiğinde gönderilen
ACTION_WIFI_AWARE_STATE_CHANGEDalmak için birBroadcastReceiverkaydetmelidir. Uygulamanız yayın intent'ini aldığında mevcut tüm oturumları reddetmeli (Wi-Fi Aware hizmetinin kesintiye uğradığı varsayılır), ardından mevcut kullanılabilirlik durumunu kontrol edip davranışını buna göre ayarlamalıdır. Örnek:Kotlin
val wifiAwareManager = context.getSystemService(Context.WIFI_AWARE_SERVICE) as WifiAwareManager? val filter = IntentFilter(WifiAwareManager.ACTION_WIFI_AWARE_STATE_CHANGED) val myReceiver = object : BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { // discard current sessions if (wifiAwareManager?.isAvailable) { ... } else { ... } } } context.registerReceiver(myReceiver, filter)
Java
WifiAwareManager wifiAwareManager = (WifiAwareManager)context.getSystemService(Context.WIFI_AWARE_SERVICE) IntentFilter filter = new IntentFilter(WifiAwareManager.ACTION_WIFI_AWARE_STATE_CHANGED); BroadcastReceiver myReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { // discard current sessions if (wifiAwareManager.isAvailable()) { ... } else { ... } } }; context.registerReceiver(myReceiver, filter);
Daha fazla bilgi için Yayınlar başlıklı makaleyi inceleyin.
Oturum edinme
Wi-Fi Aware'ı kullanmaya başlamak için uygulamanızın attach() çağrısı yaparak bir WifiAwareSession alması gerekir. Bu yöntem aşağıdakileri yapar:
- Kablosuz Ağ Farkındalığı donanımını açar.
- Wi-Fi Aware kümesine katılır veya küme oluşturur.
- İçinde oluşturulan tüm keşif oturumları için kapsayıcı görevi gören benzersiz bir ad alanını içeren bir kablosuz ağ farkında oturumu oluşturur.
Uygulama başarıyla bağlanırsa sistem onAttached() geri çağırma işlevini yürütür.
Bu geri çağırma, uygulamanızın sonraki tüm oturum işlemleri için kullanması gereken bir WifiAwareSession nesnesi sağlar. Uygulamalar, hizmet yayınlamak veya hizmete abone olmak için oturumu kullanabilir.
Uygulamanız attach()'ü yalnızca bir kez çağırmalıdır. Uygulamanız attach() işlevini birden çok kez çağırırsa her çağrı için kendi ad alanını içeren farklı bir oturum alır. Bu, karmaşık senaryolarda yararlı olabilir ancak genellikle kullanılmamalıdır.
Hizmet yayınlama
Bir hizmeti bulunabilir hale getirmek için aşağıdaki parametreleri alan publish() yöntemini çağırın:
PublishConfig, hizmetin adını ve eşleme filtresi gibi diğer yapılandırma özelliklerini belirtir.DiscoverySessionCallback, abone bir ileti aldığında olduğu gibi etkinlikler gerçekleştiğinde uygulanacak işlemleri belirtir.
Aşağıda bununla ilgili bir örnek verilmiştir:
Kotlin
val config: PublishConfig = PublishConfig.Builder() .setServiceName(AWARE_FILE_SHARE_SERVICE_NAME) .build() awareSession.publish(config, object : DiscoverySessionCallback() { override fun onPublishStarted(session: PublishDiscoverySession) { ... } override fun onMessageReceived(peerHandle: PeerHandle, message: ByteArray) { ... } })
Java
PublishConfig config = new PublishConfig.Builder() .setServiceName(“Aware_File_Share_Service_Name”) .build(); awareSession.publish(config, new DiscoverySessionCallback() { @Override public void onPublishStarted(PublishDiscoverySession session) { ... } @Override public void onMessageReceived(PeerHandle peerHandle, byte[] message) { ... } }, null);
Yayınlama işlemi başarılı olursa onPublishStarted()
geri çağırma yöntemi çağrılır.
Yayınlamadan sonra, eşleşen abone uygulamalarını çalıştıran cihazlar yayın cihazının kablosuz aralığına girdiğinde aboneler hizmeti keşfeder. Bir abone yayıncıyı keşfettiğinde yayıncı bildirim almaz. Ancak abone yayıncıya mesaj gönderirse yayıncı bildirim alır. Bu durumda, onMessageReceived() geri çağırma yöntemi çağrılır. Aboneye mesaj göndermek veya aboneyle bağlantı oluşturmak için bu yöntemdeki PeerHandle bağımsız değişkenini kullanabilirsiniz.
Hizmetin yayınlanmasını durdurmak için DiscoverySession.close() numaralı telefonu arayın.
Keşif oturumları, üst öğeleriyle WifiAwareSession ilişkilendirilir. Üst oturum kapatılırsa ilişkili keşif oturumları da kapatılır. Atılan nesneler de kapatılır ancak sistem, kapsam dışındaki oturumların ne zaman kapatılacağını garanti etmez. Bu nedenle, close()yöntemlerini açıkça çağırmanızı öneririz.
Bir hizmete abone olma
Bir hizmete abone olmak için aşağıdaki parametreleri alan subscribe() yöntemini çağırın:
-
SubscribeConfig, abone olunacak hizmetin adını ve eşleme filtresi gibi diğer yapılandırma özelliklerini belirtir. DiscoverySessionCallback, etkinlikler gerçekleştiğinde (ör. bir yayıncı keşfedildiğinde) yürütülecek işlemleri belirtir.
Aşağıda bununla ilgili bir örnek verilmiştir:
Kotlin
val config: SubscribeConfig = SubscribeConfig.Builder() .setServiceName(AWARE_FILE_SHARE_SERVICE_NAME) .build() awareSession.subscribe(config, object : DiscoverySessionCallback() { override fun onSubscribeStarted(session: SubscribeDiscoverySession) { ... } override fun onServiceDiscovered( peerHandle: PeerHandle, serviceSpecificInfo: ByteArray, matchFilter: List<ByteArray> ) { ... } }, null)
Java
SubscribeConfig config = new SubscribeConfig.Builder() .setServiceName("Aware_File_Share_Service_Name") .build(); awareSession.subscribe(config, new DiscoverySessionCallback() { @Override public void onSubscribeStarted(SubscribeDiscoverySession session) { ... } @Override public void onServiceDiscovered(PeerHandle peerHandle, byte[] serviceSpecificInfo, List<byte[]> matchFilter) { ... } }, null);
Abone olma işlemi başarılı olursa sistem, uygulamanızdaki onSubscribeStarted() geri çağırma işlevini çağırır. Uygulamanız bir yayıncı keşfettikten sonra yayıncıyla iletişim kurmak için geri çağırma işlevindeki SubscribeDiscoverySession bağımsız değişkenini kullanabileceğiniz için bu referansı kaydetmeniz gerekir. Keşif oturumunda updateSubscribe() işlevini çağırarak abonelik oturumunu dilediğiniz zaman güncelleyebilirsiniz.
Bu noktada aboneliğiniz, eşleşen yayıncıların kablosuz ağ kapsamına girmesini bekler. Bu durumda sistem, onServiceDiscovered() geri çağırma yöntemini yürütür. Bu geri çağırmadaki PeerHandle bağımsız değişkenini kullanarak söz konusu yayıncıya mesaj gönderebilir veya bağlantı oluşturabilirsiniz.
Bir hizmete aboneliği durdurmak için DiscoverySession.close() numaralı telefonu arayın.
Keşif oturumları, üst öğeleriyle WifiAwareSession ilişkilendirilir. Üst oturum kapatılırsa ilişkili keşif oturumları da kapatılır. Atılan nesneler de kapatılır ancak sistem, kapsam dışındaki oturumların ne zaman kapatılacağını garanti etmez. Bu nedenle, close()yöntemlerini açıkça çağırmanızı öneririz.
Mesaj gönder
Başka bir cihaza mesaj göndermek için aşağıdaki nesnelere ihtiyacınız vardır:
Bir
DiscoverySession. Bu nesne,sendMessage()işlevini çağırmanıza olanak tanır. Uygulamanız, bir hizmet yayınlayarak veya bir hizmete abone olarakDiscoverySessionalır.İletiyi yönlendirmek için diğer cihazın
PeerHandle. Uygulamanız, başka bir cihazınPeerHandlebilgisini iki yoldan alır:- Uygulamanız bir hizmet yayınlar ve bir aboneden mesaj alır.
Uygulamanız,
onMessageReceived()geri çağırma işlevinden aboneninPeerHandledeğerini alır. - Uygulamanız bir hizmete abone olur. Ardından, eşleşen bir yayıncı bulduğunda uygulamanız
onServiceDiscovered()geri çağırma işlevinden yayıncınınPeerHandledeğerini alır.
- Uygulamanız bir hizmet yayınlar ve bir aboneden mesaj alır.
Uygulamanız,
Mesaj göndermek için sendMessage() numaralı telefonu arayın. Ardından aşağıdaki geri çağırmalar gerçekleşebilir:
- İleti eş tarafından başarıyla alındığında sistem, gönderen uygulamasında
onMessageSendSucceeded()geri çağırma işlevini çağırır. - Eş, mesaj aldığında sistem, alıcı uygulamasında
onMessageReceived()geri çağırma işlevini çağırır.
PeerHandle, eşlerle iletişim kurmak için gerekli olsa da eşlerin kalıcı tanımlayıcısı olarak bu değere güvenmemeniz gerekir. Uygulama, daha üst düzey tanımlayıcıları kullanabilir. Bu tanımlayıcılar, keşif hizmetinin kendisine veya sonraki mesajlara yerleştirilebilir. PublishConfig veya SubscribeConfig yöntemiyle setMatchFilter() veya setServiceSpecificInfo() yöntemini kullanarak keşif hizmetine bir tanımlayıcı yerleştirebilirsiniz. setMatchFilter() yöntemi keşfi etkilerken setServiceSpecificInfo() yöntemi keşfi etkilemez.
Bir iletiye tanımlayıcı yerleştirmek, ileti bayt dizisini bir tanımlayıcı içerecek şekilde (ör. ilk birkaç bayt olarak) değiştirmeyi ifade eder.
Bağlantı oluşturma
Wi-Fi Aware, iki Wi-Fi Aware cihaz arasında istemci-sunucu ağını destekler.
İstemci-sunucu bağlantısını ayarlamak için:
Hizmet yayınlamak (sunucu üzerinde) ve hizmete abone olmak (istemci üzerinde) için kablosuz bağlantıyı kullanarak keşif yapın.
Abone yayıncıyı keşfettikten sonra aboneden yayıncıya mesaj gönderin.
Yayıncı cihazında bir
ServerSocketbaşlatın ve bağlantı noktasını ayarlayın veya alın:Kotlin
val ss = ServerSocket(0) val port = ss.localPort
Java
ServerSocket ss = new ServerSocket(0); int port = ss.getLocalPort();
WifiAwareNetworkSpecifierkullanarak yayıncıda kablosuz ağ farkındalık ağı istemek içinConnectivityManager'u kullanın. Bu sırada, abone tarafından iletilen mesajdan elde ettiğiniz keşif oturumunu ve aboneninPeerHandledeğerini belirtin:Kotlin
val networkSpecifier = WifiAwareNetworkSpecifier.Builder(discoverySession, peerHandle) .setPskPassphrase("somePassword") .setPort(port) .build() val myNetworkRequest = NetworkRequest.Builder() .addTransportType(NetworkCapabilities.TRANSPORT_WIFI_AWARE) .setNetworkSpecifier(networkSpecifier) .build() val callback = object : ConnectivityManager.NetworkCallback() { override fun onAvailable(network: Network) { ... } override fun onCapabilitiesChanged(network: Network, networkCapabilities: NetworkCapabilities) { ... } override fun onLost(network: Network) { ... } } connMgr.requestNetwork(myNetworkRequest, callback);
Java
NetworkSpecifier networkSpecifier = new WifiAwareNetworkSpecifier.Builder(discoverySession, peerHandle) .setPskPassphrase("somePassword") .setPort(port) .build(); NetworkRequest myNetworkRequest = new NetworkRequest.Builder() .addTransportType(NetworkCapabilities.TRANSPORT_WIFI_AWARE) .setNetworkSpecifier(networkSpecifier) .build(); ConnectivityManager.NetworkCallback callback = new ConnectivityManager.NetworkCallback() { @Override public void onAvailable(Network network) { ... } @Override public void onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities) { ... } @Override public void onLost(Network network) { ... } }; ConnectivityManager connMgr.requestNetwork(myNetworkRequest, callback);
Yayıncı bir ağ istediğinde aboneye mesaj göndermelidir.
Abone, yayıncıdan mesaj aldıktan sonra yayıncıdakiyle aynı yöntemi kullanarak abonede kablosuz ağ farkındalığı ağı isteyin.
NetworkSpecifieroluştururken bağlantı noktası belirtmeyin. Ağ bağlantısı kullanılabilir, değiştiğinde veya kaybedildiğinde uygun geri çağırma yöntemleri çağrılır.Abonede
onAvailable()yöntemi çağrıldıktan sonra, yayıncıdakiServerSocketile iletişim kurmak içinSocketaçabileceğiniz birNetworknesnesi kullanılabilir. Ancak bunun içinServerSocket'ın IPv6 adresini ve bağlantı noktasını bilmeniz gerekir. AşağıdakilerionCapabilitiesChanged()geri çağırma işlevinde sağlananNetworkCapabilitiesnesnesinden alırsınız:Kotlin
val peerAwareInfo = networkCapabilities.transportInfo as WifiAwareNetworkInfo val peerIpv6 = peerAwareInfo.peerIpv6Addr val peerPort = peerAwareInfo.port ... val socket = network.getSocketFactory().createSocket(peerIpv6, peerPort)
Java
WifiAwareNetworkInfo peerAwareInfo = (WifiAwareNetworkInfo) networkCapabilities.getTransportInfo(); Inet6Address peerIpv6 = peerAwareInfo.getPeerIpv6Addr(); int peerPort = peerAwareInfo.getPort(); ... Socket socket = network.getSocketFactory().createSocket(peerIpv6, peerPort);
Ağ bağlantısını tamamladığınızda
unregisterNetworkCallback()düğmesine basın.
Eşler arası menzil ve konuma duyarlı keşif
Kablosuz RTT konum özelliklerine sahip bir cihaz, eşler arasındaki mesafeyi doğrudan ölçebilir ve bu bilgileri kablosuz bağlantı bilinir hizmet keşfini kısıtlamak için kullanabilir.
Wi-Fi RTT API, MAC adresini veya PeerHandle'ı kullanarak bir Wi-Fi Aware eşle doğrudan menzil belirlemenize olanak tanır.
Kablosuz Ağ Farkındalığı keşfi, yalnızca belirli bir coğrafi çit içindeki hizmetleri keşfedecek şekilde kısıtlanabilir. Örneğin, 3 metreden (3.000 mm olarak belirtilir) daha yakın ve 10 metreden (10.000 mm olarak belirtilir) daha uzak olmayan bir mesafede "Aware_File_Share_Service_Name" hizmeti yayınlayan bir cihazın keşfedilmesine olanak tanıyan bir coğrafi çit oluşturabilirsiniz.
Coğrafi sınırlamayı etkinleştirmek için hem yayıncının hem de abonenin işlem yapması gerekir:
Yayıncı, setRangingEnabled(true) kullanarak yayınlanan hizmette menzil belirlemeyi etkinleştirmelidir.
Yayıncı, menzil belirlemeyi etkinleştirmezse abone tarafından belirtilen tüm coğrafi çit kısıtlamaları yok sayılır ve mesafe dikkate alınmadan normal keşif gerçekleştirilir.
Abone, setMinDistanceMm ve setMaxDistanceMm'nin bir kombinasyonunu kullanarak bir coğrafi çit belirtmelidir.
Her iki değer için de belirtilmemiş mesafe, sınır olmadığını gösterir. Yalnızca maksimum mesafenin belirtilmesi, minimum mesafenin 0 olduğunu gösterir. Yalnızca minimum mesafenin belirtilmesi, maksimum mesafenin olmadığı anlamına gelir.
Bir eş hizmet, coğrafi çit içinde keşfedildiğinde, eşe olan ölçülen mesafeyi sağlayan onServiceDiscoveredWithinRange geri çağırma işlevi tetiklenir. Daha sonra, mesafeyi ölçmek için gerektiğinde doğrudan kablosuz RTT API'si çağrılabilir.