النطاق الفائق العرض (UWB) الأساسي

  
استخدام تقنية النطاق الفائق العرض (UWB) على الأجهزة المتوافقة
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫3 ديسمبر 2025 - - - 1.0.0-alpha11

تحديد الاعتماديات

لإضافة اعتمادية على core، يجب تضمين مستودع Google Maven في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

Groovy

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation "androidx.core.uwb:uwb:1.0.0-alpha11"
}

Kotlin

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation("androidx.core.uwb:uwb:1.0.0-alpha11")
}

لمزيد من المعلومات حول الاعتماديات، يُرجى الاطّلاع على إضافة اعتماديات البناء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0

الإصدار 1.0.0-alpha11

‫3 ديسمبر 2025

تم طرح androidx.core.uwb:uwb:1.0.0-alpha11 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha11. يتضمّن الإصدار 1.0.0-alpha11 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • نقدّم واجهة برمجة تطبيقات جديدة RangingResultFailure للإبلاغ عن فشل جلسة تحديد المدى وسببه، وسيتضمّن فشل بدء تحديد المدى سببًا في معاودة الاتصال الحالية RangingResultPeerDisconnected (If3715)

الإصدار 1.0.0-alpha10

‫11 ديسمبر 2024

تم طرح androidx.core.uwb:uwb:1.0.0-alpha10 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha10. يتضمّن الإصدار 1.0.0-alpha10 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تضيف هذه السمة رموز الأسباب STATE_CHANGE_REASON_UNKNOWN وSTATE_CHANGE_REASON_SYSTEM_POLICY وSTATE_CHANGE_REASON_COUNTRY_CODE_ERROR لتغيير حالة النطاق الفائق العرض. (I43e36)
  • أضِف واجهة برمجة تطبيقات جديدة RangingResult#RangingResultInitialized لإرسال حدث عند بدء جلسة تحديد المدى. (I386bb)
  • أضِف واجهتَي برمجة التطبيقات الجديدتَين subscribeToUwbAvailability(observer: UwbAvailabilityCallback) وunsubscribeFromUwbAvailability() إلى أداة معالجة حدث تغيير حالة UWB. إضافة واجهة جديدة UwbAvailabilityCallback ليتمكّن المستخدم من تحديد دالة معاودة الاتصال عند رصد حدث تغيير حالة UWB. (I37191).

الإصدار 1.0.0-alpha09

‫16 أكتوبر 2024

تم طرح androidx.core.uwb:uwb:1.0.0-alpha09 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha09. يتضمّن الإصدار 1.0.0-alpha09 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تضيف هذه السمة واجهة برمجة تطبيقات جديدة isAvailable() للتحقّق من توفّر تقنية UWB. (If6fc6)
  • تضيف هذه السمة واجهة برمجة تطبيقات جديدة addControleeWithSessionParams لدعم حالة مفتاح فردي لـ p-sts الخاص بالمستخدم الخاضع للرقابة. (Ie7849)

الإصدار 1.0.0-alpha08

‫24 يناير 2024

تم طرح androidx.core.uwb:uwb:1.0.0-alpha08 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha08. يتضمّن الإصدار 1.0.0-alpha08 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تضيف هذه السمة إمكانات ومَعلمات جديدة للسماح لتطبيق تابع لجهة خارجية بضبط فاصل تحديد المدى ومدّة الفتحة وتفعيل/إيقاف AoA. تضيف هذه السمة واجهة برمجة تطبيقات جديدة تتيح إعادة ضبط فاصل تحديد المدى وإشعار بيانات المدى. (Iebd18)

الإصدار 1.0.0-alpha07

‫23 أغسطس 2023

تم طرح androidx.core.uwb:uwb:1.0.0-alpha07 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم استخدام الخلفية البرمجية لنظام التشغيل AOSP عند تثبيت "خدمات Google Play" على أجهزة CN.

الإصدار 1.0.0-alpha06

‫26 يوليو 2023

تم طرح androidx.core.uwb:uwb:1.0.0-alpha06 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

الميزات الجديدة

  • إتاحة استخدام Provisioned STS يمكن للمستخدمين الآن اختيار Provisioned STS لتحديد المدى باستخدام تقنية UWB إذا كان الجهاز متوافقًا مع Provisioned STS. (I19812)

تغييرات واجهة برمجة التطبيقات

  • أضِف subSessionId وsubSessionKeyInfo إلى rangingParameters. أضِف معرّفات إعدادات جديدة لتوفير دعم خدمة STS. (I19812)
  • تم دمج ملفات واجهة برمجة التطبيقات العامة والتجريبية للمسارات a وb وc (I8cfee، b/278769092)
  • لا ينطبق، فالتغييرات في ملف واجهة برمجة التطبيقات هي مجرد إعادة ترتيب للطرق (I5fa95)
  • تم نقل المجموعة androidx.core لاستخدام ملفات واجهة برمجة التطبيقات العامة المدمجة (Ifdef4، b/278769092)
  • أضِف minRangingInterval وsupportedChannels وsupportedConfigIds إلى rangingCapabilities كحقول جديدة. (I2a204)

إصلاح الأخطاء

  • تم إصلاح المشكلة المتمثّلة في عدم إمكانية إنشاء عميل UWB في منطقة غير تابعة لخدمات Google للأجهزة الجوّالة (GMS).

الإصدار 1.0.0-alpha05

‫5 أبريل 2023

تم طرح androidx.core.uwb:uwb:1.0.0-alpha05 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

تغييرات واجهة برمجة التطبيقات

  • تمّت إعادة تسمية RangingParameters#CONFIG_ID_1 إلى CONFIG_UNICAST_DS_TWR.
  • أضِف معرّف إعداد جديدًا RangingParameters#CONFIG_MULTICAST_DS_TWR. (I2f1b7)

إصلاح الأخطاء

  • إصلاح الخطأ الذي يمنع المستخدمين من بدء جلسات متعددة لتحديد المدى بالتوازي

الإصدار 1.0.0-alpha04

‫7 كانون الأول (ديسمبر) 2022

تم طرح androidx.core.uwb:uwb:1.0.0-alpha04 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

الميزات الجديدة

  • في حال عدم توفّر خدمات Google للأجهزة الجوّالة، ستحاول واجهة برمجة تطبيقات AndroidX استخدام خدمة الخلفية AOSP UWB الموزَّعة على الشركات المصنّعة للأجهزة الأصلية من خلال منصة AOSP‏.(532de0)

تغييرات واجهة برمجة التطبيقات

  • إضافة تعليق توضيحي @JvmDefaultWithCompatibility (I8f206)

الإصدار 1.0.0-alpha03

‫10 أغسطس 2022

تم طرح androidx.core.uwb:uwb:1.0.0-alpha03 وandroidx.core.uwb:uwb-rxjava3:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

الميزات الجديدة

  • نقدّم لك ملفًا جديدًا لتحديد المدى، وهو Controller. يمكن لأجهزة النطاق الفائق العرض (UWB) التي تستخدم ملف تعريف "جهاز التحكّم" تحديد قناة تحديد المدى التي سيستخدمها الجهازان.

تغييرات واجهة برمجة التطبيقات

  • إضافة إمكانية استخدام وحدة التحكّم مع تقنية النطاق الفائق العرض (I52a71)

الإصدار 1.0.0-alpha02

‫29 يونيو 2022

تم طرح androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

الميزات الجديدة

  • إضافة عنصر متوافق مع Java لوحدة UWB يعتمد العنصر الجديد على rxjava3 ويمكن استخدامه من قِبل عملاء Java.

الإصدار 1.0.0-alpha02

‫15 يونيو 2022

تم طرح androidx.core.uwb:uwb:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

الميزات الجديدة

  • نقدّم لك UWB_CONFIG_ID_1 عامًا

تغييرات واجهة برمجة التطبيقات

  • يمكن الآن أن تكون قيمة سمة "المسافة" (RangingResultPosition) فارغة

الإصدار 1.0.0-alpha01

‫1 يونيو 2022

تم طرح androidx.core.uwb:uwb:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

الميزات الجديدة

  • توفّر مكتبة UWB مجموعة من واجهات برمجة التطبيقات التي تتيح للمطوّرين التفاعل مع الأجهزة المتوافقة مع تقنية UWB. سيقتصر الاستخدام على الأجهزة الشريكة التي تفترض حاليًا ملف تعريف "وحدة التحكّم" لجلسات تحديد المدى باستخدام النطاق الواسع جدًا، مع التخطيط لإتاحة ملف تعريف "وحدة التحكّم" في المستقبل القريب. يتضمّن هذا الإصدار الأوّلي مساحتَي واجهة برمجة تطبيقات من المستوى الأعلى، وهما UwbManager وUwbClientSessionScope.