View source for Playing Audio on iOS 8 using AVAudioPlayer

<table border="0" cellspacing="0">
<tr>
<td width="20%">[[iOS 8 Video Playback using AVPlayer and AVPlayerViewController|Previous]]<td align="center">[[iOS 8 App Development Essentials|Table of Contents]]<td width="20%" align="right">[[Recording Audio on iOS 8 with AVAudioRecorder in Swift|Next]]</td>
<tr>
<td width="20%">iOS 8 Video Playback using AVPlayer and AVPlayerViewController<td align="center"><td width="20%" align="right">Recording Audio on iOS 8 with AVAudioRecorder in Swift</td>
</table>
<hr>


<htmlet>ios9_upgrade</htmlet>


The iOS 8 SDK provides a number of mechanisms for implementing audio playback from within an iOS application. The easiest technique from the perspective of the application developer is to use the AVAudioPlayer class which is part of the AV Foundation Framework.

This chapter will provide an overview of audio playback using the AVAudioPlayer class. Once the basics have been covered, a tutorial is worked through step by step. The topic of recording audio from within an iOS application is covered in the next chapter entitled [[Recording Audio on iOS 8 with AVAudioRecorder in Swift]].

== Supported Audio Formats ==

The AV Foundation Framework supports the playback of a variety of different audio formats and codecs including both software and hardware based decoding. Codecs and formats currently supported are as follows:

* AAC (MPEG-4 Advanced Audio Coding)
* ALAC (Apple Lossless)
* AMR (Adaptive Multi-rate)
* HE-AAC (MPEG-4 High Efficiency AAC)
* iLBC (internet Low Bit Rate Codec)
* Linear PCM (uncompressed, linear pulse code modulation)
* MP3 (MPEG-1 audio layer 3)
* µ-law and a-law

If an audio file is to be included as part of the resource bundle for an application it may be converted to a supported audio format prior to inclusion in the application project using the Mac OS X afconvert command-line tool. For details on how to use this tool, run the following command in a Terminal window:

<pre>
afconvert –h
</pre>

== Receiving Playback Notifications ==

An application receives notifications from an AVAudioPlayer instance by declaring itself as the object’s delegate and implementing some or all of the following AVAudioPlayerDelegate protocol methods:

* '''audioPlayerDidFinishPlaying''' – Called when the audio playback finishes. An argument passed through to the method indicates whether the playback completed successfully or failed due to an error.
* '''audioPlayerDecodeErrorDidOccur''' - Called when a decoding error is encountered by the AVAudioPlayer object during audio playback. An error object containing information about the nature of the problem is passed through to this method as an argument.
* '''audioPlayerBeginInterruption''' – Called when audio playback has been interrupted by a system event such as an incoming phone call. Playback is automatically paused and the current audio session deactivated.
* '''audioPlayerEndInterruption''' - Called after an interruption ends. The current audio session is automatically activated and playback may be resumed by calling the play method of the corresponding AVAudioPlayer instance.

== Controlling and Monitoring Playback ==

Once an AVAudioPlayer instance has been created the playback of audio may be controlled and monitored programmatically via the methods and properties of that instance. For example, the self-explanatory play, pause and stop methods may be used to control playback. Similarly, the volume property may be used to adjust the volume level of the audio playback whilst the playing property may be accessed to identify whether or not the AVAudioPlayer object is currently playing audio. 

In addition, playback may be delayed to begin at a later time using the playAtTime instance method which takes as an argument the number of seconds (as an NSTimeInterval value) to delay before beginning playback.

The length of the current audio playback may be obtained via the duration property whilst the current point in the playback is stored in the currentTime property.

Playback may also be programmed to loop back and repeatedly play a specified number of times using the numberOfLoops property.

== Creating the Audio Example Application ==

The remainder of this chapter will work through the creation of a simple iOS 8 application which plays an audio file. The user interface of the application will consist of play and stop buttons to control playback and a slider to adjust the playback volume level.

Begin by launching Xcode and creating a new Universal Single View Application named AudioDemo using the Swift programming language.

== Adding an Audio File to the Project Resources ==

In order to experience audio playback it will be necessary to add an audio file to the project resources. For this purpose, any supported audio format file will be suitable. Having identified a suitable audio file, drag and drop it into the Supporting Files folder of the project navigator panel of the main Xcode window. For the purposes of this tutorial we will be using an MP3 file named Moderato.mp3 which can be found in the audiofiles folder of the sample code archive, downloadable from the following URL:

[http://www.ebookfrenzy.com/web/ios8 http://www.ebookfrenzy.com/web/ios8]

Having downloaded and unzipped the file, locate it in a Finder window and drag and drop it onto the Supporting Files section of the Xcode project navigator panel. 
<htmlet>ios9_upgrade</htmlet>
== Designing the User Interface ==

The application user interface is going to comprise two buttons labeled “Play” and “Stop” and a slider to allow the volume of playback to be adjusted. Select the Main.storyboard file, display the Object Library (View -> Utilities -> Show Object Library), drag and drop components from the Library onto the View window and modify properties so that the interface appears as illustrated in Figure 88-1:
 
<htmlet>adsdaqbox_flow</htmlet>
[[Image:iso_8_audio_demo_ui.png]]

Figure 88-1


With the scene view selected within the storyboard canvas, display the Auto Layout Resolve Auto Layout Issues menu and select the Reset to Suggested Constraints menu option listed in the All Views in View Controller section of the menu.

Select the slider object in the view canvas, display the Assistant Editor panel and verify that the editor is displaying the contents of the ViewController.swift file. Ctrl-click on the slider object and drag to a position just below the class declaration line in the Assistant Editor. Release the line and in the resulting connection dialog establish an outlet connection named volumeControl.

Ctrl-click on the “Play” button object and drag the line to the area immediately beneath the viewDidLoad method in the Assistant Editor panel. Release the line and, within the resulting connection dialog, establish an Action method on the Touch Up Inside event configured to call a method named playAudio. Repeat these steps to establish an action on the “Stop” button to a method named stopAudio.

Ctrl-click on the slider object and drag the line to the area immediately beneath the newly created actions in the Assistant Editor panel. Release the line and, within the resulting connection dialog, establish an Action method on the Value Changed event configured to call a method named adjustVolume.

Close the Assistant Editor panel and select the ViewController.swift file in the project navigator panel and add an import directive and delegate declaration, together with a property to store a reference to the AVAudioPlayer instance as follows:

<pre>
import UIKit
import AVFoundation

class ViewController: UIViewController, AVAudioPlayerDelegate {

    @IBOutlet weak var volumeControl: UISlider!
    var audioPlayer: AVAudioPlayer?
.
.
</pre>

== Implementing the Action Methods ==

The next step in our iOS audio player tutorial is to implement the action methods for the two buttons and the slider. Remaining in the ViewController.swift file, locate and implement these methods as outlined in the following code fragment:

<pre>
@IBAction func playAudio(sender: AnyObject) {
    if let player = audioPlayer {
        player.play()
    }
}

@IBAction func stopAudio(sender: AnyObject) {
    if let player = audioPlayer {
        player.stop()
    }
}

@IBAction func adjustVolume(sender: AnyObject) {
    if audioPlayer != nil {
        audioPlayer?.volume = volumeControl.value
    }
} 
</pre>

== Creating and Initializing the AVAudioPlayer Object ==

Now that we have an audio file to play and appropriate action methods written, the next step is to create an AVAudioPlayer instance and initialize it with a reference to the audio file. Since we only need to initialize the object once when the application launches a good place to write this code is in the viewDidLoad method of the ViewController.swift file:

<pre>
override func viewDidLoad() {
    super.viewDidLoad()
    let url = NSURL.fileURLWithPath(
     		NSBundle.mainBundle().pathForResource("Moderato", 
			ofType: "mp3")!)

    var error: NSError?

    audioPlayer = AVAudioPlayer(contentsOfURL: url, error: &error)

    if let err = error {
        println("audioPlayer error \(err.localizedDescription)")
    } else {
        audioPlayer?.delegate = self
        audioPlayer?.prepareToPlay()
    }
}
</pre>

In the above code we create an NSURL reference using the filename and type of the audio file added to the project resources. Keep in mind that this will need to be modified to reflect the audio file used in your own projects.

Next, an AVAudioPlayer instance is created using the URL of the audio file. Assuming no errors were detected, the current class is designated as the delegate for the audio player object. Finally, a call is made to the audioPlayer object’s prepareToPlay method. This performs initial buffering tasks so that there is no buffering delay when the play button is subsequently selected by the user.

== Implementing the AVAudioPlayerDelegate Protocol Methods ==

As previously discussed, by declaring our view controller as the delegate for our AVAudioPlayer instance our application will be able to receive notifications relating to the playback. Templates of these methods are as follows and may be placed in the ViewController.swift file:

<pre>
func audioPlayerDidFinishPlaying(player: AVAudioPlayer!, successfully 
		flag: Bool) {
}

func audioPlayerDecodeErrorDidOccur(player: AVAudioPlayer!, 
		error: NSError!) {
}

func audioPlayerBeginInterruption(player: AVAudioPlayer!) {
}

func audioPlayerEndInterruption(player: AVAudioPlayer!) {
}
</pre>

For the purposes of this tutorial it is not necessary to implement any code for these methods and they are provided solely for completeness.

== Building and Running the Application ==

Once all the requisite changes have been made and saved, test the application in the iOS simulator or a physical device by clicking on the run button located in the Xcode toolbar. Once the application appears, click on the Play button to begin playback. Adjust the volume using the slider and stop playback using the Stop button. If the playback is not audible on the device, make sure that the switch on the side of the device is not set to silent mode.

== Summary ==

The AVAudioPlayer class, which is part of the AVFoundation framework, provides a simple way to play audio from within iOS applications. In addition to playing back audio, the class also provides a number of methods that can be used to control the playback in terms of starting, stopping and changing the volume of the playback. Through the implementation of the methods defined by the AVAudioPlayerDelegate protocol, the application may also be configured to receive notifications of events related to the playback such as playback ending or an error occurring during the audio decoding process.


<htmlet>ios9_upgrade</htmlet>



<htmlet>ezoicbottom</htmlet>
<hr>
<table border="0" cellspacing="0">
<tr>
<td width="20%">[[iOS 8 Video Playback using AVPlayer and AVPlayerViewController|Previous]]<td align="center">[[iOS 8 App Development Essentials|Table of Contents]]<td width="20%" align="right">[[Recording Audio on iOS 8 with AVAudioRecorder in Swift|Next]]</td>
<tr>
<td width="20%">iOS 8 Video Playback using AVPlayer and AVPlayerViewController<td align="center"><td width="20%" align="right">Recording Audio on iOS 8 with AVAudioRecorder in Swift</td>
</table>