Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit f5283d2c authored by Yu-Han Yang's avatar Yu-Han Yang
Browse files

Clarify AGC fields 

Bug: 340500547
Test: doc update only
Change-Id: I8d47925ddc948857f686a2feac4748fe917c5024
parent 61e25300

location/java/android/location/GnssMeasurement.java

+4 −0
Original line number Diff line number Diff line
@@ -1484,6 +1484,10 @@ public final class GnssMeasurement implements Parcelable { 
     * in an open sky test - the important aspect of this output is that changes in this value are

     * indicative of changes on input signal power in the frequency band for this measurement.

     *

     * <p> This field is part of the GnssMeasurement object so it is only reported when the GNSS

     * measurement is reported. E.g., when a GNSS signal is too weak to be acquired, the AGC value

     * is not reported.

     *

     * <p> The value is only available if {@link #hasAutomaticGainControlLevelDb()} is {@code true}

     *

     * @deprecated Use {@link GnssMeasurementsEvent#getGnssAutomaticGainControls()} instead.

location/java/android/location/GnssMeasurementsEvent.java

+8 −0
Original line number Diff line number Diff line
@@ -158,6 +158,14 @@ public final class GnssMeasurementsEvent implements Parcelable { 
    /**

     * Gets the collection of {@link GnssAutomaticGainControl} associated with the

     * current event.

     *

     * <p>This field must be reported when the GNSS measurement engine is running, even when the

     * GnssMeasurement or GnssClock fields are not reported yet. E.g., when a GNSS signal is too

     * weak to be acquired, the AGC value must still be reported.

     *

     * <p>For devices that do not support this field, an empty collection is returned. In that case,

     * please use {@link GnssMeasurement#hasAutomaticGainControlLevelDb()}

     * and {@link GnssMeasuremen#getAutomaticGainControlLevelDb()}.

     */

    @NonNull

    public Collection<GnssAutomaticGainControl> getGnssAutomaticGainControls() {