پهنای باند فوق العاده گسترده (UWB)

پیاده‌سازی UWB (فوق پهن‌باند) روی دستگاه‌های پشتیبانی‌شده.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۳ دسامبر ۲۰۲۵ - - - ۱.۰.۰-آلفا۱۱

اعلام وابستگی‌ها

برای افزودن یک وابستگی به هسته، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

کاتلین 

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

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۱۱

۳ دسامبر ۲۰۲۵

androidx.core.uwb:uwb:1.0.0-alpha11 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11 منتشر شدند. نسخه 1.0.0-alpha11 شامل این کامیت‌ها است.

تغییرات API

  • معرفی API جدید RangingResultFailure برای گزارش شکست و دلیل نشست دامنه‌یابی، شکست شروع دامنه‌یابی دلیلی را در پاسخ به فراخوانی موجود RangingResultPeerDisconnected ( If3715 ) درج خواهد کرد.

نسخه ۱.۰.۰-آلفا۱۰

۱۱ دسامبر ۲۰۲۴

androidx.core.uwb:uwb:1.0.0-alpha10 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10 منتشر شدند. نسخه 1.0.0-alpha10 شامل این کامیت‌ها است.

تغییرات API

  • کد دلیل STATE_CHANGE_REASON_UNKNOWN ، STATE_CHANGE_REASON_SYSTEM_POLICY و STATE_CHANGE_REASON_COUNTRY_CODE_ERROR را برای تغییر وضعیت UWB اضافه می‌کند. ( I43e36 )
  • برای ارسال رویداد هنگام مقداردهی اولیه یک جلسه‌ی اندازه‌گیری، API جدید RangingResult#RangingResultInitialized اضافه کنید. ( I386bb )
  • APIهای جدید subscribeToUwbAvailability(observer: UwbAvailabilityCallback) و unsubscribeFromUwbAvailability() را به شنونده رویداد تغییر وضعیت UWB اضافه کنید. رابط کاربری جدید UwbAvailabilityCallback برای کاربر اضافه کنید تا هنگام مشاهده رویداد تغییر وضعیت UWB، تابع فراخوانی (callback) را تعریف کند ( I37191 ).

نسخه ۱.۰.۰-آلفا۰۹

۱۶ اکتبر ۲۰۲۴

androidx.core.uwb:uwb:1.0.0-alpha09 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09 منتشر شدند. نسخه 1.0.0-alpha09 شامل این کامیت‌ها است.

تغییرات API

  • API جدید isAvailable() را برای بررسی در دسترس بودن UWB اضافه می‌کند. ( If6fc6 )
  • API جدید addControleeWithSessionParams برای پشتیبانی از افزودن کنترل‌ها با استفاده از کلیدهای مجزا (p-sts) اضافه می‌کند. ( Ie7849 )

نسخه ۱.۰.۰-آلفا۰۸

۲۴ ژانویه ۲۰۲۴

androidx.core.uwb:uwb:1.0.0-alpha08 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08 منتشر شدند. نسخه 1.0.0-alpha08 شامل این کامیت‌ها است.

تغییرات API

  • قابلیت‌ها و پارامترهای جدیدی اضافه شده است تا به برنامه 3p اجازه دهد فاصله زمانی اندازه‌گیری، مدت زمان اسلات و فعال/غیرفعال کردن AoA را تنظیم کند. API جدیدی برای پشتیبانی از پیکربندی مجدد فاصله زمانی اندازه‌گیری و اعلان داده‌های محدوده اضافه شده است. ( Iebd18 )

نسخه ۱.۰.۰-آلفا۰۷

۲۳ آگوست ۲۰۲۳

androidx.core.uwb:uwb:1.0.0-alpha07 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07 منتشر شدند. نسخه 1.0.0-alpha07 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکلی که باعث می‌شد وقتی سرویس‌های گوگل پلی روی دستگاه‌های CN نصب هستند، از بک‌اند AOSP استفاده نشود، برطرف شد.

نسخه ۱.۰.۰-alpha06

۲۶ ژوئیه ۲۰۲۳

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 )

تغییرات API

  • subSessionId و subSessionKeyInfo را به rangingParameters اضافه کنید. شناسه‌های پیکربندی جدیدی برای پشتیبانی از STS ارائه شده اضافه کنید. ( I19812 )
  • فایل‌های API عمومی و آزمایشی برای مسیرهای a، b، c ادغام شدند ( I8cfee ، b/278769092 )
  • ناموجود، تغییرات فایل API فقط متدهای مرتب‌سازی مجدد هستند ( I5fa95 )
  • گروه androidx.core برای استفاده از فایل‌های API عمومی ادغام‌شده ( Ifdef4 ، b/278769092 ) مهاجرت کرد.
  • minRangingInterval ، supportedChannels و supportedConfigIds را به عنوان فیلدهای جدید به rangingCapabilities اضافه کنید. ( I2a204 )

رفع اشکالات

  • مشکل عدم امکان ایجاد کلاینت UWB در ناحیه غیر gms برطرف شد.

نسخه ۱.۰.۰-آلفا۰۵

۵ آوریل ۲۰۲۳

androidx.core.uwb:uwb:1.0.0-alpha05 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

تغییرات API

  • نام RangingParameters#CONFIG_ID_1 را به CONFIG_UNICAST_DS_TWR تغییر دهید.
  • یک شناسه پیکربندی جدید با نام RangingParameters#CONFIG_MULTICAST_DS_TWR اضافه کنید ( I2f1b7 ).

رفع اشکالات

  • رفع اشکالی که کاربران نمی‌توانند چندین جلسه مسافت‌یابی را به صورت موازی شروع کنند.

نسخه ۱.۰.۰-آلفا۰۴

۷ دسامبر ۲۰۲۲

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 بین تولیدکنندگان اصلی تجهیزات (OEM) توزیع شده است، استفاده کند. ( 532de0 )

تغییرات API

  • اضافه کردن حاشیه‌نویسی @JvmDefaultWithCompatibility ( I8f206 )

نسخه ۱.۰.۰-آلفا۰۳

۱۰ آگوست ۲۰۲۲

androidx.core.uwb:uwb:1.0.0-alpha03 و androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03 منتشر شدند. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • معرفی یک پروفایل جدید برای مسافت‌یابی، کنترلر. دستگاه‌های UWB با پروفایل کنترلر می‌توانند کانال مسافت‌یابی که دو دستگاه با آن مسافت‌یابی خواهند کرد را تعیین کنند.

تغییرات API

  • اضافه شدن پشتیبانی از کنترلر برای UWB ( I52a71 )

نسخه ۱.۰.۰-آلفا۰۲

۲۹ ژوئن ۲۰۲۲

androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • معرفی یک مصنوع سازگار با جاوا برای ماژول uwb. این مصنوع جدید به rxjava3 وابسته است و برای کلاینت‌های جاوا قابل استفاده خواهد بود.

نسخه ۱.۰.۰-آلفا۰۲

۱۵ ژوئن ۲۰۲۲

androidx.core.uwb:uwb:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • معرفی یک UWB_CONFIG_ID_1 عمومی

تغییرات API

  • فاصله‌ی RangingResultPosition اکنون قابل تهی‌سازی است

نسخه ۱.۰.۰-آلفا۰۱

۱ ژوئن ۲۰۲۲

androidx.core.uwb:uwb:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • کتابخانه UWB مجموعه‌ای از APIها را برای توسعه‌دهندگان فراهم می‌کند تا با دستگاه‌های دارای قابلیت UWB تعامل داشته باشند. موارد استفاده محدود به دستگاه‌های مشارکتی خواهد بود که از قبل پروفایل کنترلر جلسات مسافت‌یابی UWB را در نظر می‌گیرند و پشتیبانی از پروفایل کنترلر در آینده نزدیک برنامه‌ریزی شده است. دو سطح API سطح بالا در این نسخه اولیه گنجانده شده است، UwbManager و UwbClientSessionScope .