GNSS 時間偵測

從 Android 12 開始,Android 可以選擇使用 全球導航衛星系統 (GNSS),可用來建議 Unix 紀元時間 time_detector 服務。 Android 開放原始碼計畫並未預設啟用這項功能。

如果啟用 GNSS 時間偵測功能,gnss_time_update_service 聆聽 GNSS 來源提供的位置資訊,並向 GNSS 建議 time_detector 服務。接著,time_detector 服務會判斷 更新系統時鐘以符合建議

對耗電量的影響

Android 開放原始碼計畫 gnss_time_update_service 會被動監聽位置更新。這個 表示它絕對不會主動開啟 GPS 或消耗額外電力。這個 換句話說,除非系統中其他應用程式或服務處於有效狀態,否則 要求位置更新通知,gnss_time_update_service 無法取得位置資訊 更新並提供 GNSS 時間建議

實作

如要啟用 GNSS 時間偵測功能,裝置製造商必須明確啟用 gnss_time_update_service

config_enableGnssTimeUpdateServicecore/res/res/values/config.xml 中的 config_autoTimeSourcesPriority 個值 檔案必須先更新才能啟用這項功能。設定下列項目的值: config_enableGnssTimeUpdateServicetrue 並將 gnss 加入項目清單 config_autoTimeSourcesPrioritygnss 在優先順序中的位置 清單會決定 GNSS 建議的 GNSS 建議優先順序 從其他來源收集的資料

以下是 GNSS 的 core/res/res/values/config.xml 檔案範例 時間偵測已啟用,而gnssnetworktelephony

<!-- 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