Audio and Video

The Android platform offers built-in encoding/decoding for a variety of common media types, so that you can easily integrate audio, video, and images into your applications. Accessing the platform's media capabilities is fairly straightforward you do so using the same intents and activities mechanism that the rest of Android uses.

Android lets you play audio and video from several types of data sources. You can play audio or video from media files stored in the application's resources (raw resources), from standalone files in the filesystem, or from a data stream arriving over a network connection. To play audio or video from your application, use the MediaPlayer class.

The platform also lets you record audio and video, where supported by the mobile device hardware. To record audio or video, use the MediaRecorder class. Note that the emulator doesn't have hardware to capture audio or video, but actual mobile devices are likely to provide these capabilities, accessible through the MediaRecorder class.

For a list of media formats for which Android offers built-in support, see the Android Media Formats appendix.

Audio and Video Playback

Media can be played from anywhere: from a raw resource, from a file from the system, or from an available network (URL).

You can play back the audio data only to the standard output device; currently, that is the mobile device speaker or Bluetooth headset. You cannot play sound files in the conversation audio.

Playing from a Raw Resource

Perhaps the most common thing to want to do is play back media (notably sound) within your own applications. Doing this is easy:

1. Put the sound (or other media resource) file into the res/raw folder of your project, where the Eclipse plugin (or aapt) will find it and make it into a resource that can be referenced from your R class
2. Create an instance of MediaPlayer, referencing that resource using MediaPlayer.create, and then call start() on the instance:

사운드(또는 다른 미디어 리소스) 파일을 여러분의 프로젝트의 res/raw 폴더에 넣어라. 이클립스 플러그인(또는 aapt)은 그곳에 있는 파일을 찾아서 그 파일이 여러분의 R 클래스에서 레퍼런스될 수 있는 리소스가 되게 한다.
MediaPlayer.create()를 사용해서 리소스를 레퍼런스하는 미디어플레이어MediaPlayer 인스턴스를 생성하라. 그런 다음에 그 인스턴스에 대한 start()를 호출하라.

    MediaPlayer mp = MediaPlayer.create(context, R.raw.sound_file_1);
    mp.start();

To stop playback, call stop(). If you wish to later replay the media, then you must reset() and prepare() the MediaPlayer object before calling start() again. (create() calls prepare() the first time.)

To pause playback, call pause(). Resume playback from where you paused with start().

Playing from a File or Stream

You can play back media files from the filesystem or a web URL:

1. Create an instance of the MediaPlayer using new
2. Call setDataSource() with a String containing the path (local filesystem or URL) to the file you want to play
3. First prepare() then start() on the instance:

new를 사용하여 미디어플레이어(MediaPlayer) 인스턴스를 생성하라.
재생하고자 하는 파일의 경로(로컬 파일시스템 또는 URL)을 포함하고 있는 문자열을 가지는 setDataSource()를 호출하라.
먼저 prepare()를 하고, 그런 다음에 그 인스턴스에 대한 start()를 하라.

    MediaPlayer mp = new MediaPlayer();
    mp.setDataSource(PATH_TO_FILE);
    mp.prepare();
    mp.start();

stop() and pause() work the same as discussed above.

Note: It is possible that mp could be null, so good code should null check after the new. Also, IllegalArgumentException and IOException either need to be caught or passed on when using setDataSource(), since the file you are referencing may not exist.

Note: If you're passing a URL to an online media file, the file must be capable of progressive download.

Playing JET content

The Android platform includes a JET engine that lets you add interactive playback of JET audio content in your applications. You can create JET content for interactive playback using the JetCreator authoring application that ships with the SDK. To play and manage JET content from your application, use the JetPlayer class.

For a description of JET concepts and instructions on how to use the JetCreator authoring tool, see the JetCreator User Manual. The tool is available fully-featured on the OS X and Windows platforms and the Linux version supports all the content creation features, but not the auditioning of the imported assets.

Here's an example of how to set up JET playback from a .jet file stored on the SD card:

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();

The SDK includes an example application JetBoy that shows how to use JetPlayer to create an interactive music soundtrack in your game. It also illustrates how to use JET events to synchronize music and game logic. The application is located at <sdk>/platforms/android-1.5/samples/JetBoy.

Audio Capture

Audio capture from the device is a bit more complicated than audio/video playback, but still fairly simple:

1. Create a new instance of android.media.MediaRecorder using new
2. Create a new instance of android.content.ContentValues and put in some standard properties like TITLE, TIMESTAMP, and the all important MIME_TYPE
3. Create a file path for the data to go to (you can use android.content.ContentResolver to create an entry in the Content database and get it to assign a path automatically which you can then use)
4. Set the audio source using MediaRecorder.setAudioSource(). You will probably want to use MediaRecorder.AudioSource.MIC
5. Set output file format using MediaRecorder.setOutputFormat()
6. Set the audio encoder using MediaRecorder.setAudioEncoder()
7. Call prepare() on the MediaRecorder instance.
8. To start audio capture, call start().
9. To stop audio capture, call stop().
10. When you are done with the MediaRecorder instance, call release() on it.

new를 사용하여 android.media.MediaRecorder의 새로운 인스턴스를 생성하라.
android.content.ContentValues의 새로운 인스턴스를 생성하고, TITLE, TIMESTAMP, 그리고 모든 중요한 MIME_TYPE과 같은 몇 가지 표준 속성들을 채워라.
보내야 하는 데이터에 대한 파일 경로를 생성하라 (여러분은 컨텐트 데이터베이스안에 엔트리를 만들기 위해 android.content.ContentResolver를 사용할 수 있으며, 다음에 여러분이 사용할 수 있는 경로를 자동으로 지정하기 위해 그것을 얻을 수 있다).
MediaRecorder.setAudioSource()를 사용해서 오디오 소스를 설정하라. 여러분은 아마도 MediaRecorder.AudioSource.MIC 를 사용하고자 할 것이다.
MediaRecorder.setOutputFormat()를 사용해서 출력 파일 포맷을 설정하라.
MediaRecorder.setAudioEncoder()를 사용해서 오디오 인코더를 설정하라.
MediaRecorder 인스턴스에 대한 prepare()를 호출하라.
오디오 캡쳐를 시작하기 위해서는 start()를 호출하라.
오디오 캡쳐를 멈추기 위해서는 stop()을 호출하라.
여러분이 MediaRecorder 인스턴스를 사용했다면, 그것에 release()를 호출하라.

Example: Audio Capture Setup and Start

The example below illustrates how to set up, then start audio capture.

    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();

Stop Recording

Based on the example above, here's how you would stop audio capture.

    recorder.stop();
    recorder.release();