رصد الوقت باستخدام نظام تحديد المواقع العالمي (GNSS)

بدءًا من Android 12، يمكن لنظام التشغيل Android استخدام نظام تحديد المواقع العالمي عبر الأقمار الصناعية (GNSS) اختياريًا لاقتراح أوقات حقبة يونكس للخدمة 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 أولوية اقتراحات ملف ‎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