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

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

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

لإضافة اعتمادية على 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"
}

Kotlin

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

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

الملاحظات

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

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

يُرجى الاطّلاع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.0

الإصدار 1.0.0

‫06 مايو 2026

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

الإصدار ‎1.0.0-rc01

‫08 أبريل 2026

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

الإصدار ‎1.0.0-beta01

‫11 مارس 2026

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

الإصدار ‎1.0.0-alpha11

‫03 ديسمبر 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 لتغيير حالة النطاق الفائق العرض (UWB). (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 هذه التعديلات.

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

  • تتم إتاحة استخدام STS الذي تم توفيره. يمكن للمستخدمين الآن اختيار STS الذي تم توفيره لتحديد المدى باستخدام النطاق الفائق العرض (UWB) إذا كان الجهاز متوافقًا مع 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 للأجهزة الجوّالة.

الإصدار ‎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 استخدام خدمة الخلفية للنطاق الفائق العرض (UWB) في AOSP التي يتم توزيعها على الشركات المصنّعة للمعدات الأصلية من خلال منصة 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 هذه التعديلات.

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

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

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

  • تتم إضافة إمكانية استخدام وحدة التحكّم للنطاق الفائق العرض (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). سيقتصر استخدام هذه المكتبة على الأجهزة الشريكة التي تفترض حاليًا ملف "وحدة التحكّم" لجلسات تحديد المدى باستخدام النطاق الفائق العرض (UWB)، مع التخطيط لإتاحة ملف "وحدة التحكّم" في المستقبل القريب. يتضمّن هذا الإصدار الأولي واجهتَي برمجة تطبيقات على المستوى الأعلى، وهما UwbManager وUwbClientSessionScope.