Android 音頻Android Audio

02/28/2018

本文內(nèi)容

Android OS 為多媒體提供了廣泛的支持，包括音頻和視頻。本指南重點(diǎn)介紹 Android 中的音頻，并介紹如何使用內(nèi)置的音頻播放器和錄像機(jī)類以及低級(jí)音頻 API 播放和錄制音頻。還介紹了如何使用其他應(yīng)用程序廣播的音頻事件，使開發(fā)人員能夠構(gòu)建表現(xiàn)良好的應(yīng)用程序。The Android OS provides extensive support for multimedia, encompassing both audio and video. This guide focuses on audio in Android and covers playing and recording audio using the built-in audio player and recorder classes, as well as the low-level audio API. It also covers working with Audio events broadcast by other applications, so that developers can build well-behaved applications.

概述Overview

現(xiàn)代移動(dòng)設(shè)備采用了以前需要的設(shè)備 – 相機(jī)、音樂播放機(jī)和錄像機(jī)等專用功能。Modern mobile devices have adopted functionality that formerly would have required dedicated pieces of equipment – cameras, music players and video recorders. 因此，多媒體框架已成為移動(dòng) Api 中的一流功能。Because of this, multimedia frameworks have become a first-class feature in mobile APIs.

Android 為多媒體提供廣泛支持。Android provides extensive support for multimedia. 本文介紹如何在 Android 中使用音頻，并介紹了以下主題This article examines working with audio in Android, and covers the following topics

通過 MediaPlayer – 播放音頻使用內(nèi)置 MediaPlayer 類播放音頻，包括本地音頻文件和具有類的流音頻文件 AudioTrack 。Playing Audio with MediaPlayer – Using the built-in MediaPlayer class to play audio, including local audio files and streamed audio files with the AudioTrack class.

錄制音頻 – 使用內(nèi)置 MediaRecorder 類記錄音頻。Recording Audio – Using the built-in MediaRecorder class to record audio.

使用音頻通知 –使用音頻通知來創(chuàng)建正常運(yùn)行的應(yīng)用程序，這些應(yīng)用程序可正確響應(yīng)事件 (如通過掛起或取消其音頻輸出) 的傳入電話呼叫。Working with Audio Notifications – Using audio notifications to create well-behaved applications that respond correctly to events (such as incoming phone calls) by suspending or canceling their audio outputs.

使用低級(jí)別音頻 –AudioTrack通過直接寫入內(nèi)存緩沖區(qū)來使用類播放音頻。Working with Low-Level Audio – Playing audio using the AudioTrack class by writing directly to memory buffers. 使用類記錄音頻 AudioRecord 并直接從內(nèi)存緩沖區(qū)讀取。Recording audio using the AudioRecord class and reading directly from memory buffers.

要求Requirements

本指南需要 Android 2.0 (API 級(jí)別 5) 或更高版本。This guide requires Android 2.0 (API level 5) or higher. 請(qǐng)注意，必須在設(shè)備上進(jìn)行調(diào)試音頻。Please note that debugging audio on Android must be done on a device.

需要 RECORD_AUDIO 在 AndroidManifest.XML中請(qǐng)求權(quán)限：It is necessary to request the RECORD_AUDIO permissions in AndroidManifest.XML:

用 MediaPlayer 類播放音頻Playing Audio with the MediaPlayer Class

在 Android 中播放音頻的最簡(jiǎn)單方法是采用內(nèi)置的 MediaPlayer 類。The simplest way to play audio in Android is with the built-in MediaPlayer class.

MediaPlayer 可以通過傳入文件路徑來播放本地文件或遠(yuǎn)程文件。MediaPlayer can play either local or remote files by passing in the file path. 但是， MediaPlayer 非常區(qū)分狀態(tài)，并且在錯(cuò)誤的狀態(tài)下調(diào)用其方法之一將導(dǎo)致引發(fā)異常。However, MediaPlayer is very state-sensitive and calling one of its methods in the wrong state will cause an exception to be thrown. 按照 MediaPlayer 下面所述的順序進(jìn)行交互很重要，以免出現(xiàn)錯(cuò)誤。It's important to interact with MediaPlayer in the order described below to avoid errors.

正在初始化和播放Initializing and Playing

播放音頻時(shí) MediaPlayer 需要以下順序：Playing audio with MediaPlayer requires the following sequence:

Instantiate a new MediaPlayer object.

將文件配置為通過 SetDataSource 方法播放。Configure the file to play via the SetDataSource method.

調(diào)用 Prepare 方法來初始化播放器。Call the Prepare method to initialize the player.

調(diào)用 start 方法開始播放音頻。Call the Start method to start the audio playing.

下面的代碼示例演示了這種用法：The code sample below illustrates this usage:

protected MediaPlayer player;

public void StartPlayer(String filePath)

{

if (player == null) {

player = new MediaPlayer();

} else {

player.Reset();

player.SetDataSource(filePath);

player.Prepare();

player.Start();

}

}

掛起和繼續(xù)播放Suspending and Resuming Playback

可以通過調(diào)用 Pause 方法來掛起播放：The playback can be suspended by calling the Pause method:

player.Pause();

若要恢復(fù)暫停播放，請(qǐng)調(diào)用 Start 方法。To resume paused playback, call the Start method.

這將從播放中的暫停位置繼續(xù)：This will resume from the paused location in the playback:

player.Start();

在播放機(jī)上調(diào)用 Stop 方法會(huì)結(jié)束正在進(jìn)行的播放：Calling the Stop method on the player ends an ongoing playback:

player.Stop();

當(dāng)不再需要播放機(jī)時(shí)，必須通過調(diào)用 Release 方法釋放資源：When the player is no longer needed, the resources must be released by calling the Release method:

player.Release();

使用 MediaRecorder 類錄制音頻Using the MediaRecorder Class to Record Audio

MediaPlayer用于在 Android 中錄制音頻的必然結(jié)果是MediaRecorder類。The corollary to MediaPlayer for recording audio in Android is the MediaRecorder class. 與類似 MediaPlayer ，它是區(qū)分狀態(tài)的，并通過多個(gè)狀態(tài)進(jìn)行轉(zhuǎn)換，使之能夠開始記錄。Like the MediaPlayer, it is state-sensitive and transitions through several states to get to the point where it can start recording. 若要錄制音頻， RECORD_AUDIO 必須設(shè)置權(quán)限。In order to record audio, the RECORD_AUDIO permission must be set. 有關(guān)如何設(shè)置應(yīng)用程序權(quán)限的說明，請(qǐng)參閱使用 AndroidManifest.xml。For instructions on how to set application permissions see Working with AndroidManifest.xml.

初始化和記錄Initializing and Recording

錄制音頻時(shí) MediaRecorder 需要執(zhí)行以下步驟：Recording audio with the MediaRecorder requires the following steps:

Instantiate a new MediaRecorder object.

指定要使用哪些硬件設(shè)備通過 SetAudioSource 方法捕獲音頻輸入。Specify which hardware device to use to capture the audio input via the SetAudioSource method.

使用 SetOutputFormat 方法設(shè)置輸出文件音頻格式。Set the output file audio format using the SetOutputFormat method. 有關(guān)支持的音頻類型的列表，請(qǐng)參閱 Android 支持的媒體格式。For a list of supported audio types see Android Supported Media Formats.

Call the SetAudioEncoder method to set the audio encoding type.

調(diào)用 SetOutputFile 方法以指定寫入音頻數(shù)據(jù)的輸出文件的名稱。Call the SetOutputFile method to specify the name of the output file that the audio data is written to.

調(diào)用 Prepare 方法以初始化記錄器。Call the Prepare method to initialize the recorder.

調(diào)用 start 方法開始記錄。Call the Start method to start recording.

下面的代碼示例演示了此順序：The following code sample illustrates this sequence:

protected MediaRecorder recorder;

void RecordAudio (String filePath)

{

try {

if (File.Exists (filePath)) {

File.Delete (filePath);

}

if (recorder == null) {

recorder = new MediaRecorder (); // Initial state.

} else {

recorder.Reset ();

recorder.SetAudioSource (AudioSource.Mic);

recorder.SetOutputFormat (OutputFormat.ThreeGpp);

recorder.SetAudioEncoder (AudioEncoder.AmrNb);

// Initialized state.

recorder.SetOutputFile (filePath);

// DataSourceConfigured state.

recorder.Prepare (); // Prepared state

recorder.Start (); // Recording state.

}

} catch (Exception ex) {

Console.Out.WriteLine( ex.StackTrace);

}

}

正在停止錄制Stopping recording

若要停止錄制，請(qǐng)對(duì) Stop MediaRecorder 執(zhí)行以下操作：To stop the recording, call the Stop method on the MediaRecorder:

recorder.Stop();

清理Cleaning up

停止后 MediaRecorder ，調(diào)用 Reset 方法，使其重新進(jìn)入其空閑狀態(tài)：Once the MediaRecorder has been stopped, call the Reset method to put it back into its idle state:

recorder.Reset();

當(dāng) MediaRecorder 不再需要時(shí)，必須通過調(diào)用 Release 方法釋放其資源：When the MediaRecorder is no longer needed, its resources must be released by calling the Release method:

recorder.Release();

管理音頻通知Managing Audio Notifications

AudioManager 類The AudioManager Class

AudioManager類提供對(duì)音頻通知的訪問，使應(yīng)用程序能夠了解音頻事件發(fā)生的時(shí)間。The AudioManager class provides access to audio notifications that let applications know when audio events occur. 此服務(wù)還提供對(duì)其他音頻功能(如音量和鈴聲模式控制)的訪問。This service also provides access to other audio features, such as volume and ringer mode control. AudioManager允許應(yīng)用程序處理音頻通知以控制音頻播放。The AudioManager allows an application to handle audio notifications to control audio playback.

管理音頻焦點(diǎn)Managing Audio Focus

設(shè)備的音頻資源 (內(nèi)置播放機(jī)和錄像機(jī)) 由所有正在運(yùn)行的應(yīng)用程序共享。The audio resources of the device (the built-in player and recorder) are shared by all running applications.

從概念上講，這類似于臺(tái)式計(jì)算機(jī)上只有一個(gè)應(yīng)用程序具有鍵盤焦點(diǎn)的應(yīng)用程序：在通過鼠標(biāo)單擊其中一個(gè)正在運(yùn)行的應(yīng)用程序選擇一個(gè)運(yùn)行的應(yīng)用程序后，鍵盤輸入只會(huì)轉(zhuǎn)到該應(yīng)用程序。Conceptually, this is similar to applications on a desktop computer where only one application has the keyboard focus: after selecting one of the running applications by mouse-clicking it, the keyboard input goes only to that application.

音頻焦點(diǎn)與此類似，可防止多個(gè)應(yīng)用程序同時(shí)播放或錄制音頻。Audio focus is a similar idea and prevents more than one application from playing or recording audio at the same time. 它比鍵盤焦點(diǎn)更復(fù)雜，因?yàn)樗亲栽?– 的，應(yīng)用程序可以忽略它當(dāng)前沒有音頻焦點(diǎn)，而不考慮 – 和，因?yàn)橛胁煌愋偷囊纛l焦點(diǎn)可以請(qǐng)求。It is more complicated than keyboard focus because it is voluntary – the application can ignore that fact that it does not currently have audio focus and play regardless – and because there are different types of audio focus that can be requested. 例如，如果請(qǐng)求者只需播放音頻一小段時(shí)間，則可能會(huì)請(qǐng)求暫時(shí)性的焦點(diǎn)。For example, if the requestor is only expected to play audio for a very short time, it may request transient focus.

可能會(huì)立即授予音頻焦點(diǎn)，或最初拒絕音頻焦點(diǎn)，稍后將其授予。Audio focus may be granted immediately, or initially denied and granted later. 例如，如果某個(gè)應(yīng)用程序在電話呼叫期間請(qǐng)求音頻焦點(diǎn)，則它將被拒絕，但在電話呼叫完成后，就可以獲得焦點(diǎn)。For example, if an application requests audio focus during a phone call, it will be denied, but focus may well be granted once the phone call is finished. 在這種情況下，將注冊(cè)偵聽器以便在音頻焦點(diǎn)消失時(shí)進(jìn)行相應(yīng)的響應(yīng)。In this case, a listener is registered in order to respond accordingly if audio focus is taken away. 請(qǐng)求音頻焦點(diǎn)用于確定是否可以播放或錄制音頻。Requesting audio focus is used to determine whether or not it is OK to play or record audio.

有關(guān)音頻焦點(diǎn)的詳細(xì)信息，請(qǐng)參閱 管理音頻焦點(diǎn)。For more information about audio focus, see Managing Audio Focus.

為音頻焦點(diǎn)注冊(cè)回調(diào)Registering the Callback for Audio Focus

從注冊(cè) FocusChangeListener 回調(diào) IOnAudioChangeListener 是獲取和釋放音頻焦點(diǎn)的重要部分。Registering the FocusChangeListener callback from the IOnAudioChangeListener is an important part of obtaining and releasing audio focus. 這是因?yàn)?#xff0c;對(duì)音頻焦點(diǎn)的授予可能會(huì)推遲到稍后的時(shí)間。This is because the granting of audio focus may be deferred until a later time. 例如，應(yīng)用程序可能會(huì)請(qǐng)求在有電話呼叫時(shí)播放音樂。For example, an application may request to play music while there is a phone call in progress. 電話呼叫結(jié)束之前，將不會(huì)授予音頻焦點(diǎn)。Audio focus will not be granted until the phone call is finished.

出于此原因，回調(diào)對(duì)象將作為參數(shù)傳遞到 GetAudioFocus 的方法 AudioManager 中，這是注冊(cè)回調(diào)的此調(diào)用。For this reason, the callback object is passed as a parameter into the GetAudioFocus method of the AudioManager, and it is this call that registers the callback. 如果最初拒絕音頻焦點(diǎn)，但后來卻被授予，則會(huì)通過調(diào)用回調(diào)來通知應(yīng)用程序 OnAudioFocusChange 。If audio focus is initially denied but later granted, the application is informed by invoking OnAudioFocusChange on the callback. 使用相同的方法來告知應(yīng)用程序音頻焦點(diǎn)已消失。The same method is used to tell the application that audio focus is being taken away.

當(dāng)應(yīng)用程序使用完音頻資源后，它將調(diào)用的 AbandonFocus 方法 AudioManager ，并再次傳入回調(diào)。When the application has finished using the audio resources, it calls the AbandonFocus method of the AudioManager, and again passes in the callback. 這會(huì)注銷回調(diào)并釋放音頻資源，以便其他應(yīng)用程序可以獲得音頻焦點(diǎn)。This deregisters the callback and releases the audio resources, so that other applications may obtain audio focus.

請(qǐng)求音頻焦點(diǎn)Requesting Audio Focus

請(qǐng)求設(shè)備的音頻資源所需的步驟如下所示：The steps required to request the audio resources of the device are as follow:

獲取系統(tǒng)服務(wù)的句柄 AudioManager 。Obtain a handle to the AudioManager system service.

創(chuàng)建回調(diào)類的實(shí)例。Create an instance of the callback class.

通過對(duì)調(diào)用方法來請(qǐng)求設(shè)備的音頻資源 RequestAudioFocus AudioManager 。Request the audio resources of the device by calling the RequestAudioFocus method on the AudioManager . 參數(shù)是回調(diào)對(duì)象、流類型 (音樂、語音呼叫、振鈴等 ) 和請(qǐng)求的訪問權(quán)限的類型 (音頻資源可以暫時(shí)請(qǐng)求或無限期(例如) )。The parameters are the callback object, the stream type (music, voice call, ring etc.) and the type of the access right being requested (the audio resources can be requested momentarily or for an indefinite period, for example).

如果授予了該請(qǐng)求，則 playMusic 會(huì)立即調(diào)用方法，并且音頻開始播放。If the request is granted, the playMusic method is invoked immediately, and the audio starts to play back.

如果拒絕請(qǐng)求，則不執(zhí)行其他操作。If the request is denied, no further action is taken. 在這種情況下，僅當(dāng)稍后授予請(qǐng)求時(shí)，才會(huì)播放音頻。In this case, the audio will only play if the request is granted at a later time.

下面的代碼示例顯示了以下步驟：The code sample below shows these steps:

Boolean RequestAudioResources(INotificationReceiver parent)

{

AudioManager audioMan = (AudioManager) GetSystemService(Context.AudioService);

AudioManager.IOnAudioFocusChangeListener listener = new MyAudioListener(this);

var ret = audioMan.RequestAudioFocus (listener, Stream.Music, AudioFocus.Gain );

if (ret == AudioFocusRequest.Granted) {

playMusic();

return (true);

} else if (ret == AudioFocusRequest.Failed) {

return (false);

}

return (false);

}

正在釋放音頻焦點(diǎn)Releasing Audio Focus

播放跟蹤完成后，將 AbandonFocus 調(diào)用上的方法 AudioManager 。When the playback of the track is complete, the AbandonFocus method on AudioManager is invoked. 這允許其他應(yīng)用程序獲取設(shè)備的音頻資源。This allows another application to gain the audio resources of the device. 如果其他應(yīng)用程序已注冊(cè)自己的偵聽器，則這些應(yīng)用程序?qū)⑹盏酱艘纛l焦點(diǎn)更改的通知。Other applications will receive a notification of this audio focus change if they have registered their own listeners.

低級(jí)別音頻 APILow Level Audio API

低級(jí)別音頻 Api 可以更好地控制音頻播放和錄制，因?yàn)樗鼈冎苯优c內(nèi)存緩沖區(qū)交互，而不是使用文件 Uri。The low-level audio APIs provide a greater control over audio playing and recording because they interact directly with memory buffers instead of using file URIs. 在某些情況下，這種方法更可取。There are some scenarios where this approach is preferable. 這些情況包括：Such scenarios include:

從加密的音頻文件播放時(shí)。When playing from encrypted audio files.

播放連續(xù)的短剪輯時(shí)。When playing a succession of short clips.

音頻流式處理。Audio streaming.

AudioTrack 類AudioTrack Class

AudioTrack類使用低級(jí)別音頻 api 進(jìn)行記錄，并且是類的低級(jí)別等效項(xiàng) MediaPlayer 。The AudioTrack class uses the low-level audio APIs for recording, and is the low-level equivalent of the MediaPlayer class.

正在初始化和播放Initializing and Playing

若要播放音頻， AudioTrack 必須實(shí)例化的新實(shí)例。To play audio, a new instance of AudioTrack must be instantiated. 傳入 構(gòu)造函數(shù) 的參數(shù)列表指定如何播放緩沖區(qū)中包含的音頻示例。The argument list passed into the constructor specifies how to play the audio sample contained in the buffer. 參數(shù)包括：The arguments are:

流類型 – 語音、鈴聲、音樂、系統(tǒng)或警報(bào)。Stream type – Voice, ringtone, music, system or alarm.

–以 Hz 表示的采樣速率的頻率。Frequency – The sampling rate expressed in Hz.

通道配置 – Mono 或立體聲。Channel Configuration – Mono or stereo.

–8 位或16位編碼的音頻格式。Audio format – 8 bit or 16 bit encoding.

緩沖區(qū)大小 – (以字節(jié)為單位)。Buffer size – in bytes.

緩沖區(qū)模式 – 流式處理或靜態(tài)。Buffer mode – streaming or static.

構(gòu)造后，將調(diào)用的 播放 方法 AudioTrack ，將其設(shè)置為開始播放。After construction, the Play method of AudioTrack is invoked, to set it up to start playing. 將音頻緩沖區(qū)寫入到 AudioTrack 開始播放：Writing the audio buffer to the AudioTrack starts the playback:

void PlayAudioTrack(byte[] audioBuffer)

{

AudioTrack audioTrack = new AudioTrack(

// Stream type

Stream.Music,

// Frequency

11025,

// Mono or stereo

ChannelOut.Mono,

// Audio encoding

Android.Media.Encoding.Pcm16bit,

// Length of the audio clip.

audioBuffer.Length,

// Mode. Stream or static.

AudioTrackMode.Stream);

audioTrack.Play();

audioTrack.Write(audioBuffer, 0, audioBuffer.Length);

}

暫停和停止播放Pausing and Stopping the Playback

調(diào)用 pause 方法以暫停播放：Call the Pause method to pause the playback:

audioTrack.Pause();

調(diào)用 Stop 方法將永久終止播放：Calling the Stop method will terminate the playback permanently:

audioTrack.Stop();

清理Cleanup

當(dāng) AudioTrack 不再需要時(shí)，必須通過調(diào)用 Release釋放其資源：When the AudioTrack is no longer needed, its resources must be released by calling Release:

audioTrack.Release();

AudioRecord 類The AudioRecord Class

AudioRecord類等效于 AudioTrack 錄制端。The AudioRecord class is the equivalent of AudioTrack on the recording side. 與類似 AudioTrack ，它會(huì)直接使用內(nèi)存緩沖區(qū)來代替文件和 uri。Like AudioTrack, it uses memory buffers directly, in place of files and URIs. 它要求 RECORD_AUDIO 在清單中設(shè)置權(quán)限。It requires that the RECORD_AUDIO permission be set in the manifest.

初始化和記錄Initializing and Recording

第一步是構(gòu)造一個(gè)新的 AudioRecord 對(duì)象。The first step is to construct a new AudioRecord object. 傳入 構(gòu)造函數(shù) 的參數(shù)列表提供記錄所需的所有信息。The argument list passed into the constructor provides all the information required for recording. 與中不同 AudioTrack ，其中的參數(shù)是很大程度的枚舉，中的等效參數(shù) AudioRecord 是整數(shù)。Unlike in AudioTrack, where the arguments are largely enumerations, the equivalent arguments in AudioRecord are integers. 其中包括：These include:

硬件音頻輸入源，如麥克風(fēng)。Hardware audio input source such as microphone.

流類型 – 語音、鈴聲、音樂、系統(tǒng)或警報(bào)。Stream type – Voice, ringtone, music, system or alarm.

–以 Hz 表示的采樣速率的頻率。Frequency – The sampling rate expressed in Hz.

通道配置 – Mono 或立體聲。Channel Configuration – Mono or stereo.

–8 位或16位編碼的音頻格式。Audio format – 8 bit or 16 bit encoding.

緩沖區(qū)大小(以字節(jié)為單位)Buffer size-in bytes

構(gòu)造后 AudioRecord ，將調(diào)用其 StartRecording 方法。Once the AudioRecord is constructed, its StartRecording method is invoked. 現(xiàn)在可以開始錄制了。It is now ready to begin recording. AudioRecord持續(xù)讀取音頻緩沖區(qū)的輸入，并將此輸入寫入音頻文件。The AudioRecord continuously reads the audio buffer for input, and writes this input out to an audio file.

void RecordAudio()

{

byte[] audioBuffer = new byte[100000];

var audRecorder = new AudioRecord(

// Hardware source of recording.

AudioSource.Mic,

// Frequency

11025,

// Mono or stereo

ChannelIn.Mono,

// Audio encoding

Android.Media.Encoding.Pcm16bit,

// Length of the audio clip.

audioBuffer.Length

);

audRecorder.StartRecording();

while (true) {

try

{

// Keep reading the buffer while there is audio input.

audRecorder.Read(audioBuffer, 0, audioBuffer.Length);

// Write out the audio file.

} catch (Exception ex) {

Console.Out.WriteLine(ex.Message);

break;

}

}

}

正在停止記錄Stopping the Recording

調(diào)用 Stop 方法會(huì)終止記錄：Calling the Stop method terminates the recording:

audRecorder.Stop();

清理Cleanup

當(dāng) AudioRecord 不再需要對(duì)象時(shí)，調(diào)用其 Release 方法會(huì)釋放與其關(guān)聯(lián)的所有資源：When the AudioRecord object is no longer needed, calling its Release method releases all resources associated with it:

audRecorder.Release();

總結(jié)Summary

Android OS 提供了一個(gè)功能強(qiáng)大的框架，用于播放、記錄和管理音頻。The Android OS provides a powerful framework for playing, recording and managing audio. 本文介紹如何使用高級(jí)和類播放和錄制音頻 MediaPlayer MediaRecorder 。This article covered how to play and record audio using the high-level MediaPlayer and MediaRecorder classes. 接下來，它探討了如何使用音頻通知在不同應(yīng)用程序之間共享設(shè)備的音頻資源。Next, it explored how to use audio notifications to share the audio resources of the device between different applications. 最后，它介紹了如何使用低級(jí)別 Api 播放和錄制音頻，后者直接與內(nèi)存緩沖區(qū)交互。Finally, it dealt with how to playback and record audio using the low-level APIs, which interface directly with memory buffers.

相關(guān)鏈接Related Links

總結(jié)

以上是生活随笔為你收集整理的android 音频设备类型,Android 音频的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。