رصد الوقت خارجيًا

بدءًا من نظام التشغيل Android 12، يمكن لنظام Android استخدام مصدر وقت خارجي لاقتراح أوقات حقبة Unix لخدمة time_detector. لا يتم تفعيل هذه الميزة تلقائيًا في 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 الحالي.