Ultra Wideband (UWB)

  
הטמעת UWB (Ultra Wideband) במכשירים נתמכים.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסת אלפא
‫11 במרץ 2026 - - ‎1.0.0-beta01 -

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

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

Kotlin

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

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

משוב

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

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

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

גירסה 1.0

גרסה ‎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 מותקנים במכשירי CN.

גרסה ‎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.