public class MediaActionSound
extends Object
| java.lang.Object | |
| android.media.MediaActionSound | |
用于制作与媒体和相机API采取的各种动作相匹配的声音的课程。
建议将 android.hardware.camera2用于 android.hardware.camera2 API，因为camera2 API不会为任何捕获或视频录制操作自行播放任何声音。
使用较旧的 Camera API时，使用此类可以在实现自定义静态或视频录制机制时（例如通过Camera preview回调 Camera.setPreviewCallback或通过GPU处理 Camera.setPreviewTexture ）或在实现其他某些其他方法时播放适当的相机操作声音相机般的功能在你的应用程序中。
对于静止图像或视频分别使用 Camera.takePicture或 MediaRecorder时，无需播放声音，因为Android框架在需要这些呼叫时会播放适当的声音。
常量(Constants) |
|
|---|---|
int |
FOCUS_COMPLETE 表示聚焦已完成的声音。 |
int |
SHUTTER_CLICK
|
int |
START_VIDEO_RECORDING
|
int |
STOP_VIDEO_RECORDING
|
Public constructors |
|
|---|---|
MediaActionSound() 构建一个新的MediaActionSound实例。 |
|
公共方法(Public methods) |
|
|---|---|
void |
load(int soundName) 预先加载预定义的平台声音以尽量减少 |
void |
play(int soundName) 播放媒体操作中预定义的平台声音之一。 |
void |
release() 释放此MediaActionSound实例使用的所有音频资源。 |
继承方法(Inherited methods) |
|
|---|---|
 From class java.lang.Object
|
|
int FOCUS_COMPLETE
表示聚焦已完成的声音。 由于决定何时发生这种情况取决于应用程序，因此媒体或相机API中的任何方法都不会使用此声音。
也可以看看：
常数值：1（0x00000001）
int SHUTTER_CLICK
Camera.takePicture用于指示静止图像捕捉的声音。
也可以看看：
常量值：0（0x00000000）
int START_VIDEO_RECORDING
MediaRecorder.start()用于指示录像开始的声音。
也可以看看：
常量值：2（0x00000002）
int STOP_VIDEO_RECORDING
MediaRecorder.stop()用于指示录像结束的声音。
也可以看看：
常量值：3（0x00000003）
MediaActionSound ()
构建一个新的MediaActionSound实例。 播放任何平台媒体动作声音只需要一个实例; 您不需要为每种声音类型单独实例。
void load (int soundName)
预先载入预定义的平台声音以尽量减少 play(int)播放声音时的等待时间。
| 参数(Parameters) | |
|---|---|
soundName |
int: The type of sound to preload, selected from SHUTTER_CLICK, FOCUS_COMPLETE, START_VIDEO_RECORDING, or STOP_VIDEO_RECORDING. |
void play (int soundName)
播放媒体操作中预定义的平台声音之一。
使用此方法为各种媒体操作播放平台特定的声音。 声音播放是异步完成的，具有相同的行为和内容所发挥的声音Camera.takePicture ， MediaRecorder.start ，并MediaRecorder.stop 。
使用 camera2 API，此方法可用于播放标准的相机操作声音，并具有适合此类声音的适当系统行为。
使用较旧的 Camera API时，使用此方法可以轻松匹配通过预览回调记录或捕获数据时的默认设备声音，或者在应用程序中实现自定义类似照相机的功能时。
如果在调用播放之前声音尚未被 load(int)加载，播放将以声音播放开始之前的一些额外延迟为代价加载声音。
| 参数(Parameters) | |
|---|---|
soundName |
int: The type of sound to play, selected from SHUTTER_CLICK, FOCUS_COMPLETE, START_VIDEO_RECORDING, or STOP_VIDEO_RECORDING. |
void release ()
释放此MediaActionSound实例使用的所有音频资源。 在调用release（）之后，不要在MediaActionSound实例上调用任何其他方法。
Android开发手册