Core 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.0.0-alpha08"
}

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

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

משוב

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

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

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

שינויים ב-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 כדי שהמשתמש יוכל להגדיר פונקציית קריאה חוזרת (callback) כשמתבצע אירוע של שינוי מצב 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

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

תכונות חדשות

• הוספת תמיכה ב-Provisioned STS. עכשיו המשתמשים יכולים לבחור ב-STS מוגדר מראש למדידת מרחק ב-UWB, אם המכשיר מסוגל ל-STS מוגדר מראש. (I19812)

שינויים ב-API

• מוסיפים את subSessionId ו-subSessionKeyInfo ל-rangingParameters. הוספת מזהי תצורה חדשים לתמיכה ב-Provisioned 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 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

• כשאין תמיכה ב-GMS, AndroidX API ינסה להשתמש בשירות הקצה העורפי של AOSP UWB שמופץ ליצרני ציוד מקורי דרך פלטפורמת 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 מכילה את ההצהרות האלה.

תכונות חדשות

• חדש: פריט תוכנה (artifact) של 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

• המאפיין Distance של 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.