Add recommendation to use MediaActionSound class in a background thread since it

relies on binder.

Bug: 213174684
Test: N/A as it's a comment update
Change-Id: I01ddc0402bd27d19b2e9e7606ad327da703e8aaa
This commit is contained in:
Raymond Tiong
2022-03-14 19:57:21 +00:00
parent adf939b3d3
commit 8c06d5e257

View File

@@ -25,7 +25,8 @@ import android.util.Log;
/**
* <p>A class for producing sounds that match those produced by various actions
* taken by the media and camera APIs. </p>
* taken by the media and camera APIs. It is recommended to call methods in this class
* in a background thread since it relies on binder calls.</p>
*
* <p>This class is recommended for use with the {@link android.hardware.camera2} API, since the
* camera2 API does not play any sounds on its own for any capture or video recording actions.</p>
@@ -109,7 +110,7 @@ public class MediaActionSound {
/**
* <p>Returns true if the application must play the shutter sound in accordance
* to certain regional restrictions. </p>
* to certain regional restrictions.</p>
*
* <p>If this method returns true, applications are strongly recommended to use
* MediaActionSound.play(SHUTTER_CLICK) or START_VIDEO_RECORDING whenever it captures