Phát hiện thời gian GNSS

Trên Android 12 trở lên, Android có thể tuỳ ý sử dụng Hệ thống vệ tinh dẫn đường toàn cầu (GNSS) để đề xuất thời gian theo kỷ nguyên Unix cho dịch vụ time_detector. Tính năng này không được bật theo mặc định trong AOSP.

Khi tính năng phát hiện thời gian GNSS được bật, gnss_time_update_service sẽ thụ động lắng nghe các thông tin cập nhật vị trí từ các nguồn GNSS và gửi đề xuất GNSS đến dịch vụ time_detector. Sau đó, dịch vụ time_detector sẽ xác định xem có nên cập nhật đồng hồ hệ thống để khớp với đề xuất hay không.

Ảnh hưởng đến mức tiêu thụ điện

gnss_time_update_service AOSP thụ động theo dõi thông tin cập nhật về vị trí. Điều này có nghĩa là ứng dụng không bao giờ chủ động bật GPS hoặc tiêu thụ thêm pin. Điều này cũng có nghĩa là trừ phi một ứng dụng hoặc dịch vụ khác trong hệ thống đang chủ động yêu cầu thông tin cập nhật vị trí, nếu không gnss_time_update_service sẽ không nhận được thông tin cập nhật vị trí và đề xuất thời gian GNSS.

Triển khai

Để bật tính năng phát hiện thời gian GNSS, các nhà sản xuất thiết bị phải bật gnss_time_update_service một cách rõ ràng trong máy chủ hệ thống.

Bạn phải cập nhật cả giá trị config_enableGnssTimeUpdateServiceconfig_autoTimeSourcesPriority trong tệp core/res/res/values/config.xml để bật tính năng này. Đặt giá trị cho config_enableGnssTimeUpdateService thành true và thêm gnss vào danh sách mục cho config_autoTimeSourcesPriority. Vị trí của gnss trong danh sách ưu tiên sẽ xác định mức độ ưu tiên được chỉ định cho các đề xuất GNSS so với các đề xuất từ những nguồn khác.

Sau đây là ví dụ về tệp core/res/res/values/config.xml trong đó tính năng phát hiện thời gian GNSS được bật và gnss là lựa chọn thứ ba trong danh sách ưu tiên sau networktelephony.

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

Gỡ lỗi và thử nghiệm

Để kiểm thử tính năng phát hiện thời gian GNSS, bạn có thể dùng các lệnh adb shell cmd location. Sử dụng các lệnh này để thêm nhà cung cấp vị trí kiểm thử, trong đó bạn có thể chỉ định vị trí và thời gian GNSS liên kết. gnss_time_update_service sẽ lắng nghe những thông tin cập nhật vị trí này và đưa ra đề xuất định kỳ.

Sau đây là ví dụ về các lệnh 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