GNSS 時間偵測

從 Android 12 開始，Android 可以選擇使用全球衛星導航系統 (GNSS)，為 time_detector 服務建議 Unix 紀元時間。根據預設，AOSP 中不會啟用這項功能。

啟用 GNSS 時間偵測功能後，gnss_time_update_service 會被動地聆聽來自 GNSS 來源的位置更新，並將 GNSS 建議提交至 time_detector 服務。接著，time_detector 服務會決定是否要更新系統時鐘，以符合建議。

對電力使用的影響

AOSP gnss_time_update_service 會被動監聽位置更新。也就是說，裝置不會主動開啟 GPS 或耗用額外電力。這也意味著，除非系統中其他應用程式或服務主動要求位置更新通知，否則 gnss_time_update_service 不會取得位置更新，並建議 GNSS 時間。

實作

如要啟用 GNSS 時間偵測功能，裝置製造商必須在系統伺服器中明確啟用 gnss_time_update_service。

您必須更新 core/res/res/values/config.xml 檔案中的 config_enableGnssTimeUpdateService 和 config_autoTimeSourcesPriority 值，才能啟用這項功能。將 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