ความสามารถของ Wi-Fi Aware ช่วยให้อุปกรณ์ที่ใช้ Android 8.0 (ระดับ API 26) ขึ้นไปค้นพบและเชื่อมต่อกับอุปกรณ์อื่นๆ ได้โดยตรงโดยไม่ต้องมีการเชื่อมต่อประเภทอื่น Wi-Fi Aware หรือที่เรียกว่า Neighbor Awareness Network (NAN)
เครือข่าย Wi-Fi Aware ทํางานโดยการสร้างคลัสเตอร์กับอุปกรณ์ใกล้เคียง หรือสร้างคลัสเตอร์ใหม่หากอุปกรณ์เป็นอุปกรณ์เครื่องแรกในพื้นที่ ลักษณะการรวมกลุ่มนี้จะมีผลกับทั้งอุปกรณ์และได้รับการจัดการโดยบริการระบบ Wi-Fi Aware แอปไม่มีสิทธิ์ควบคุมลักษณะการรวมกลุ่ม แอปใช้ Wi-Fi Aware API เพื่อสื่อสารกับบริการระบบ Wi-Fi Aware ซึ่งจัดการฮาร์ดแวร์ Wi-Fi Aware ในอุปกรณ์
Wi-Fi Aware API ช่วยให้แอปดำเนินการต่อไปนี้ได้
ค้นหาอุปกรณ์อื่นๆ: API มีกลไกในการค้นหาอุปกรณ์อื่นๆ ที่อยู่ใกล้เคียง กระบวนการจะเริ่มขึ้นเมื่ออุปกรณ์ 1 เครื่องเผยแพร่บริการที่ค้นพบได้อย่างน้อย 1 รายการ จากนั้นเมื่ออุปกรณ์สมัครใช้บริการอย่างน้อย 1 อย่างและเข้าสู่ระยะสัญญาณ Wi-Fi ของผู้เผยแพร่ ผู้สมัครใช้บริการจะได้รับการแจ้งเตือนว่าพบผู้เผยแพร่ที่ตรงกัน หลังจากค้นพบผู้เผยแพร่แล้ว ผู้สมัครใช้บริการสามารถส่งข้อความสั้นๆ หรือสร้างการเชื่อมต่อเครือข่ายกับอุปกรณ์ที่ค้นพบ อุปกรณ์สามารถเป็นผู้เผยแพร่และผู้ติดตามได้พร้อมกัน
สร้างการเชื่อมต่อเครือข่าย: หลังจากอุปกรณ์ 2 เครื่องค้นพบกันและกันแล้ว อุปกรณ์จะสร้างการเชื่อมต่อเครือข่าย Wi-Fi Aware แบบ 2 ทิศทางได้โดยไม่ต้องมีจุดเข้าใช้งาน
การเชื่อมต่อเครือข่าย Wi-Fi Aware รองรับอัตราการส่งข้อมูลที่สูงกว่าในระยะทางที่ไกลกว่าการเชื่อมต่อบลูทูธ การเชื่อมต่อประเภทนี้มีประโยชน์สําหรับแอปที่แชร์ข้อมูลจํานวนมากระหว่างผู้ใช้ เช่น แอปการแชร์รูปภาพ
การเพิ่มประสิทธิภาพสำหรับ Android 13 (API ระดับ 33)
ในอุปกรณ์ที่ใช้ Android 13 (API ระดับ 33) ขึ้นไปที่รองรับโหมดการสื่อสารทันที แอปสามารถใช้เมธอด PublishConfig.Builder.setInstantCommunicationModeEnabled() และ SubscribeConfig.Builder.setInstantCommunicationModeEnabled() เพื่อเปิดหรือปิดใช้โหมดการสื่อสารทันทีสำหรับเซสชันการค้นพบของผู้เผยแพร่โฆษณาหรือสมาชิก โหมดการสื่อสารแบบทันทีจะเร่งการแลกเปลี่ยนข้อความ การค้นพบบริการ และเส้นทางข้อมูลที่ตั้งค่าไว้เป็นส่วนหนึ่งของเซสชันการค้นพบของผู้เผยแพร่โฆษณาหรือผู้สมัครใช้บริการ หากต้องการระบุว่าอุปกรณ์รองรับโหมดการสื่อสารแบบทันทีหรือไม่ ให้ใช้เมธอด isInstantCommunicationModeSupported()
การเพิ่มประสิทธิภาพสำหรับ Android 12 (API ระดับ 31)
Android 12 (API ระดับ 31) เพิ่มการปรับปรุงบางอย่างใน Wi-Fi Aware ดังนี้
- ในอุปกรณ์ที่ใช้ Android 12 (API ระดับ 31) ขึ้นไป คุณสามารถใช้การเรียกกลับ
onServiceLost()เพื่อรับการแจ้งเตือนเมื่อแอปสูญเสียบริการที่ค้นพบเนื่องจากบริการหยุดทำงานหรือย้ายออกนอกระยะสัญญาณ - การตั้งค่าเส้นทางข้อมูล Wi-Fi Aware ง่ายขึ้น เวอร์ชันก่อนหน้านี้ใช้การรับส่งข้อความ L2 เพื่อระบุที่อยู่ MAC ของผู้เริ่ม ซึ่งทำให้เกิดเวลาในการตอบสนอง ในอุปกรณ์ที่ใช้ Android 12 ขึ้นไป คุณสามารถกำหนดค่าอุปกรณ์ที่ตอบกลับ (เซิร์ฟเวอร์) ให้ยอมรับคู่สนทนาใดก็ได้ ซึ่งหมายความว่าอุปกรณ์ไม่จำเป็นต้องทราบที่อยู่ MAC ของผู้เริ่มก่อน ซึ่งจะเร่งความเร็วในการเปิดใช้งานเส้นทางข้อมูลและเปิดใช้ลิงก์แบบจุดต่อจุดหลายรายการด้วยคำขอเครือข่ายเพียงรายการเดียว
- แอปที่ทำงานใน Android 12 ขึ้นไปสามารถใช้วิธี
WifiAwareManager.getAvailableAwareResources()เพื่อรับจำนวนเส้นทางข้อมูลที่พร้อมใช้งานในปัจจุบัน เผยแพร่เซสชัน และติดตามเซสชัน ซึ่งจะช่วยให้แอปทราบว่ามีทรัพยากรเพียงพอที่จะดำเนินการตามฟังก์ชันการทำงานที่ต้องการหรือไม่
การตั้งค่าเบื้องต้น
หากต้องการตั้งค่าแอปให้ใช้การค้นพบและเครือข่าย Wi-Fi Aware ให้ทำตามขั้นตอนต่อไปนี้
ขอสิทธิ์ต่อไปนี้ในไฟล์ Manifest ของแอป
<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" />
ตรวจสอบว่าอุปกรณ์รองรับ Wi-Fi Aware หรือไม่ด้วย
PackageManagerAPI ดังที่แสดงด้านล่างKotlin
context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE)
Java
context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_AWARE);
ตรวจสอบว่า Wi-Fi Aware พร้อมใช้งานในขณะนี้หรือไม่ Wi-Fi Aware อาจอยู่ในอุปกรณ์ แต่อาจไม่พร้อมใช้งานในขณะนี้เนื่องจากผู้ใช้ปิดใช้ Wi-Fi หรือตำแหน่งไว้ อุปกรณ์บางรุ่นอาจไม่รองรับ Wi-Fi Aware หากมีการใช้ Wi-Fi Direct, SoftAP หรือการแชร์อินเทอร์เน็ตผ่านมือถือ ทั้งนี้ขึ้นอยู่กับความสามารถของฮาร์ดแวร์และเฟิร์มแวร์ หากต้องการตรวจสอบว่า Wi-Fi Aware พร้อมใช้งานหรือไม่ ให้โทรไปที่
isAvailable()ความพร้อมใช้งานของ Wi-Fi Aware อาจเปลี่ยนแปลงได้ทุกเมื่อ แอปของคุณควรลงทะเบียน
BroadcastReceiverเพื่อรับACTION_WIFI_AWARE_STATE_CHANGEDซึ่งระบบจะส่งทุกครั้งที่มีการเปลี่ยนแปลงความพร้อมจำหน่ายสินค้า เมื่อแอปของคุณได้รับ Intent การออกอากาศ แอปควรทิ้งเซสชันที่มีอยู่ทั้งหมด (สมมติว่าบริการ Wi-Fi Aware หยุดชะงัก) จากนั้นตรวจสอบสถานะความพร้อมใช้งานปัจจุบันและปรับลักษณะการทํางานให้เหมาะสม เช่น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);
ดูข้อมูลเพิ่มเติมได้ที่การออกอากาศ
รับเซสชัน
หากต้องการเริ่มใช้ Wi-Fi Aware แอปของคุณจะต้องได้รับ WifiAwareSession โดยเรียกใช้ attach() วิธีการนี้จะทำสิ่งต่อไปนี้
- เปิดฮาร์ดแวร์ Wi-Fi Aware
- เข้าร่วมหรือสร้างคลัสเตอร์ Wi-Fi Aware
- สร้างเซสชัน Wi-Fi Aware ที่มีเนมสเปซที่ไม่ซ้ำกันซึ่งทำหน้าที่เป็นคอนเทนเนอร์สำหรับเซสชันการค้นพบทั้งหมดที่สร้างภายใน
หากแอปแนบไฟล์สำเร็จ ระบบจะเรียกใช้ callback ของ onAttached()
การเรียกกลับนี้จะระบุออบเจ็กต์ WifiAwareSession ที่แอปควรใช้สำหรับการดำเนินการกับเซสชันทั้งหมดในอนาคต แอปสามารถใช้เซสชันเพื่อเผยแพร่บริการหรือสมัครใช้บริการ
แอปควรเรียกใช้ attach() เพียงครั้งเดียว หากแอปเรียก attach() หลายครั้ง แอปจะได้รับเซสชันที่แตกต่างกันสําหรับการเรียกแต่ละครั้ง โดยแต่ละเซสชันจะมีเนมสเปซเป็นของตัวเอง ซึ่งอาจมีประโยชน์ในสถานการณ์ที่ซับซ้อน แต่โดยทั่วไปแล้วควรหลีกเลี่ยง
เผยแพร่บริการ
หากต้องการให้ระบบค้นพบบริการ ให้เรียกใช้เมธอด publish() ซึ่งจะใช้พารามิเตอร์ต่อไปนี้
PublishConfigระบุชื่อบริการและพร็อพเพอร์ตี้การกําหนดค่าอื่นๆ เช่น ตัวกรองการจับคู่DiscoverySessionCallbackระบุการดำเนินการที่จะดำเนินการเมื่อเกิดเหตุการณ์ เช่น เมื่อผู้ติดตามได้รับข้อความ
ตัวอย่างเช่น
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);
หากเผยแพร่สําเร็จ ระบบจะเรียกใช้วิธี Callback ของ
onPublishStarted()
หลังจากเผยแพร่แล้ว เมื่ออุปกรณ์ที่ใช้แอปสมาชิกที่ตรงกันเข้ามาอยู่ในระยะสัญญาณ Wi-Fi ของอุปกรณ์ที่เผยแพร่ สมาชิกก็จะค้นพบบริการดังกล่าว เมื่อผู้ติดตามค้นพบผู้เผยแพร่โฆษณา ผู้เผยแพร่โฆษณาจะไม่ได้รับแจ้ง แต่ถ้าผู้ติดตามส่งข้อความถึงผู้เผยแพร่โฆษณา ผู้เผยแพร่โฆษณาก็จะได้รับแจ้ง เมื่อเกิดเหตุการณ์ดังกล่าว ระบบจะเรียกใช้เมธอด Callback ของ onMessageReceived() คุณสามารถใช้อาร์กิวเมนต์ PeerHandle จากเมธอดนี้เพื่อส่งข้อความกลับไปยังผู้ติดตาม หรือสร้างการเชื่อมต่อกับผู้ใช้รายดังกล่าว
หากต้องการหยุดเผยแพร่บริการ ให้โทรไปที่
DiscoverySession.close()
เซสชันการค้นพบจะเชื่อมโยงกับWifiAwareSessionหลัก หากเซสชันหลักปิดอยู่ เซสชันการค้นพบที่เกี่ยวข้องก็จะปิดด้วย แม้ว่าระบบจะปิดออบเจ็กต์ที่ทิ้งไปแล้วด้วย แต่ระบบไม่สามารถรับประกันได้ว่าเซสชันที่อยู่นอกขอบเขตจะปิดเมื่อใด เราจึงขอแนะนำให้คุณเรียกใช้เมธอด close()อย่างชัดเจน
สมัครใช้บริการ
หากต้องการสมัครใช้บริการ ให้เรียกใช้เมธอด subscribe() ซึ่งใช้พารามิเตอร์ต่อไปนี้
-
SubscribeConfigระบุชื่อบริการที่จะสมัครใช้บริการและพร็อพเพอร์ตี้การกําหนดค่าอื่นๆ เช่น ตัวกรองการจับคู่ DiscoverySessionCallbackระบุการดำเนินการที่จะดำเนินการเมื่อเกิดเหตุการณ์ เช่น เมื่อพบผู้เผยแพร่โฆษณา
ตัวอย่างเช่น
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);
หากการสมัครใช้บริการสําเร็จ ระบบจะเรียกใช้การเรียกคืน onSubscribeStarted() ในแอปของคุณ เนื่องจากคุณใช้อาร์กิวเมนต์ SubscribeDiscoverySession ในการเรียกคืนเพื่อสื่อสารกับผู้เผยแพร่โฆษณาได้หลังจากที่แอปค้นพบผู้เผยแพร่โฆษณาแล้ว คุณจึงควรบันทึกการอ้างอิงนี้ คุณสามารถอัปเดตเซสชันการสมัครใช้บริการได้ทุกเมื่อโดยเรียกใช้ updateSubscribe() ในเซสชันการค้นพบ
เมื่อถึงจุดนี้ การสมัครใช้บริการจะรอให้ผู้เผยแพร่โฆษณาที่ตรงกันเข้ามาอยู่ในระยะสัญญาณ Wi-Fi ในกรณีนี้ ระบบจะเรียกใช้เมธอด callback ของ onServiceDiscovered() คุณสามารถใช้อาร์กิวเมนต์ PeerHandleจากคอลแบ็กนี้เพื่อส่งข้อความหรือสร้างการเชื่อมต่อกับผู้เผยแพร่โฆษณารายนั้น
หากต้องการหยุดสมัครใช้บริการ ให้โทรไปที่ DiscoverySession.close()
เซสชันการค้นพบจะเชื่อมโยงกับWifiAwareSessionหลัก หากเซสชันหลักปิดอยู่ เซสชันการค้นพบที่เกี่ยวข้องก็จะปิดด้วย แม้ว่าระบบจะปิดออบเจ็กต์ที่ทิ้งไปแล้วด้วย แต่ระบบไม่สามารถรับประกันได้ว่าเซสชันที่อยู่นอกขอบเขตจะปิดเมื่อใด เราจึงขอแนะนำให้คุณเรียกใช้เมธอด close()อย่างชัดเจน
ส่งข้อความ
หากต้องการส่งข้อความไปยังอุปกรณ์อื่น คุณต้องมีออบเจ็กต์ต่อไปนี้
ก
DiscoverySessionออบเจ็กต์นี้ช่วยให้คุณเรียกใช้sendMessage()ได้ แอปของคุณจะได้รับDiscoverySessionโดยเผยแพร่บริการหรือสมัครใช้บริการPeerHandleของอุปกรณ์เครื่องอื่นเพื่อส่งข้อความ แอปของคุณจะได้รับPeerHandleของอุปกรณ์อื่นด้วยวิธีใดวิธีหนึ่งต่อไปนี้- แอปของคุณเผยแพร่บริการและได้รับข้อความจากผู้สมัครใช้บริการ
แอปของคุณจะได้รับ
PeerHandleของผู้ติดตามจากonMessageReceived()callbacks - แอปของคุณสมัครใช้บริการ จากนั้นเมื่อพบผู้เผยแพร่โฆษณาที่ตรงกัน แอปของคุณจะได้รับ
PeerHandleของผู้เผยแพร่โฆษณาจาก callback ของonServiceDiscovered()
- แอปของคุณเผยแพร่บริการและได้รับข้อความจากผู้สมัครใช้บริการ
แอปของคุณจะได้รับ
หากต้องการส่งข้อความ ให้โทรไปที่
sendMessage() จากนั้นอาจมีการเรียกกลับต่อไปนี้
- เมื่อคู่สนทนาได้รับข้อความเรียบร้อยแล้ว ระบบจะเรียกใช้การเรียกกลับ
onMessageSendSucceeded()ในแอปส่ง - เมื่อคู่สนทนาได้รับข้อความ ระบบจะเรียกใช้ callback ของ
onMessageReceived()แอปฝั่งที่รับ
แม้ว่าจะต้องใช้ PeerHandle เพื่อสื่อสารกับคู่ค้า แต่คุณไม่ควรใช้ PeerHandle เป็นตัวระบุถาวรของคู่ค้า แอปพลิเคชันสามารถใช้ตัวระบุระดับที่สูงขึ้นได้ ซึ่งฝังอยู่ในบริการค้นพบเองหรือในข้อความต่อๆ ไป คุณสามารถฝังตัวระบุในบริการการค้นพบได้ด้วยวิธี setMatchFilter() หรือ setServiceSpecificInfo() ของ PublishConfig หรือ SubscribeConfig เมธอด setMatchFilter() จะส่งผลต่อการค้นพบ แต่เมธอด setServiceSpecificInfo() จะไม่ส่งผลต่อการค้นพบ
การฝังตัวระบุในข้อความหมายความว่ามีการแก้ไขอาร์เรย์ไบต์ของข้อความให้รวมตัวระบุ (เช่น เป็นไบต์ 2-3 ตัวแรก)
สร้างการเชื่อมต่อ
Wi-Fi Aware รองรับเครือข่ายไคลเอ็นต์-เซิร์ฟเวอร์ระหว่างอุปกรณ์ Wi-Fi Aware 2 เครื่อง
วิธีตั้งค่าการเชื่อมต่อไคลเอ็นต์กับเซิร์ฟเวอร์
ใช้การค้นพบ Wi-Fi Aware เพื่อเผยแพร่บริการ (บนเซิร์ฟเวอร์) และสมัครใช้บริการ (บนไคลเอ็นต์)
เมื่อผู้ติดตามค้นพบผู้เผยแพร่แล้ว ให้ส่งข้อความจากผู้ติดตามไปยังผู้เผยแพร่
เริ่ม
ServerSocketบนอุปกรณ์ของผู้เผยแพร่โฆษณา และตั้งค่าหรือรับพอร์ต ดังนี้Kotlin
val ss = ServerSocket(0) val port = ss.localPort
Java
ServerSocket ss = new ServerSocket(0); int port = ss.getLocalPort();
ใช้
ConnectivityManagerเพื่อขอเครือข่าย Wi-Fi Aware จากผู้เผยแพร่โฆษณาโดยใช้WifiAwareNetworkSpecifierโดยระบุเซสชันการค้นพบและPeerHandleของผู้สมัครใช้บริการ ซึ่งคุณได้รับจากข้อความที่ผู้สมัครใช้บริการส่ง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);
เมื่อผู้เผยแพร่โฆษณาขอเครือข่ายแล้ว ระบบควรส่งข้อความไปยังผู้สมัครใช้บริการ
เมื่อผู้สมัครใช้บริการได้รับข้อความจากผู้เผยแพร่โฆษณาแล้ว ให้ขอเครือข่าย Wi-Fi Aware บนอุปกรณ์ของผู้สมัครใช้บริการโดยใช้วิธีการเดียวกับที่ผู้เผยแพร่โฆษณาใช้ อย่าระบุพอร์ตเมื่อสร้าง
NetworkSpecifierระบบจะเรียกใช้เมธอดการเรียกกลับที่เหมาะสมเมื่อการเชื่อมต่อเครือข่ายพร้อมใช้งาน เปลี่ยนแปลง หรือขาดหายไปเมื่อเรียกเมธอด
onAvailable()ในตัวสมัครใช้บริการแล้ว ระบบจะแสดงออบเจ็กต์Networkซึ่งคุณสามารถเปิดSocketเพื่อสื่อสารกับServerSocketในตัวเผยแพร่ได้ แต่คุณต้องทราบที่อยู่ IPv6 และพอร์ตของServerSocketคุณจะได้รับข้อมูลเหล่านี้จากออบเจ็กต์NetworkCapabilitiesที่ระบุไว้ในการเรียกกลับonCapabilitiesChanged()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);
เมื่อเชื่อมต่อเครือข่ายเสร็จแล้ว ให้โทรไปที่
unregisterNetworkCallback()
การระบุช่วงระยะสัญญาณของอุปกรณ์ระยะไกลและการค้นพบที่คำนึงถึงตำแหน่ง
อุปกรณ์ที่พร้อมใช้งานตำแหน่ง RTT ของ Wi-Fi จะวัดระยะทางไปยังอุปกรณ์อื่นๆ ได้โดยตรง และใช้ข้อมูลนี้เพื่อจำกัดการค้นพบบริการ Wi-Fi Aware
Wi-Fi RTT API ช่วยให้สามารถวัดระยะทางไปยังอุปกรณ์ที่เปิดใช้ Wi-Fi Aware ได้โดยตรงโดยใช้ที่อยู่ MAC หรือ PeerHandle
การค้นพบ Wi-Fi Aware สามารถจํากัดให้ค้นพบเฉพาะบริการภายในเขตพื้นที่เสมือนที่เฉพาะเจาะจง เช่น คุณสามารถตั้งค่าเขตพื้นที่เสมือนที่อนุญาตให้ค้นพบอุปกรณ์ที่เผยแพร่บริการ "Aware_File_Share_Service_Name" ในระยะใกล้สุด 3 เมตร (ระบุเป็น 3,000 มม.) และไกลสุด 10 เมตร (ระบุเป็น 10,000 มม.)
หากต้องการเปิดใช้การกำหนดเขตพื้นที่เสมือน ผู้เผยแพร่โฆษณาและผู้สมัครใช้บริการต้องดำเนินการดังนี้
ผู้เผยแพร่โฆษณาต้องเปิดใช้การวัดระยะทางในบริการที่เผยแพร่โดยใช้ setRangingEnabled(true)
หากผู้เผยแพร่โฆษณาไม่ได้เปิดใช้การระบุระยะทาง ระบบจะไม่สนใจข้อจำกัดของเขตพื้นที่เสมือนที่ระบุโดยสมาชิก และจะทำการค้นพบตามปกติโดยไม่สนใจระยะทาง
ผู้สมัครใช้บริการต้องระบุเขตพื้นที่เสมือนโดยใช้การผสมผสานระหว่าง setMinDistanceMm และ setMaxDistanceMm
สำหรับค่าใดค่าหนึ่ง ระยะทางที่ไม่ได้ระบุจะถือว่าไม่มีขีดจำกัด เฉพาะการระบุระยะทางสูงสุดเท่านั้นที่จะมีความหมายว่าระยะทางขั้นต่ำคือ 0 การระบุเฉพาะระยะทางต่ำสุดจะถือว่าไม่มีระยะทางสูงสุด
เมื่อพบบริการของบุคคลอื่นภายในเขตพื้นที่เสมือน ระบบจะเรียกใช้การเรียกกลับ onServiceDiscoveredWithinRange ซึ่งระบุระยะทางที่วัดได้ไปยังบุคคลนั้น จากนั้นจะเรียกใช้ Wi-Fi RTT API โดยตรงได้ตามต้องการเพื่อวัดระยะทางในภายหลัง