[译]Audio and Video
Android平台对一些常见的媒体格式内置了编解码器。并且应用可以非常简单地访问平台的多媒体功能――you do so using the same intents and activities mechanism that the rest of Android uses.
Android可以让你播放多种音频和视频类型的数据源。你可以播放存放在应用程序raw资源中的多媒体文件，或是放在文件系统中的多媒体文件，或是从网络上读取的数据流。使用MediaPlayer类来播放音频和视频媒体。
在被硬件支持的情况下，Android也可以让你录制音频和视频。录制需要使用MediaRecorder类。注意在模拟器上无法录制。
对于Android提供内置支持的媒体格式，请参阅Android的媒体格式附录。
1. 播放音频和视频
多媒体数据可以从任何地方被播放：播放raw资源中的多媒体资源，也可以播放文件系统中的多媒体文件，还可以通过指定URL播放存放在网络中的多媒体数据。
您可以只向标准输出设备播放音频数据;目前；目前是指移动设备扬声器或蓝牙耳机。你不能在通话中播放音频声音文件。You cannot play sound files in the conversation audio.
1.1 播放raw资源中的多媒体文件
最常见的情况可能是在你自己的应用中播放媒体文件(特别是音频)，这样做非常容易：
1.1.1 将多媒体资源文件放到项目的res/raw目录中，然后eclipse plugin(或aapt)会自动在R类中生成一个代表这个媒体资源文件的索引值。
1.1.2 将代表那个媒体资源文件的索引值传入MediaPlayer.create(Context context, int resid)方法中，得到一个MediaPlayer的实例，然后调用这个MediaPlayer实例的start()方法:
调用MediaPlayer.stop()方法来停止播放。若你希望隔一会载重新播放那个多媒体资源，那么你必须保证在调用MediaPlayer.start()方法之前，调用MediaPlayer.reset()方法和MediaPlayer.Prepare()方法。(MediaPlayer.create()方法内部会调用MediaPlayer.Prepare()方法)。
要暂停播放，调用MediaPlayer.pause()方法，再次调用MediaPlayer.start()方法会从暂停的位置恢复播放。
1.2 播放文件或者流
你也可以播放文件系统中的媒体文件或是一个网络URL代表的媒体流：
1.2.1 利用new操作符创建一个MediaPlayer的实例。
1.2.2 调用MediaPlayer.setDataSource()方法，并传入媒体文件的路径(本地文件系统或者是网络URL)。
1.2.3 调用MediaPlayer.prepare()，然后调用MediaPlayer.start()方法开始播放：
MediaPlayer.stop()和MediaPlayer.pause()方法的功能同前。
注：mp可能为null，所以需要在new操作符后检查mp是否为null。并且在调用MediaPlayer.setDataSource()方法的时候，可能会因为指定的文件不存在而抛出IllegalArgumentException和IOException异常。
注：如果调用MediaPlayer.setDataSource()方法指定一个网络URL，那么由这个网络URL表示的媒体文件必须支持分段下载。
1.3 播放JET内容
Android平台包含了一个JET引擎，这个引擎可以让你在应用中添加JET音频内容的交互式播放。你可以使用附带在SDK中的JetCreator创作程序来创建用于交互播放的JET内容。在程序中播放和管理JET内容需要使用JetPlayer类。
关于JET的概念和使用JetCreator工具的教程，可以查看JetCreator的用户手册。在OS X和Windows系统中此工具的所有功能都是可用的。在Linux中，支持此工具所有的创建功能，但是不支持对导入的资源进行试听。
下边是针对一个存放在SD卡上的.jet文件建立JET播放的示例代码：
该SDK包括一个示例应用程序――JetBoy――这个示例显示了如何在游戏中使用JetPlayer创建交互式的游戏配乐音乐。它还说明了如何使用Jet事件来同步音乐和游戏逻辑。该应用程序位于 <sdk>/ platforms/android-1.5/samples/JetBoy.
2. 音频采集
在设备上进行音频采集比音频/视频的播放要稍微复杂一点，但仍然相当简单：
1）使用new操作符创建一个android.media.MediaRecorder新实例
2）创建一个android.content.ContentValues实例，并且向里面装入标准属性，比如TITLE(标题)，TIMESTAMP(时间戳)，以及所有重要的MIME_TYPE.
3）创建一个录制文件将要保存的路径(你可以使用android.content.ContentResolver在数据库中创建一个条目，and get it to assign a path automatically which you can then use)
4）调用MediaRecorder.setAudioSource()方法来指定音频源。你可能想使用MediaRecorder.AudioSource.MIC.
5）使用MediaRecorder.setOutputFormat()方法设定输出文件的格式。
6）使用MediaRecorder.setAudioEncoder()方法设置音频编码器。
7）调用MediaRecorder.prepare()方法。
8）调用MediaRecorder.start()方法开始进行音频采集。
9）调用MediaRecorder.stop()方法停止音频采集。
10）当不使用这个MediaRecorder实例的时候，调用MediaRecorder.release()方法。
2.1 示例代码：音频采集
2.2 停止录制
基于上边的音频采集的示例代码，以下代码是示例如何停止音频采集：
Android可以让你播放多种音频和视频类型的数据源。你可以播放存放在应用程序raw资源中的多媒体文件，或是放在文件系统中的多媒体文件，或是从网络上读取的数据流。使用MediaPlayer类来播放音频和视频媒体。
在被硬件支持的情况下，Android也可以让你录制音频和视频。录制需要使用MediaRecorder类。注意在模拟器上无法录制。
对于Android提供内置支持的媒体格式，请参阅Android的媒体格式附录。
1. 播放音频和视频
多媒体数据可以从任何地方被播放：播放raw资源中的多媒体资源，也可以播放文件系统中的多媒体文件，还可以通过指定URL播放存放在网络中的多媒体数据。
您可以只向标准输出设备播放音频数据;目前；目前是指移动设备扬声器或蓝牙耳机。你不能在通话中播放音频声音文件。You cannot play sound files in the conversation audio.
1.1 播放raw资源中的多媒体文件
最常见的情况可能是在你自己的应用中播放媒体文件(特别是音频)，这样做非常容易：
1.1.1 将多媒体资源文件放到项目的res/raw目录中，然后eclipse plugin(或aapt)会自动在R类中生成一个代表这个媒体资源文件的索引值。
1.1.2 将代表那个媒体资源文件的索引值传入MediaPlayer.create(Context context, int resid)方法中，得到一个MediaPlayer的实例，然后调用这个MediaPlayer实例的start()方法:
MediaPlayer mp = MediaPlayer.create(context, R.raw.sound_file_1);
mp.start();
调用MediaPlayer.stop()方法来停止播放。若你希望隔一会载重新播放那个多媒体资源，那么你必须保证在调用MediaPlayer.start()方法之前，调用MediaPlayer.reset()方法和MediaPlayer.Prepare()方法。(MediaPlayer.create()方法内部会调用MediaPlayer.Prepare()方法)。
要暂停播放，调用MediaPlayer.pause()方法，再次调用MediaPlayer.start()方法会从暂停的位置恢复播放。
1.2 播放文件或者流
你也可以播放文件系统中的媒体文件或是一个网络URL代表的媒体流：
1.2.1 利用new操作符创建一个MediaPlayer的实例。
1.2.2 调用MediaPlayer.setDataSource()方法，并传入媒体文件的路径(本地文件系统或者是网络URL)。
1.2.3 调用MediaPlayer.prepare()，然后调用MediaPlayer.start()方法开始播放：
MediaPlayer mp = new MediaPlayer();
mp.setDataSource(PATH_TO_FILE); // OR web URL
mp.prepare();
mp.start();
MediaPlayer.stop()和MediaPlayer.pause()方法的功能同前。
注：mp可能为null，所以需要在new操作符后检查mp是否为null。并且在调用MediaPlayer.setDataSource()方法的时候，可能会因为指定的文件不存在而抛出IllegalArgumentException和IOException异常。
注：如果调用MediaPlayer.setDataSource()方法指定一个网络URL，那么由这个网络URL表示的媒体文件必须支持分段下载。
1.3 播放JET内容
Android平台包含了一个JET引擎，这个引擎可以让你在应用中添加JET音频内容的交互式播放。你可以使用附带在SDK中的JetCreator创作程序来创建用于交互播放的JET内容。在程序中播放和管理JET内容需要使用JetPlayer类。
关于JET的概念和使用JetCreator工具的教程，可以查看JetCreator的用户手册。在OS X和Windows系统中此工具的所有功能都是可用的。在Linux中，支持此工具所有的创建功能，但是不支持对导入的资源进行试听。
下边是针对一个存放在SD卡上的.jet文件建立JET播放的示例代码：
JetPlayer myJet = JetPlayer.getJetPlayer();
myJet.loadJetFile("/sdcard/level1.jet");
byte segmentId = 0;
// queue segment 5, repeat once, use General MIDI, transpose by -1 octave
myJet.queueJetSegment(5, -1, 1, -1, 0, segmentId++);
// queue segment 2
myJet.queueJetSegment(2, -1, 0, 0, 0, segmentId++);
myJet.play();
该SDK包括一个示例应用程序――JetBoy――这个示例显示了如何在游戏中使用JetPlayer创建交互式的游戏配乐音乐。它还说明了如何使用Jet事件来同步音乐和游戏逻辑。该应用程序位于 <sdk>/ platforms/android-1.5/samples/JetBoy.
2. 音频采集
在设备上进行音频采集比音频/视频的播放要稍微复杂一点，但仍然相当简单：
1）使用new操作符创建一个android.media.MediaRecorder新实例
2）创建一个android.content.ContentValues实例，并且向里面装入标准属性，比如TITLE(标题)，TIMESTAMP(时间戳)，以及所有重要的MIME_TYPE.
3）创建一个录制文件将要保存的路径(你可以使用android.content.ContentResolver在数据库中创建一个条目，and get it to assign a path automatically which you can then use)
4）调用MediaRecorder.setAudioSource()方法来指定音频源。你可能想使用MediaRecorder.AudioSource.MIC.
5）使用MediaRecorder.setOutputFormat()方法设定输出文件的格式。
6）使用MediaRecorder.setAudioEncoder()方法设置音频编码器。
7）调用MediaRecorder.prepare()方法。
8）调用MediaRecorder.start()方法开始进行音频采集。
9）调用MediaRecorder.stop()方法停止音频采集。
10）当不使用这个MediaRecorder实例的时候，调用MediaRecorder.release()方法。
2.1 示例代码：音频采集
recorder = new MediaRecorder();
ContentValues values = new ContentValues(3);
values.put(MediaStore.MediaColumns.TITLE, SOME_NAME_HERE);
values.put(MediaStore.MediaColumns.TIMESTAMP, System.currentTimeMillis());
values.put(MediaStore.MediaColumns.MIME_TYPE, recorder.getMimeContentType());
ContentResolver contentResolver = new ContentResolver();
Uri base = MediaStore.Audio.INTERNAL_CONTENT_URI;
Uri newUri = contentResolver.insert(base, values);
if (newUri == null) {
// need to handle exception here - we were not able to create a new
// content entry
}
String path = contentResolver.getDataFilePath(newUri);
// could use setPreviewDisplay() to display a preview to suitable View here
recorder.setAudioSource(MediaRecorder.AudioSource.MIC);
recorder.setOutputFormat(MediaRecorder.OutputFormat.THREE_GPP);
recorder.setAudioEncoder(MediaRecorder.AudioEncoder.AMR_NB);
recorder.setOutputFile(path);
recorder.prepare();
recorder.start();
2.2 停止录制
基于上边的音频采集的示例代码，以下代码是示例如何停止音频采集：
recorder.stop();
recorder.release();
