Yakındaki RTT özellikli kablosuz erişim noktalarına ve eş Kablosuz Ağ Farkında cihazlarına olan mesafeyi ölçmek için Kablosuz Ağ RTT (Gidiş Dönüş Süresi) API'si tarafından sağlanan kablosuz konum işlevini kullanabilirsiniz.
Üç veya daha fazla erişim noktasına uzaklığı ölçüyorsanız bir ya da daha fazla Bunlara en uygun cihaz konumunu tahmin etmek için kullanılan çoklu katmanlama algoritması ölçümler. Sonuç genellikle 1-2 metre içinde doğrudur.
Bu doğruluk sayesinde kapalı mekan navigasyonu, anlam karışıklığını gideren sesli kontrol (ör. "Bu ışığı aç") ve konuma dayalı bilgiler (ör. "Bu ürün için özel teklif var mı?") gibi ayrıntılı konuma dayalı hizmetler geliştirebilirsiniz.
İstekte bulunan cihazın, ölçüm için erişim noktalarına bağlanması gerekmez. mesafe katetmeniz önerilir. Gizliliği korumak için, yalnızca istekte bulunan cihaz erişim noktasına uzaklığı belirlemek için; erişim noktalarında bu bilgilerden faydalanabilirsiniz. Kablosuz RTT işlemleri, ön plan uygulamaları için sınırsızdır ancak arka plan uygulamaları için sınırlandırılır.
Kablosuz RTT ve ilgili Fine-Time-Measurement (FTM) özellikleri, IEEE 802.11-2016 standardı tarafından belirtilir. Kablosuz RTT için tam saat gerekir iki nokta arasındaki mesafeyi hesapladığı için, FTM tarafından sağlanan ölçüm bir paketin iki paketin arasında gidiş dönüş süresini ölçerek bu süreyi ışık hızıyla çarpıyoruz.
Android 15 (API düzeyi 35), IEEE 802.11az tetikleyici tabanlı olmayan (NTB) menzil desteğini kullanıma sundu.
Android sürümüne göre uygulama farklılıkları
Kablosuz RTT, Android 9'da (API düzeyi 28) kullanıma sunulmuştur. Android 9 çalıştıran cihazlarla çoklu yansıma kullanarak bir cihazın konumunu belirlemek için bu protokolü kullanırken uygulamanızda önceden belirlenmiş erişim noktası (AP) konumu verilerine erişiminiz olmalıdır. Bu verileri nasıl depolayacağınıza ve alacağınıza siz karar verirsiniz.
Android 10 (API düzeyi 29) ve sonraki sürümleri çalıştıran cihazlarda AP konum verileri aşağıdaki gibi olabilir:
şu şekilde temsil edilir:
ResponderLocation
enlem, boylam ve rakım gibi nesneleri belirler. Şu özelliklere sahip kablosuz RTT AP'ler için:
Konum Yapılandırma Bilgileri/Konum Şehir Raporu'nu (LCI/LCR verileri) destekler,
Protokol,ResponderLocation
aralık süreci.
Bu özellik, uygulamaların API'leri sorgulamasına ve doğrudan konumlarını sormasına olanak tanır. ve bu bilgileri önceden saklamaya gerek kalmaz. Böylece uygulamanız daha önce bilinmese bile AP'leri bulup konumlarını belirleme, Mesela kullanıcı yeni bir binaya girdiğinde.
IEEE 802.11az NTB menzil desteği, Android 15 (API düzeyi 35) ve sonraki sürümleri çalıştıran cihazlarda kullanılabilir. Bu, cihaz IEEE 802.11az'ı destekliyorsa
NTB yanıtlayıcı modu (
WifiRttManager.CHARACTERISTICS_KEY_BOOLEAN_STA_RESPONDER
),
uygulamanız hem IEEE 802.11mc hem de IEEE 802.11az özellikli AP'leri tek bir
aralık isteği. RangingResult
API, bilgi sağlayacak şekilde genişletilmiştir
aralığı için kullanılabilecek minimum ve maksimum değer hakkında
kullanarak, kesin aralığı uygulamanızın kontrolünde tutabilirsiniz.
Şartlar
- Aralık isteğini gönderen cihazın donanımı, 802.11-2016 FTM standardı veya 802.11az standardı (tetikleyici olmayan aralık).
- Aralık isteğinde bulunan cihazın Android 9 (API düzeyi) çalıştırması gerekir 28) veya sonraki sürümlerdir. IEEE 802.11az tetikleyici olmayan aralık cihazlar üzerinde etkinleştirildi Android 15 (API düzeyi 35) ve sonraki sürümleri çalıştıran.
- Aralık isteğinde bulunan cihazda konum hizmetleri etkinleştirilmiş olmalıdır ve kablosuz ağ taraması açık (Ayarlar > Konum altında).
- Aralık isteğinde bulunan uygulama,
Android 13 (API düzeyi 33) veya sonraki bir sürüm yüklüyse
NEARBY_WIFI_DEVICES
izni gerekir. Bu tür bir uygulama Android'in önceki bir sürümünü hedefliyorsa sahip olmakACCESS_FINE_LOCATION
izni almanız gerekir. - Uygulama, görünür durumdayken veya açık durumdayken erişim noktaları aralığını sorgulamalıdır. bir ön plan hizmetidir. Uygulama, buradan konum bilgilerine erişemez arka plan.
- Erişim noktası, IEEE 802.11-2016 FTM standardını veya IEEE 802.11az standardını (tetikleyici tabanlı olmayan menzil belirleme) uygulamalıdır.
Kurulum
Uygulamanızı kablosuz RTT'yi kullanacak şekilde ayarlamak için aşağıdaki adımları uygulayın.
1. İzin isteme
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" />
<!-- 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" />
NEARBY_WIFI_DEVICES
ve ACCESS_FINE_LOCATION
izinleri tehlikeli
Bu nedenle, kullanıcı bir işlem yapmak istediğinde bu izinleri çalışma zamanında istemeniz gerekir.
RTT tarama işlemi gerçekleştirin. Uygulamanızın, kullanıcıdan
(izin verilmemişse) izin verir. Okuyucu Gelirleri Yöneticisi'ni
bkz. çalışma zamanı izinleri hakkında
Uygulama İzinleri İsteyin.
2. Cihazın kablosuz RTT'yi destekleyip desteklemediğini kontrol edin
Cihazın kablosuz RTT'yi destekleyip desteklemediğini kontrol etmek için
PackageManager
API:
Kotlin
context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_RTT)
Java
context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_RTT);
3. Kablosuz RTT'nin kullanılıp kullanılamadığını kontrol etme
Cihazda Kablosuz RTT olabilir, ancak kullanıcı tarafından
kablosuz bağlantıyı devre dışı bıraktı. Donanım ve donanım yazılımı becerilerine bağlı olarak, bazı
SoftAP veya tethering kullanılıyorsa cihazlar kablosuz RTT'yi desteklemeyebilir. Kontrol etmek için
Kablosuz RTT kullanılabilir mi, şunu ara:
isAvailable()
.
Kablosuz RTT'nin kullanılabilirliği herhangi bir zamanda değişebilir. Uygulamanız
BroadcastReceiver
almak için
ACTION_WIFI_RTT_STATE_CHANGED
,
Bu mesaj, müsaitlik durumu değiştiğinde gönderilir. Uygulamanız yayın intent'ini aldığında mevcut müsaitlik durumunu kontrol etmeli ve davranışını buna göre ayarlamalıdır.
Örnek:
Kotlin
val filter = IntentFilter(WifiRttManager.ACTION_WIFI_RTT_STATE_CHANGED) val myReceiver = object: BroadcastReceiver() { override fun onReceive(context: Context, intent: Intent) { if (wifiRttManager.isAvailable) { … } else { … } } } context.registerReceiver(myReceiver, filter)
Java
IntentFilter filter = new IntentFilter(WifiRttManager.ACTION_WIFI_RTT_STATE_CHANGED); BroadcastReceiver myReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { if (wifiRttManager.isAvailable()) { … } else { … } } }; context.registerReceiver(myReceiver, filter);
Daha fazla bilgi için Yayınlar konusuna bakın.
Aralık isteği oluştur
Bir kapsam aralığı istenen AP'lerin veya Wi-Fi Aware eşlerinin listesi belirtilerek bir kapsam aralığı isteği (RangingRequest
) oluşturulur. Tek bir menzil belirleme isteğinde birden fazla erişim noktası veya Wi-Fi Aware eşlenebilir. Tüm cihazlara olan mesafeler ölçülür ve döndürülür.
Örneğin, bir istekte
addAccessPoint()
yöntemini kullanın:
Kotlin
val req: RangingRequest = RangingRequest.Builder().run { addAccessPoint(ap1ScanResult) addAccessPoint(ap2ScanResult) build() }
Java
RangingRequest.Builder builder = new RangingRequest.Builder(); builder.addAccessPoint(ap1ScanResult); builder.addAccessPoint(ap2ScanResult); RangingRequest req = builder.build();
Bir erişim noktası,
ScanResult
nesnesi; bu değer:
telefon ederek elde edilir
WifiManager.getScanResults()
.
Tekliflerinizi otomatikleştirmek ve optimize etmek için
addAccessPoints(List<ScanResult>)
giriş noktası ekleyin.
ScanResult
nesneleri hem IEEE 802.11mc (is80211mcResponder()
) hem de
IEEE 802.11az tetikleyici olmayan aralık (is80211azNtbResponder()
) desteklenir
Erişim noktaları. IEEE 802.11az NTB menzil ölçümünü destekleyen cihazlar, AP'nin kapasitesine bağlı olarak 802.11mc veya 802.11az menzil ölçümü gerçekleştirir. AP her ikisini de destekliyorsa varsayılan olarak 802.11az kullanılır. IEEE 802.11az'ı desteklemeyen cihazlar tüm işlevleri yerine getirir
IEEE 802.11mc protokolü kullanılarak değişiklik gösterir.
Benzer şekilde, bir menzil isteği, sırasıyla addWifiAwarePeer(MacAddress peer)
ve addWifiAwarePeer(PeerHandle peer)
yöntemlerini kullanarak MAC adresini veya PeerHandle
değerini kullanarak bir Wi-Fi Aware eşdeğeri ekleyebilir. Wi-Fi Aware eşlerini keşfetme hakkında daha fazla bilgi için Wi-Fi Aware belgelerini inceleyin.
İstek aralığı
Uygulama, WifiRttManager.startRanging()
yöntemini kullanarak bir menzil isteğinde bulunur ve aşağıdakileri sağlar: işlemi belirtmek için bir RangingRequest
, geri çağırma bağlamını belirtmek için bir Executor
ve sonuçları almak için bir RangingResultCallback
.
Örnek:
Kotlin
val mgr = context.getSystemService(Context.WIFI_RTT_RANGING_SERVICE) as WifiRttManager val request: RangingRequest = myRequest mgr.startRanging(request, executor, object : RangingResultCallback() { override fun onRangingResults(results: List<RangingResult>) { … } override fun onRangingFailure(code: Int) { … } })
Java
WifiRttManager mgr = (WifiRttManager) Context.getSystemService(Context.WIFI_RTT_RANGING_SERVICE); RangingRequest request ...; mgr.startRanging(request, executor, new RangingResultCallback() { @Override public void onRangingFailure(int code) { … } @Override public void onRangingResults(List<RangingResult> results) { … } });
Aralık işlemi eşzamansız olarak gerçekleştirilir ve aralık sonuçları
geri çağırmalarından birinde
RangingResultCallback
:
- Aralık belirleme işleminin tamamı başarısız olursa
onRangingFailure
geri çağırma işlevi,RangingResultCallback
bölümünde açıklanan bir durum koduyla tetiklenir. Bu tür bir hata, hizmet o anda bir menzil belirleme işlemi yürütemiyorsa (ör. kablosuz ağ devre dışı olduğu için, uygulama çok fazla menzil belirleme işlemi istediği ve sınırlandığı için veya izin sorunu nedeniyle) ortaya çıkabilir. - Sıralama işlemi tamamlandığında,
onRangingResults
geri çağırma, şu listeyle eşleşen bir sonuç listesiyle tetiklenir: istekleri: Her istek için bir sonuç. Sonuçların sırası isteklerin sırasına göre eşleşmesi gerekir. Aralık belirleme işleminin tamamlanmış olabileceğini ancak her sonucun söz konusu ölçümün başarısız olduğunu gösterebileceğini unutmayın.
Aralık belirleme sonuçlarını yorumlama
Sorgunun döndürdüğü
onRangingResults
geri çağırma bir RangingResult
ile belirtilir
nesnesini tanımlayın. Her istek için aşağıdakileri yapın.
1. Talebi tanımlama
İsteği oluştururken verilen bilgilere dayanarak
RangingRequest
:
ScanResult
içinde sağlanan, erişimi tanımlayan bir MAC adresi
puan. MAC adresi, getMacAddress()
yöntemi kullanılarak menzil belirleme sonucundan elde edilebilir.
Aralık sonuçlarının listesi, benzerlerden farklı sırada olabilir (erişim noktaları) kullandığınızdan emin olmak için MAC adresini kullanmanız gerekir. sonuç sırasını değil, iş ortağını tanımlamalıdır.
2. Her ölçümün başarılı olup olmadığını belirleme
Bir ölçümün başarılı olup olmadığını belirlemek için
getStatus()
yöntemidir. STATUS_SUCCESS
dışındaki tüm değerler hatayı gösterir. Başarısızlık, bu sonucun diğer tüm alanlarının (yukarıdaki istek kimliği hariç) geçersiz olduğu ve ilgili get*
yönteminin IllegalStateException
istisnasıyla başarısız olduğu anlamına gelir.
3. Her başarılı ölçümün sonuçlarını alma
Her başarılı ölçüm (RangingResult
) için sonuç alabilirsiniz
ilgili get
yöntemleriyle değiştirin:
Mesafe (mm cinsinden) ve ölçümün standart sapması:
Ölçümler için kullanılan paketlerin RSSI'si:
Ölçümün yapıldığı milisaniye cinsinden süre (süreyi gösterir) açılıştan itibaren):
Yapılmaya çalışılan ölçüm sayısı ve yapılan ölçüm sayısı başarılı olan (ve mesafe ölçümlerinin dayandığı):
İstemci cihazın 11az NTB arasında beklemesi gereken minimum ve maksimum süre ölçümler:
getMinTimeBetweenNtbMeasurementsMicros()
vegetMaxTimeBetweenNtbMeasurementsMicros()
minimum ve maksimum süreyi döndürür. Bir sonraki aralık ölçümü istenen minimum süre geçtikten sonra API, önbelleğe alınmış aralık sonucu. Sonraki aralık ölçümü şundan sonra istenirse: ulaşılırsa API, tetikleyici olmayan reklam öğesini sonlandırır. oturumu belirler ve yanıt veren tarafla yeni bir aralık oturumu müzakere eder. istasyon. Yeni bir menzil belirleme oturumu istemekten kaçının. Bu işlem, menzil belirleme ölçüm süresine ek yük ekler. 802.11az tetikleyici tabanlı olmayan menzil belirleme verimliliğinden tam olarak yararlanmak için bir sonraki menzil belirleme isteğini, öncekiRangingResult
ölçümünde belirtilen minimum ve maksimum ölçüm süresi arasında tetikleyin.Yanıt veren ve başlatan istasyonlar için Uzun Eğitim Alanı (LTF) tekrarları IEEE 802.11az NTB sonucunun giriş bölümünde kullanıldı:
Başlatıcının gönderdiği ve alan mekansal zaman akışlarının (STS) sayısı IEEE 802.11az NTB sonucu için kullanılan istasyon:
Kablosuz RTT'yi destekleyen Android cihazlar
Aşağıdaki tablolarda bazı telefonlar, erişim noktaları ve perakende, depo ve dağıtım merkezi cihazları listelenmektedir. kablosuz RTT'yi destekler. Bu örnekler kapsamlı değildir. RTT özellikli ürünlerinizi burada listelemek için bize ulaşabilirsiniz.
Erişim Noktaları
Üretici ve Model | Destek Tarihi |
---|---|
Nest Wifi Pro (Wi-Fi 6E) | Destekleniyor |
Compulab WILD AP | Destekleniyor |
Google Wi-Fi | Destekleniyor |
Google Nest Wifi Yönlendirici | Destekleniyor |
Google Nest Wi-Fi Bağlantı Noktası | Destekleniyor |
Aruba AP-635 | Destekleniyor |
Cisco 9130 | Destekleniyor |
Cisco 9136 | Destekleniyor |
Cisco 9166 | Destekleniyor |
Cisco 9164 | Destekleniyor |
Aruba AP-505 | Destekleniyor |
Aruba AP-515 | Destekleniyor |
Aruba AP-575 | Destekleniyor |
Aruba AP-518 | Destekleniyor |
Aruba AP-505H | Destekleniyor |
Aruba AP-565 | Destekleniyor |
Aruba AP-535 | Destekleniyor |
Telefonlar
Üretici ve Model | Android Sürümü |
---|---|
Pixel 6 | 9.0+ |
Pixel 6 Pro | 9.0+ |
Pixel 5 | 9.0+ |
Pixel 5a | 9.0+ |
Pixel 5a (5G) | 9.0+ |
Xiaomi Mi 10 Pro | 9.0+ |
Xiaomi Mi 10 | 9.0+ |
Xiaomi Redmi Mi 9T Pro | 9.0+ |
Xiaomi Mi 9T | 9.0+ |
Xiaomi Mi 9 | 9.0+ |
Xiaomi Mi Not 10 | 9.0+ |
Xiaomi Mi Not 10 Lite | 9.0+ |
Xiaomi Redmi Note 9S | 9.0+ |
Xiaomi Redmi Note 9 Pro | 9.0+ |
Xiaomi Redmi Note 8T | 9.0+ |
Xiaomi Redmi Note 8 | 9.0+ |
Xiaomi Redmi K30 Pro | 9.0+ |
Xiaomi Redmi K20 Pro | 9.0+ |
Xiaomi Redmi K20 | 9.0+ |
Xiaomi Redmi Note 5 Pro | 9.0+ |
Xiaomi Mi CC9 Pro | 9.0+ |
LG G8X ThinQ | 9.0+ |
LG V50S İnce | 9.0+ |
LG V60 ThinQ | 9.0+ |
LG V30 | 9.0+ |
Samsung Galaxy Note 10+ (5G) | 9.0+ |
Samsung Galaxy S20+ 5G | 9.0+ |
Samsung Galaxy S20 ve sonraki modeller | 9.0+ |
Samsung Galaxy S20 (5G) | 9.0+ |
Samsung Galaxy S20 Ultra 5G | 9.0+ |
Samsung Galaxy S20 | 9.0+ |
Samsung Galaxy Note 10 ve sonraki modeller | 9.0+ |
Samsung Galaxy Note 10 5G | 9.0+ |
Samsung Galaxy Note 10 | 9.0+ |
Samsung A9 Pro | 9.0+ |
Google Pixel 4 XL | 9.0+ |
Google Pixel 4 | 9.0+ |
Google Pixel 4a | 9.0+ |
Google Pixel 3 XL | 9.0+ |
Google Pixel 3 | 9.0+ |
Google Pixel 3a XL | 9.0+ |
Google Pixel 3a | 9.0+ |
Google Pixel 2 XL | 9.0+ |
Google Pixel 2 | 9.0+ |
Google Pixel 1 XL | 9.0+ |
Google Pixel 1 | 9.0+ |
Poco X2 | 9.0+ |
Keskin Aquos R3 SH-04L | 9.0+ |
Perakende, Depolama ve Dağıtım Merkezi Cihazları
Üretici ve Model | Android Sürümü |
---|---|
Zebra PS20 | 10.0 ve üzeri |
Zebra TC52/TC52HC | 10.0 ve üzeri |
Zebra TC57 | 10.0 ve üzeri |
Zebra TC72 | 10.0 ve üzeri |
Zebra TC77 | 10.0 ve üzeri |
Zebra MC93 | 10.0 ve üzeri |
Zebra TC8300 | 10.0 ve üzeri |
Zebra VC8300 | 10.0 ve üzeri |
Zebra EC30 | 10.0 ve üzeri |
Zebra ET51 | 10.0 ve üzeri |
Zebra ET56 | 10.0 ve üzeri |
Zebra L10 | 10.0 ve üzeri |
Zebra CC600/CC6000 | 10.0 ve üzeri |
Zebra MC3300x | 10.0 ve üzeri |
Zebra MC330x | 10.0 ve üzeri |
Zebra TC52x | 10.0 ve üzeri |
Zebra TC57x | 10.0 ve üzeri |
Zebra EC50 (LAN ve HC) | 10.0 ve üzeri |
Zebra EC55 (WAN) | 10.0 ve üzeri |
Zebra WT6300 | 10.0 ve üzeri |
Skorpio X5 | 10.0 ve üzeri |