ตำแหน่งของ Wi-Fi: ที่มี RTT

คุณสามารถใช้ฟังก์ชันตำแหน่ง Wi-Fi ที่ให้บริการโดย API RTT ของ Wi-Fi (ไป-กลับ) เพื่อวัดระยะทางไปยังจุดเข้าใช้งาน Wi-Fi และเพียร์ Wi-Fi ใกล้เคียงที่ใช้ RTT ได้ อุปกรณ์ Wi-Fi Aware

ถ้าคุณวัดระยะทางไปยังจุดเข้าใช้งาน 3 จุดขึ้นไป คุณสามารถใช้ แบบหลายมุมมอง เพื่อคาดคะเนตำแหน่งของอุปกรณ์ที่เหมาะกับความต้องการนั้นมากที่สุด การวัดค่าต่างๆ โดยปกติแล้วผลลัพธ์จะมีความแม่นยำภายในระยะ 1-2 เมตร

ด้วยความแม่นยำนี้ คุณจะสามารถพัฒนาการบริการตามสถานที่แบบละเอียด เช่น เป็นการนำทางภายในอาคาร การควบคุมด้วยเสียงที่มีความชัดเจน (เช่น "เปิดฟีเจอร์นี้ แสง") และข้อมูลตามสถานที่ตั้ง (เช่น "มีข้อเสนอพิเศษไหม สำหรับผลิตภัณฑ์นี้")

อุปกรณ์ที่ส่งคำขอไม่จำเป็นต้องเชื่อมต่อกับจุดเข้าใช้งานเพื่อวัด ด้วย RTT ของ Wi-Fi เพื่อรักษาความเป็นส่วนตัว เฉพาะอุปกรณ์ที่ส่งคำขอเท่านั้นที่ทำได้ เพื่อกำหนดระยะทางไปยังจุดเข้าใช้งาน จุดเข้าใช้งานไม่มี ข้อมูลนี้ การดำเนินการ RTT ของ Wi-Fi นั้นไม่จำกัดสำหรับแอปที่ทำงานอยู่เบื้องหน้า แต่จะมีขีดจำกัด มีการควบคุมสำหรับแอปพื้นหลัง

RTT ของ Wi-Fi และการวัดเวลาอย่างละเอียด (FTM) ที่เกี่ยวข้อง ที่กำหนดโดยมาตรฐาน IEEE 802.11-2016 RTT ของ Wi-Fi ต้องใช้เวลาที่แม่นยำ จาก FTM เพราะคำนวณระยะทางระหว่าง โดยการวัดเวลาที่แพ็กเก็ตใช้เดินทางไปมาระหว่าง อุปกรณ์ต่างๆ แล้วนำเวลานั้นไปคูณกับความเร็วแสง

Android 15 (API ระดับ 35) เปิดตัวการรองรับสำหรับ IEEE 802.11az แบบไม่มีทริกเกอร์ (NTB)

ความแตกต่างในการใช้งานตามเวอร์ชันของ Android

RTT ของ Wi-Fi เปิดตัวใน Android 9 (API ระดับ 28) เมื่อใช้โปรโตคอลนี้ เพื่อระบุตำแหน่งของอุปกรณ์โดยใช้มัลติเพลตกับอุปกรณ์ที่ใช้ Android 9 คุณต้องมีสิทธิ์เข้าถึงตำแหน่งของจุดเข้าใช้งาน (AP) ที่กำหนดไว้ล่วงหน้า ข้อมูลในแอปของคุณ คุณเป็นผู้ตัดสินใจว่าจะจัดเก็บและเรียกข้อมูลนี้อย่างไร

สำหรับอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป ข้อมูลตำแหน่ง AP อาจมีลักษณะดังนี้ แสดงเป็น ResponderLocation ซึ่งรวมถึงละติจูด ลองจิจูด และระดับความสูง สำหรับ RTT ของ Wi-Fi ที่ สนับสนุนข้อมูลการกำหนดค่าตำแหน่ง/รายงานตำแหน่งพลเมือง (ข้อมูล LCI/LCR) โปรโตคอลจะแสดงผลออบเจ็กต์ ResponderLocation ระหว่าง กระบวนการทำช่วง

ฟีเจอร์นี้อนุญาตให้แอปค้นหา AP เพื่อขอตำแหน่งของ AP ได้โดยตรง แทนที่จะต้องเก็บข้อมูลนี้ไว้ล่วงหน้า แอปของคุณจึงสามารถ ค้นหา AP และกำหนดอันดับ แม้ว่า AP นั้นจะไม่รู้จักมาก่อนก็ตาม เช่น เมื่อผู้ใช้เข้าอาคารใหม่

การรองรับระยะ NTB ของ IEEE 802.11az พร้อมใช้งานในอุปกรณ์ที่ใช้ Android 15 (API ระดับ 35) ขึ้นไป ซึ่งหมายความว่าหากอุปกรณ์รองรับ IEEE 802.11az โหมดการตอบกลับ NTB (ระบุโดย WifiRttManager.CHARACTERISTICS_KEY_BOOLEAN_STA_RESPONDER) แอปของคุณสามารถค้นหา AP ทั้ง IEEE 802.11mc และ IEEE 802.11az ได้ด้วย คำขอช่วง ขยาย RangingResult API เพื่อให้ข้อมูล เกี่ยวกับค่าต่ำสุดและสูงสุดที่สามารถใช้เป็นช่วงเวลาระหว่าง การวัดระยะต่างๆ โดยปล่อยให้มีช่วงเวลาที่แน่นอนในการควบคุมแอป

ข้อกำหนด

• ฮาร์ดแวร์ของอุปกรณ์ที่ส่งคำขอกำหนดระยะต้องใช้ มาตรฐาน 802.11-2016 FTM หรือมาตรฐาน 802.11az (ระยะที่ไม่ใช่ทริกเกอร์)
• อุปกรณ์ที่ส่งคำขอกำหนดระยะเวลาต้องใช้ Android 9 (ระดับ API 28) ขึ้นไป เปิดใช้งานระยะแบบไม่มีทริกเกอร์ IEEE 802.11az บนอุปกรณ์ ที่ใช้ Android 15 (API ระดับ 35) ขึ้นไป
• อุปกรณ์ที่ส่งคำขอกำหนดช่วงต้องเปิดใช้บริการตำแหน่ง และการสแกนหา Wi-Fi เปิดอยู่ (ในส่วนการตั้งค่า > ตำแหน่ง)
• หากแอปที่กำลังกำหนดเป้าหมายคำขอช่วง Android 13 (API ระดับ 33) ขึ้นไป จะต้องมี NEARBY_WIFI_DEVICES สิทธิ์ หากแอปดังกล่าวกำหนดเป้าหมาย เป็น Android เวอร์ชันก่อนหน้า จะต้อง มี ACCESS_FINE_LOCATION สิทธิ์ของคุณแทน
• แอปต้องค้นหาช่วงของจุดเข้าใช้งานในขณะที่แอปปรากฏหรืออยู่ใน บริการที่ทำงานอยู่เบื้องหน้า แอปไม่สามารถเข้าถึงข้อมูลตำแหน่งจาก เบื้องหลัง
• จุดเข้าใช้งานต้องใช้มาตรฐาน IEEE 802.11-2016 FTM หรือ IEEE มาตรฐาน 802.11az (ระยะที่ไม่ใช่ทริกเกอร์)

ตั้งค่า

หากต้องการตั้งค่าแอปให้ใช้ RTT ของ Wi-Fi ให้ทำตามขั้นตอนต่อไปนี้

1. ขอสิทธิ์

ขอสิทธิ์ต่อไปนี้ในไฟล์ Manifest ของแอป

<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 และ ACCESS_FINE_LOCATION เป็นอันตราย ดังนั้นคุณต้องขอสิทธิ์ดังกล่าวทุกครั้งที่ผู้ใช้ต้องการ ดำเนินการสแกน RTT แอปของคุณจะต้องขอ สิทธิ์หากคุณยังไม่ได้ดำเนินการ หากต้องการดูข้อมูลเพิ่มเติม เกี่ยวกับสิทธิ์รันไทม์ โปรดดู ขอสิทธิ์ของแอป

2. ตรวจสอบว่าอุปกรณ์รองรับ RTT ของ Wi-Fi หรือไม่

หากต้องการตรวจสอบว่าอุปกรณ์รองรับ RTT ของ Wi-Fi หรือไม่ ให้ใช้ PackageManager API:

context.packageManager.hasSystemFeature(PackageManager.FEATURE_WIFI_RTT)

context.getPackageManager().hasSystemFeature(PackageManager.FEATURE_WIFI_RTT);

3. ตรวจสอบว่า RTT ของ Wi-Fi ใช้งานได้หรือไม่

RTT ของ Wi-Fi อาจมีอยู่ในอุปกรณ์ แต่อาจใช้ไม่ได้เนื่องจากผู้ใช้ ปิดใช้งาน Wi-Fi ทั้งนี้ขึ้นอยู่กับความสามารถของฮาร์ดแวร์และเฟิร์มแวร์ อุปกรณ์อาจไม่รองรับ RTT ของ Wi-Fi หากใช้ SoftAP หรือการเชื่อมต่ออินเทอร์เน็ตผ่านมือถือ หากต้องการตรวจสอบ บริการ RTT ของ Wi-Fi พร้อมใช้งานหรือไม่ โปรดโทร isAvailable()

ความพร้อมใช้งานของ RTT ของ Wi-Fi อาจเปลี่ยนแปลงได้ทุกเมื่อ แอปของคุณควรลงทะเบียน BroadcastReceiver ที่จะได้รับ ACTION_WIFI_RTT_STATE_CHANGED ซึ่งจะส่งเมื่อมีการเปลี่ยนแปลงความพร้อมจำหน่ายสินค้า เมื่อแอปได้รับประกาศ แอปควรตรวจสอบสถานะปัจจุบันของความพร้อมให้บริการและปรับ ตามความเหมาะสม

เช่น

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)

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);

ดูข้อมูลเพิ่มเติมได้ในประกาศ

สร้างคำขอกำหนดระยะ

คำขอระยะ สร้าง (RangingRequest) แล้ว ด้วยการระบุรายการ AP หรือแอปเทียบเท่า Wi-Fi Aware ที่มีช่วง สามารถระบุจุดเข้าใช้งานหลายจุดหรือแอปเทียบเท่า Wi-Fi Aware ได้ใน คำขอระยะเดียว ระยะทางไปยังอุปกรณ์ทั้งหมดจะได้รับการวัดและส่งคืน

ตัวอย่างเช่น คำขอสามารถใช้ฟิลด์ addAccessPoint() วิธีระบุจุดเข้าใช้งานที่ใช้วัดระยะทาง

val req: RangingRequest = RangingRequest.Builder().run {
    addAccessPoint(ap1ScanResult)
    addAccessPoint(ap2ScanResult)
    build()
}

RangingRequest.Builder builder = new RangingRequest.Builder();
builder.addAccessPoint(ap1ScanResult);
builder.addAccessPoint(ap2ScanResult);

RangingRequest req = builder.build();

จุดเข้าใช้งานจะระบุโดย ScanResult ซึ่งสามารถเป็น ที่ได้รับจากการโทร WifiManager.getScanResults() คุณสามารถใช้ addAccessPoints(List<ScanResult>) เพื่อเพิ่มจุดเข้าใช้งานหลายจุดในกลุ่ม

ออบเจ็กต์ ScanResult มีทั้ง IEEE 802.11mc (is80211mcResponder()) และ รองรับช่วงที่ไม่ใช่ทริกเกอร์ IEEE 802.11az (is80211azNtbResponder()) AP อุปกรณ์ที่รองรับระยะ IEEE 802.11az NTB จะทํางานได้ทั้ง 802.11mc หรือ ช่วง 802.11az ตามความสามารถของ AP โดยมีค่าเริ่มต้นเป็น 802.11az เมื่อ AP รองรับทั้ง 2 แบบ อุปกรณ์ที่ไม่รองรับ IEEE 802.11az จะทำงานได้ทั้งหมด โดยใช้โปรโตคอล IEEE 802.11mc

ในทำนองเดียวกัน คำขอกำหนดระยะจะสามารถเพิ่มเพียร์ Wi-Fi Aware โดยใช้ MAC ของ Wi-Fi ของเครื่อง ที่อยู่หรือ PeerHandle โดยใช้ เวลา addWifiAwarePeer(MacAddress peer) และ addWifiAwarePeer(PeerHandle peer) ตามลำดับ ดูข้อมูลเพิ่มเติมเกี่ยวกับการค้นหาแอปที่เทียบเท่า Wi-Fi Aware ดูเอกสารประกอบเกี่ยวกับ Wi-Fi Aware

ระยะคำขอ

แอปออกคำขอกำหนดระยะโดยใช้ WifiRttManager.startRanging() และระบุสิ่งต่อไปนี้ RangingRequest เพื่อระบุ Executor เพื่อระบุ บริบท Callback และ RangingResultCallback เพื่อรับผลลัพธ์

เช่น

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) { … }
})

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) { … }
});

การดำเนินการกำหนดระยะจะทำงานไม่พร้อมกัน และผลการวัดระยะ แสดงผลในการเรียกกลับรายการใดรายการหนึ่งของ RangingResultCallback:

• ถ้าการดำเนินการกำหนดระยะทั้งหมดล้มเหลว ระบบจะ onRangingFailure Callback จะทำงานโดยมีรหัสสถานะที่อธิบายไว้ใน RangingResultCallback ความล้มเหลวดังกล่าวอาจเกิดขึ้นหากบริการไม่สามารถดำเนินการกำหนดระยะ ในเวลานั้น เช่น เนื่องจาก Wi-Fi ถูกปิดใช้งานเนื่องจากแอปพลิเคชัน ส่งคำขอดำเนินการเกี่ยวกับระยะมากเกินไปและถูกควบคุม หรือเนื่องจาก ปัญหาเกี่ยวกับสิทธิ์
• เมื่อการดำเนินการกำหนดระยะเสร็จสมบูรณ์ onRangingResults Callback จะถูกเรียกใช้ด้วยรายการผลลัพธ์ที่ตรงกับรายการของ คำขอ - ผลลัพธ์ 1 รายการสำหรับคำขอแต่ละรายการ ลำดับของผลลัพธ์ไม่ ต้องตรงกับลำดับของคำขอ โปรดทราบว่าการดำเนินการกำหนดระยะห่างอาจ เสร็จสมบูรณ์ แต่ผลลัพธ์แต่ละรายการอาจยังคงบ่งชี้ถึงความล้มเหลวในการดำเนินการนั้นๆ การวัดผล

ตีความผลลัพธ์ของระยะ

ผลลัพธ์แต่ละรายการที่แสดงโดย onRangingResults มีการระบุการติดต่อกลับโดย RangingResult ออบเจ็กต์ ในคำขอแต่ละรายการ ให้ทำตามขั้นตอนต่อไปนี้

1. ระบุคำขอ

ระบุคำขอตามข้อมูลที่ให้ไว้ตอนที่สร้าง RangingRequest: ซึ่งมักจะเป็นที่อยู่ MAC ที่ระบุไว้ใน ScanResult เพื่อระบุการเข้าถึง คะแนน ที่อยู่ MAC สามารถหาได้จากผลลัพธ์ระยะโดยใช้ getMacAddress()

รายการผลลัพธ์ช่วงอาจเรียงลำดับต่างจากแอปเทียบเท่า (การเข้าถึง จุด) ที่ระบุในคำขอระยะ ดังนั้นคุณควรใช้ที่อยู่ MAC เพื่อ ระบุแอปเทียบเท่า ไม่ใช่ลำดับของผลลัพธ์

2. ตรวจสอบว่าการวัดผลแต่ละครั้งสําเร็จหรือไม่

หากต้องการดูว่าการวัดสำเร็จหรือไม่ ให้ใช้ getStatus() ค่าอื่นๆ นอกเหนือจาก STATUS_SUCCESS หมายถึงล้มเหลว ความล้มเหลวหมายถึงฟิลด์อื่นๆ ทั้งหมดของผลลัพธ์นี้ (ยกเว้นการระบุคำขอด้านบน) ไม่ถูกต้อง และ เมธอด get* จะล้มเหลวโดยมี ข้อยกเว้น IllegalStateException

3. รับผลลัพธ์ของการวัดที่ประสบความสำเร็จแต่ละรายการ

สำหรับการวัดที่สำเร็จแต่ละครั้ง (RangingResult) คุณสามารถดึงผลลัพธ์ได้ ด้วยเมธอด get ที่เกี่ยวข้องกัน ดังนี้

• ระยะทางเป็นมม. และค่าเบี่ยงเบนมาตรฐานของการวัด

  getDistanceMm()

  getDistanceStdDevMm()

• RSSI ของแพ็กเก็ตที่ใช้สำหรับการวัด:

  getRssi()

• เวลาเป็นมิลลิวินาทีที่ใช้การวัด (ระบุเวลา ตั้งแต่เปิดเครื่อง):

  getRangingTimestampMillis()

• จำนวนการวัดที่พยายามทำและจำนวนการวัด ที่สำเร็จ (และที่ใช้การวัดระยะทาง)

  getNumAttemptedMeasurements()

  getNumSuccessfulMeasurements()

• เวลาขั้นต่ำและสูงสุดที่อุปกรณ์ไคลเอ็นต์ต้องรอระหว่าง 11az NTB สัดส่วน:

  getMinTimeBetweenNtbMeasurementsMicros() และ getMaxTimeBetweenNtbMeasurementsMicros() แสดงเวลาต่ำสุดและสูงสุด หากการวัดระยะถัดไปคือ ที่ขอก่อนที่เวลาขั้นต่ำจะผ่านไป จากนั้น API จะส่งคืน ผลการวัดระยะแคช หากมีการร้องขอการวัดระยะถัดไปหลังจาก เวลาที่ผ่านไปสูงสุดแล้ว API จะหยุดการทำงานที่ไม่ได้ทริกเกอร์ การจัดเซสชันและเจรจาต่อรองเซสชันการกำหนดระยะใหม่กับฝ่าย สถานี คุณควรหลีกเลี่ยงการขอเซสชันการจัดระยะใหม่ เนื่องจากจะเป็นการเพิ่ม ค่าใช้จ่ายต่อเวลาการวัดระยะห่าง เพื่อใช้ประโยชน์จาก 802.11az อย่างเต็มที่ ประสิทธิภาพของช่วงที่ไม่ใช่ทริกเกอร์ เรียกใช้คำขอช่วงถัดไป ระหว่างเวลาการวัดต่ำสุดและสูงสุดที่ระบุไว้ในก่อนหน้านี้ การวัด RangingResult

• การทำซ้ำในช่องการฝึกอบรมแบบยาว (LTF) ที่ทำให้ผู้ตอบและสถานีเริ่มดำเนินการ ที่ใช้ในข้อความเบื้องต้นสำหรับผลลัพธ์ IEEE 802.11az NTB:

  get80211azResponderTxLtfRepetitionsCount()

  get80211azInitiatorTxLtfRepetitionsCount()

• จำนวนการส่งและรับสตรีมเวลาเชิงพื้นที่ (STS) ที่ผู้เริ่ม สถานีที่ใช้สำหรับผลลัพธ์ IEEE 802.11az NTB:

  get80211azNumberOfTxSpatialStreams()

  get80211azNumberOfRxSpatialStreams()

อุปกรณ์ Android ที่รองรับ Wi-Fi-RTT

ตารางต่อไปนี้แสดงรายการโทรศัพท์ จุดเข้าใช้งาน และอุปกรณ์ค้าปลีก คลังสินค้า และศูนย์กระจายสินค้าบางส่วน ที่รองรับ Wi-Fi-RTT สิ่งเหล่านี้ห่างไกลจากความครอบคลุม เราขอแนะนำให้คุณ ติดต่อเรา เพื่อแสดงผลิตภัณฑ์ที่รองรับ RTT ที่นี่

จุดเข้าใช้งาน

โทรศัพท์

อุปกรณ์สำหรับร้านค้าปลีก คลังสินค้า และศูนย์กระจายสินค้า