Ultra Wideband (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")
}

מידע נוסף זמין במאמר הוספת יחסי תלות ב-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לדעת אם גיליתם בעיות חדשות או אם יש לכם רעיונות איך לשפר את הספרייה הזו. כדאי לעיין בבעיות הידועות בספרייה הזו לפני שמדווחים על בעיה. כדי להוסיף הצבעה בדיווח על בעיה קיימת, לוחצים על כפתור הכוכב.

יצירת דיווח על בעיה חדשה

מידע נוסף זמין במאמרי העזרה בנושא Issue Tracker.

גרסה 1.1

גרסה ‎1.1.0-alpha02

‫9 בספטמבר 2026

‫androidx.core.uwb:uwb:1.1.0-alpha02 וגם androidx.core.uwb:uwb-rxjava3:1.1.0-alpha02 מופצים. גרסה ‎1.1.0-alpha02 מכילה את השמירות האלה.

שינויים ב-API

• הוספנו תמיכה במיזוג חיישנים מבוסס-אודומטר, שמספק הערכה של זווית ההגעה בתוכנה ומתאים את מדידות הטווח לתנועת המכשיר המקומי. (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 מכילה את השמירות האלה.

שינויים ב-API

• כדי לבטל את הקישור של שירות ה-UWB, מוסיפים API חדש close() ל-UwbManager. (I4606f, ‏ b/498499531)

גירסה 1.0

גרסה 1.0.0

‫6 במאי 2026

‫androidx.core.uwb:uwb:1.0.0 וגם androidx.core.uwb:uwb-rxjava3:1.0.0 מופצים. גרסה 1.0.0 מכילה את השמירות האלה.

גרסה ‎1.0.0-rc01

‫8 באפריל 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

‫3 בדצמבר 2025

‫androidx.core.uwb:uwb:1.0.0-alpha11 וגם androidx.core.uwb:uwb-rxjava3:1.0.0-alpha11 מופצים. גרסה ‎1.0.0-alpha11 מכילה את השמירות האלה.

שינויים ב-API

• השקנו API חדש RangingResultFailure לדיווח על כשל בסשן של מדידת טווח ועל הסיבה לכך. כשל בהפעלת מדידת הטווח יכלול סיבה בקריאה החוזרת (callback) הקיימת 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 מכילה את השמירות האלה.

שינויים ב-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() ל-listener לאירוע של שינוי סטטוס 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 מכילה את השמירות האלה.

שינויים ב-API

• נוסף API חדש isAvailable() לבדיקת הזמינות של UWB. (If6fc6)
• נוסף API חדש,‏ 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 מכילה את השמירות האלה.

שינויים ב-API

• נוספו יכולות ופרמטרים חדשים שמאפשרים לאפליקציית צד שלישי להגדיר את מרווח המדידה, את משך הזמן של משבצת הזמן ולהפעיל או להשבית את AoA. הוספנו API חדש לתמיכה בהגדרה מחדש של מרווח המדידה והתראות על נתוני הטווח. (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 מכילה את השמירות האלה.

תיקוני באגים

• תוקנה בעיה שבה לא נעשה שימוש ב-backend של 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 עם הקצאת הרשאות. עכשיו המשתמשים יכולים לבחור באפשרות Provisioned STS למדידת מרחק באמצעות UWB אם המכשיר תומך ב-Provisioned STS. (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.

גרסה ‎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 מכילה את השמירות האלה.

שינויים ב-API

• שינוי השם של 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 שמחולק ליצרני ציוד מקורי (OEM) דרך פלטפורמת AOSP.‏ (532de0)

שינויים ב-API

• הוספת הערה @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 עם פרופיל בקר יכולים לקבוע את ערוץ הטווח שבו שני מכשירים יפעלו.

שינויים ב-API

• הוספת תמיכה בשלט משחק ל-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 שגלוי לכולם

שינויים ב-API

• המרחק RangingResultPosition ניתן עכשיו כערך null

גרסה ‎1.0.0-alpha01

‫1 ביוני 2022

‫androidx.core.uwb:uwb:1.0.0-alpha01 מופץ. גרסה 1.0.0-alpha01 מכילה את השמירות האלה.

תכונות חדשות

• ספריית ה-UWB מספקת למפתחים קבוצה של ממשקי API כדי ליצור אינטראקציה עם מכשירים שתומכים ב-UWB. מקרה השימוש יוגבל למכשירים שמשתפים פעולה שכבר מניחים את פרופיל הבקרה של סשנים של טווח UWB, עם תמיכה בפרופיל הבקרה שמתוכננת בעתיד הקרוב. הגרסה הראשונית הזו כוללת שני ממשקי API ברמה העליונה: UwbManager ו-UwbClientSessionScope.