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

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

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

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

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

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

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

الملاحظات

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

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

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

الإصدار 1.1

الإصدار ‎1.1.0-alpha02

‫09 سبتمبر 2026

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

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

• إتاحة استخدام دمج البيانات المستند إلى قياس المسافة، ما يوفّر تقديرًا لزاوية الوصول إلى البرنامج ويعدّل قياسات النطاق لحركة الجهاز المحلية. (I191a9)

الإصدار ‎1.1.0-alpha01

‫19 مايو 2026

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

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

• إضافة واجهة برمجة التطبيقات الجديدة close() إلى UwbManager لإلغاء ربط خدمة النطاق الفائق العرض (UWB) (I4606f, b/498499531)

الإصدار 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" مثبّتة على أجهزة الصين.

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