اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
النطاق الفائق العرض
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بدءًا من Android 13، يتضمّن نظام التشغيل Android إطار عمل تلقائيًا لتطبيق تقنية النطاق الفائق العرض (UWB)، وهي تقنية تسمح بقياس المسافة بين الأجهزة المتوافقة بدقة وأمان كبيرَين. يتوفّر حِزمة AOSP UWB لنظام التشغيل Android كأحد
الوحدات الاختيارية لشركات تصنيع الأجهزة.
لمزيد من التفاصيل عن الوحدة، يُرجى الاطّلاع على
الوحدة: النطاق الفائق العرض (UWB).
هندسة معمارية
تتألف حِزمة UWB من وحدة UWB الرئيسية وتنفيذ HAL
الذي يقدّمه أحد مورّدي شرائح UWB كما هو موضّح في الشكل 1.
الشكل 1: بنية حِزمة النطاق الفائق العرض (UWB)
حزمة AOSP
يحتوي حِزمة AOSP UWB، المُجمَّعة كوحدة اختيارية، com.google.android.uwb،
على المكوّنات التالية:
- واجهة برمجة التطبيقات لمنصّة النطاق الفائق العرض (UWB)
- الموقع الجغرافي للرمز:
packages/modules/Uwb/framework
- مكتبة الدعم
- الموقع الجغرافي للرمز:
packages/modules/Uwb/service/support_lib
- طبقة UwbService وطبقة إدارة الخدمات الشائعة (CSML) المحدَّدة
المكوّنات المحدَّدة من قِبل FiRa
- الموقع الجغرافي للرمز:
packages/modules/Uwb/service
- طبقة UCI الأصلية في Rust
- الموقع الجغرافي للرمز:
external/uwb
- واجهة HAL للنطاق الفائق العرض (UWB) استنادًا إلى مواصفات واجهة الأوامر للنطاق الفائق العرض (UCI)
التي حدّدتها FiRa
- الموقع الجغرافي للرمز:
hardware/interfaces/uwb
مكونات المورّد
تتضمّن حِزمة المورّد تنفيذًا لواجهة برمجة التطبيقات لوحدة التحكّم في النطاق الفائق العرض (UWB HAL) وبرنامج تشغيل UWB و
جهاز UWB.
واجهات برمجة التطبيقات لتقنية النطاق الفائق العرض (UWB)
تتضمّن حِزمة UWB مساحات عرض واجهات برمجة التطبيقات لتطبيقات النظام والتطبيقات التابعة لجهات خارجية.
تطبيقات النظام
يستخدم مصنعو الأجهزة سطح واجهة برمجة تطبيقات android.uwb.UwbManager
للنظام للسماح بوصول تطبيقات النظام إلى مستوى منخفض. لاستخدام سطح برمجة التطبيقات
هذا، يجب أن تستخدم تطبيقات النظام مكتبة الدعم
(packages/modules/Uwb/service/support_lib).
التطبيقات التابعة لجهات خارجية
تستخدم التطبيقات التابعة لجهات خارجية واجهة برمجة التطبيقات العامة Jetpack UWB،
androidx.core.uwb.
لمزيد من المعلومات، يُرجى الاطّلاع على
التواصل عبر النطاق الفائق العرض.
إثبات الملكية
للتحقّق من تنفيذ تقنية النطاق الفائق العرض (UWB)، تأكَّد من أنّ جهازك يجتاز اختبارات CTS
المتوفّرة ضمن /cts/tests/uwb.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Ultra-wideband\n\nFrom Android 13, Android includes a default framework\nimplementation for ultra-wideband (UWB) radio technology, a technology that\nenables highly secure, precise ranging between supported devices. The platform\nAOSP UWB stack is available as an optional\n[module](/docs/core/architecture/modular-system) for device manufacturers.\nFor more details on the module, see\n[Module: UWB](/docs/core/ota/modular-system/uwb).\n\nArchitecture\n------------\n\nThe UWB stack consists of the UWB mainline module and the HAL implementation\nprovided by a UWB chip vendor as shown in Figure 1.\n\n**Figure 1.** UWB stack architecture\n\n### AOSP stack\n\nThe AOSP UWB stack, packaged as an optional module, `com.google.android.uwb`,\ncontains the following components:\n\n- UWB platform API surface\n - Code location: `packages/modules/Uwb/framework`\n- Support library\n - Code location: `packages/modules/Uwb/service/support_lib`\n- UwbService layer and Common Service Management Layer (CSML) defined components defined by [FiRa](https://www.firaconsortium.org/)\n - Code location: `packages/modules/Uwb/service`\n- Rust native UCI layer\n - Code location: `external/uwb`\n- UWB HAL interface based on the UWB command interface (UCI) specification defined by [FiRa](https://www.firaconsortium.org/)\n - Code location: `hardware/interfaces/uwb`\n\n### Vendor components\n\nThe vendor stack includes a UWB HAL vendor implementation, UWB driver, and a\nUWB device.\n\nAPI surfaces for UWB\n--------------------\n\nThe UWB stack includes API surfaces for system apps and third-party apps.\n\n### System apps\n\nDevice manufacturers use the\n[`android.uwb.UwbManager`](https://cs.android.com/android/platform/superproject/+/android-latest-release:packages/modules/Uwb/framework/java/android/uwb/UwbManager.java)\nsystem API surface to allow low-level access for system apps. To use this\nAPI surface, system apps must use the support library\n(`packages/modules/Uwb/service/support_lib`).\n\n### Third-party apps\n\nThird-party apps use the Jetpack UWB public API surface,\n[`androidx.core.uwb`](https://developer.android.com/reference/kotlin/androidx/core/uwb/package-summary).\nFor more information, see\n[Ultra-wide band communication](https://developer.android.com/guide/topics/connectivity/uwb).\n\nVerification\n------------\n\nTo verify your implementation of UWB, ensure that your device passes the CTS\ntests located under `/cts/tests/uwb`."]]
