Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Update API doc w/ high-rate permission requirement" into sc-dev

Browse Source
This commit is contained in:
Anh Pham
2021-06-24 06:22:24 +00:00
committed by Android (Google) Code Review
parent 72c30b0aed 629ba4958e
commit 3e244be4e9
2 changed files with 15 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
core/java/android/hardware/Sensor.java
View File

@@ -848,8 +848,10 @@ public final class Sensor {
/** /**
* Get the highest supported direct report mode rate level of the sensor. * Get the highest supported direct report mode rate level of the sensor.
* *
* @return Highest direct report rate level of this sensor. If the sensor does not support * @return Highest direct report rate level of this sensor. Note that if the app does not have
* direct report mode, this returns {@link SensorDirectChannel#RATE_STOP}. * the {@link android.Manifest.permission#HIGH_SAMPLING_RATE_SENSORS} permission, the highest
* direct report rate level is {@link SensorDirectChannel#RATE_NORMAL}. If the sensor
* does not support direct report mode, this returns {@link SensorDirectChannel#RATE_STOP}.
* @see SensorDirectChannel#RATE_STOP * @see SensorDirectChannel#RATE_STOP
* @see SensorDirectChannel#RATE_NORMAL * @see SensorDirectChannel#RATE_NORMAL
* @see SensorDirectChannel#RATE_FAST * @see SensorDirectChannel#RATE_FAST
@@ -1002,9 +1004,11 @@ public final class Sensor {
} }
/** /**
* @return the minimum delay allowed between two events in microsecond * @return the minimum delay allowed between two events in microseconds
* or zero if this sensor only returns a value when the data it's measuring * or zero if this sensor only returns a value when the data it's measuring
* changes. * changes. Note that if the app does not have the
* {@link android.Manifest.permission#HIGH_SAMPLING_RATE_SENSORS} permission, the
* minimum delay is capped at 5000 microseconds (200 Hz).
*/ */
public int getMinDelay() { public int getMinDelay() {
return mMinDelay; return mMinDelay;

7
core/java/android/hardware/SensorManager.java
View File

@@ -46,6 +46,13 @@ import java.util.List;
* at {@link TriggerEventListener}. {@link Sensor#TYPE_SIGNIFICANT_MOTION} * at {@link TriggerEventListener}. {@link Sensor#TYPE_SIGNIFICANT_MOTION}
* is an example of a trigger sensor. * is an example of a trigger sensor.
* </p> * </p>
* <p>
* In order to access sensor data at high sampling rates (i.e. greater than 200 Hz
* for {@link SensorEventListener} and greater than {@link SensorDirectChannel#RATE_NORMAL}
* for {@link SensorDirectChannel}), apps must declare
* the {@link android.Manifest.permission#HIGH_SAMPLING_RATE_SENSORS} permission
* in their AndroidManifest.xml file.
* </p>
* <pre class="prettyprint"> * <pre class="prettyprint">
* public class SensorActivity extends Activity implements SensorEventListener { * public class SensorActivity extends Activity implements SensorEventListener {
* private final SensorManager mSensorManager; * private final SensorManager mSensorManager;