Bu sayfa, Cloud Translation API ile çevrilmiştir.

Wi-Fi Aware'e genel bakış

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ümler, başlatıcının MAC adresini sağlamak için L2 mesajlaşmasını kullanı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 PackageManager API 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 ağı 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_CHANGED almak için bir BroadcastReceiver kaydetmelidir. 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'i 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.

çağrısı yapın.

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() simgesini ç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 olarak DiscoverySession alır.
İletiyi yönlendirmek için diğer cihazın PeerHandle. Uygulamanız, başka bir cihazın PeerHandle bilgisini iki yoldan alır:
- Uygulamanız bir hizmet yayınlar ve bir aboneden mesaj alır. Uygulamanız, onMessageReceived() geri çağırma işlevinden abonenin PeerHandle değ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ın PeerHandle değerini alır.

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 ServerSocket baş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();

WifiAwareNetworkSpecifier kullanarak yayıncıda kablosuz ağ farkındalık ağı istemek için ConnectivityManager'u kullanın. Bu sırada, abone tarafından iletilen mesajdan elde ettiğiniz keşif oturumunu ve abonenin PeerHandle değ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. NetworkSpecifier oluş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ıdaki ServerSocket ile iletişim kurmak için Socket açabileceğiniz bir Network nesnesi kullanılabilir. Ancak bunun için ServerSocket'ın IPv6 adresini ve bağlantı noktasını bilmeniz gerekir. Aşağıdakileri onCapabilitiesChanged() geri çağırma işlevinde sağlanan NetworkCapabilities nesnesinden 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.

Not: Ağ isteği oluşturma ve gerekli ağ özelliklerini belirtme, Wi-Fi Aware API'ye özgü değildir. Ağ istekleriyle çalışma hakkında daha fazla bilgi için ConnectivityManager konusuna bakı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 ağ 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ında 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 bulunmasına 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.