رصد وقت GNSS

بدءًا من الإصدار Android 12، يمكن لنظام Android استخدام "نظام القمر الصناعي العالمي للتنقل" (GNSS) لاقتراح أوقات حقبة Unix للخدمة time_detector. لا تكون هذه الميزة مفعَّلة تلقائيًا في بروتوكول AOSP.

عندما تكون ميزة "رصد الوقت لنظام GNSS" مفعَّلة، يستمع gnss_time_update_service بشكل سلبي إلى تعديلات الموقع الجغرافي من مصادر GNSS ويرسل اقتراحات GNSS إلى خدمة time_detector. بعد ذلك، تحدِّد خدمة time_detector ما إذا كان سيتم تعديل ساعة النظام لتتطابق مع الاقتراح.

التأثير في استخدام الطاقة

يستمع gnss_time_update_service AOSP إلى تعديلات الموقع الجغرافي بشكل سلبي. ويعني ذلك أنّه لا يعمل على تفعيل نظام تحديد المواقع العالمي (GPS) أو استهلاك طاقة إضافية. ويعني ذلك أيضًا أنّه ما لم يكن هناك تطبيق أو خدمة أخرى في النظام تطلب بشكل نشط تعديلات على الموقع الجغرافي، لن يتلقّى gnss_time_update_service تعديلًا على الموقع الجغرافي ولن يقترح وقتًا لنظام تحديد المواقع العالمي (GNSS).

التنفيذ

لتفعيل ميزة "رصد الوقت" باستخدام نظام تحديد المواقع العالمي (GNSS)، على المصنّعين تفعيل gnss_time_update_service صراحةً في خادم النظام.

يجب تعديل قيمتَي config_enableGnssTimeUpdateService وconfig_autoTimeSourcesPriority في ملف core/res/res/values/config.xml لتفعيل هذه الميزة. اضبط قيمة config_enableGnssTimeUpdateService على true وأضف gnss إلى قائمة العناصر لـ config_autoTimeSourcesPriority. يحدِّد موضع gnss في قائمة ملف تعريف الأولوية التي يتم منحها لاقتراحات نظام تحديد المواقع العالمي (GNSS) مقارنةً بتلك التي تأتي من مصادر أخرى.

في ما يلي مثال على ملف core/res/res/values/config.xml تم فيه تفعيل رصد وقت GNSS ويكون gnss ثالثًا في قائمة الأولويات بعد network وtelephony.

<!-- Specifies priority of automatic time sources. Suggestions from higher entries in the list
         take precedence over lower ones.
         See com.android.server.timedetector.TimeDetectorStrategy for available sources. -->
    <string-array name="config_autoTimeSourcesPriority">
        <item>network</item>
        <item>telephony</item>
        <item>gnss</item>
    </string-array>

    <!-- Enables the GnssTimeUpdate service. This is the global switch for enabling Gnss time based
         suggestions to TimeDetector service. See also config_autoTimeSourcesPriority. -->
    <bool name="config_enableGnssTimeUpdateService">true</bool>

تصحيح الأخطاء والاختبار

لاختبار رصد الوقت باستخدام نظام تحديد المواقع العالمي (GNSS)، يمكنك استخدام أوامر adb shell cmd location. استخدِم هذه الأوامر لإضافة موفِّري مواقع جغرافية تجريبية يمكنهم من خلالها تحديد موقع جغرافي ووقت GNSS المرتبط به. يستمع gnss_time_update_service إلى تعديلات الموقع الجغرافي هذه ويقدم اقتراحات بشكل دوري.

في ما يلي أمثلة على أوامر adb shell cmd location:

# Enable Master Location Switch in the foreground user (usually user 10 on automotive). If you just flashed, this can be done through setup wizard.
adb shell cmd location set-location-enabled true --user 10

# Add GPS test provider (This usually fails the first time. Throws a SecurityException with "android from <SOME_UID> not allowed to perform MOCK_LOCATION".)
adb shell cmd location providers add-test-provider gps

# Enable mock location permissions for previous UID
adb shell appops set UID_PRINTED_IN_PREVIOUS_ERROR android:mock_location allow

# Add GPS test provider (Should work with no errors.)
adb shell cmd location providers add-test-provider gps

# Enable GPS test provider
adb shell cmd location providers set-test-provider-enabled gps true

# Set location with time (Time can't be lower than the limit set by the lower bound.)
adb shell cmd location providers set-test-provider-location gps --location LATITUDE,LONGITUDE --time TIME