Ultra Wideband (UWB)

Ultra Wideband (UWB)

  

API Reference
androidx.core.uwb

הטמעת UWB (Ultra Wideband) במכשירים נתמכים.

העדכון האחרון	גרסה יציבה	גרסה מועמדת להפצה	גרסת בטא	גרסת אלפא
‫3 בדצמבר 2025	-	-	-	‎1.0.0-alpha11

הצהרה על יחסי תלות

כדי להוסיף תלות ב-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-alpha11"
}

Kotlin

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

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

משוב

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

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

מידע נוסף זמין במאמרי העזרה בנושא הכלי למעקב אחר בעיות.

גירסה 1.0

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

תיקוני באגים

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