اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
رصد الوقت الخارجي
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بدءًا من Android 12، يمكن لنظام التشغيل Android استخدام مصدر خارجي للوقت بشكل اختياري
لاقتراح أوقات بدء حقبة Unix على خدمة Time Detector. ولا تكون هذه الميزة مفعّلة تلقائيًا في مشروع Android المفتوح المصدر (AOSP).
يتيح لك مصدر الوقت الخارجي تقديم اقتراحات مخصّصة بالكامل بشأن الوقت إلى نظام التشغيل Android. بعد تلقّي اقتراحات من مصدر الوقت الخارجي، تحدّد خدمة
time_detector ما إذا كان سيتم تعديل ساعة النظام استنادًا إلى
قواعد تحديد الأولوية التلقائية للوقت التي تم ضبطها.
التنفيذ
لإتاحة رصد الوقت الخارجي، يجب تنفيذ مكوّن يرسل اقتراحات الوقت الخارجي إلى خدمة time_detector من خلال طلب نظام لواجهة برمجة التطبيقات.
لضبط المصدر الخارجي، استخدِم ملف إعداد خادم النظام core/res/res/values/config.xml. أضِف القيمة external إلى config_autoTimeSourcesPriority.
يوضّح المثال التالي كيفية توجيه نظام التشغيل Android لمنح اقتراحات الوقت الخارجية الأولوية القصوى عند ضبط ساعة النظام. في حال عدم توفّر اقتراح صالح لوقت خارجي، سيتم استخدام المصدر التالي، وهو gnss في هذه الحالة:
<string-array name="config_autoTimeSourcesPriority">
<item>external</item>
<item>gnss</item>
</string-array>
لتزويد النظام باقتراح وقت خارجي، استخدِم طريقة
suggestExternalTime في TimeManager. إذا تم ضبط المصدر الخارجي باستخدام config_autoTimeSourcesPriority في ملف الإعداد ولم تتوفّر اقتراحات وقت ذات أولوية أعلى، يستخدم نظام التشغيل Android الطابع الزمني الذي تم تمريره إلى هذه الطريقة لضبط الوقت الحالي لفترة الطابع الزمني بتنسيق Unix.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-09-03 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["From Android 12, Android can optionally use an external\nsource of time to suggest Unix epoch times to the [`time_detector`](/docs/core/connect/time#time_detector-service) service.\nThis isn't enabled by default in AOSP.\n\nThe *external* time origin allows device manufacturers to provide completely\ncustom time suggestions to Android. After receiving suggestions from the\nexternal time origin, the `time_detector` service determines whether to update\nthe system clock using the configured [prioritization rules](/docs/core/connect/time#automatic-time).\n\nImplementation\n\nTo support external time detection, device manufacturers must implement a\ncomponent that submits external time suggestions to the `time_detector` service\nthrough a system API call.\n\nTo configure the external origin, use the `core/res/res/values/config.xml`\nsystem server configuration file. Add the value `external` to\n`config_autoTimeSourcesPriority`.\n\nThe following example tells Android to give external time suggestions the\nhighest priority when setting the system clock. If there is no valid external\ntime suggestion available then the next origin, `gnss` in this case, is used. \n\n \u003cstring-array name=\"config_autoTimeSourcesPriority\"\u003e\n \u003citem\u003eexternal\u003c/item\u003e\n \u003citem\u003egnss\u003c/item\u003e\n \u003c/string-array\u003e\n\nTo provide the system with an external time suggestion, use the\n[`suggestExternalTime()`](https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/core/java/android/app/time/TimeManager.java?q=%22void%20suggestExternalTime%22) method in `TimeManager`. If the external origin is\nconfigured using `config_autoTimeSourcesPriority` in the configuration file and\nno higher priority time suggestions are available, Android uses the timestamp\npassed to this method to set the current Unix epoch time."]]
