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

Commit 74ecd8a5 authored by Hayden Gomes's avatar Hayden Gomes
Browse files

Define Auto coordinate system for mics 

For automotive form factors, the origin point for positioning is
different than that of mobile devices. Updating microphone
position javadocs to clarify the two systems.

Bug: 159923715
Test: spell check & make
Change-Id: I90926239e0ba7c3ef1e500d75e01ed6767a4bd6b
parent 2e04dc8e

media/java/android/media/MicrophoneInfo.java

+5 −2
Original line number Diff line number Diff line
@@ -268,8 +268,11 @@ public final class MicrophoneInfo { 


    /**

     * Returns A {@link Coordinate3F} object that represents the geometric location of microphone

     * in meters, from bottom-left-back corner of appliance. X-axis, Y-axis and Z-axis show

     * as the x, y, z values.

     * in meters. X-axis, Y-axis and Z-axis show as the x, y, z values. For mobile devices, the axes

     * originate from the bottom-left-back corner of the appliance. In devices with

     * {@link android.content.pm.PackageManager#FEATURE_AUTOMOTIVE}, axes are defined with respect

     * to the vehicle body frame, originating from the center of the vehicle's rear axle.

     * @see <a href="https://source.android.com/devices/sensors/sensor-types#auto_axes">auto axes</a>

     *

     * @return the geometric location of the microphone or {@link #POSITION_UNKNOWN} if the

     * geometric location is unknown