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

  
استخدام تقنية النطاق الفائق العرض (UWB) على الأجهزة المتوافقة
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي الأول
11 كانون الأول (ديسمبر) 2024 - - - 1.0.0-alpha10

الإعلان عن التبعيات

لإضافة تبعية على "الإصدار الأساسي"، عليك إضافة مستودع 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-alpha08"
}

Kotlin

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

لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإنشاء.

ملاحظات

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

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

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

الإصدار 1.0

الإصدار 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 على هذه المراجعات.

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

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

الإصدار 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 على هذه المراجعات.

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

  • في حال عدم توفّر خدمة GMS، ستحاول AndroidX API استخدام خدمة 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 على هذه المراجعات.

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

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