iOS 音频播放 —— 离线歌曲

我写的音频播放系列（后续会有：* AVAudioSession、iPod Library、在线歌曲、录音*，这也是我推荐大家阅读的顺序），主要以实际代码为主，不会包含很多理论性的知识，感兴趣的朋友可以去看 @码农人生 大神的博客，我在最初学习音频播放的时候就是看的他写的文章，在这里也对愿意分享技术的大神们表示感谢！

正文

播放离线歌曲也就是在播放已经存在于沙盒目录下的歌曲，是iOS音频播放最简单的一部分，所以我们会从这一部分开始。

这里我们将用到的类是AVAudioPlayer，苹果在AVAudioPlayer的官方文档中说到这么一句话

An instance of the AVAudioPlayer class, called an audio player, provides playback of audio data from a file or memory.

大体的意思呢就是AVAudioPlayer的实例对象就是一个音乐播放器，它支持播放存储在内存和磁盘中的音频文件。这也是苹果推荐使用的播放非网络流媒体文件的类，下面我就先来看一下这个类都有哪些属性和方法。

属性

@property(readonly, getter=isPlaying) BOOL playing  //是否正在播放，只读
@property(readonly) NSUInteger numberOfChannels //音频声道数，只读
@property(readonly) NSTimeInterval duration //音频时长
@property(readonly) NSURL *url  //音频文件路径，只读
@property(readonly) NSData *data    //音频数据，只读
@property float pan //立体声平衡，如果为-1.0则完全左声道，如果0.0则左右声道平衡，如果为1.0则完全为右声道
@property float volume  //音量大小，范围0-1.0
@property BOOL enableRate   //是否允许改变播放速率
@property float rate    //播放速率，范围0.5-2.0，如果为1.0则正常播放，如果要修改播放速率则必须设置enableRate为YES
@property NSTimeInterval currentTime    //当前播放时长
@property(readonly) NSTimeInterval deviceCurrentTime    //输出设备播放音频的时间，注意如果播放中被暂停此时间也会继续累加
@property NSInteger numberOfLoops   //循环播放次数，如果为0则不循环，如果小于0则无限循环，大于0则表示循环次数
@property(readonly) NSDictionary *settings  //音频播放设置信息，只读
@property(getter=isMeteringEnabled) BOOL meteringEnabled    //是否启用音频测量，默认为NO，一旦启用音频测量可以通过updateMeters方法更新测量值

对象方法

/* 使用文件URL初始化播放器，注意这个URL不能是HTTP URL，只能是File URL */
- (instancetype)initWithContentsOfURL:(NSURL *)url error:(NSError **)outError   
/* 使用NSData初始化播放器，注意使用此方法时必须文件格式和文件后缀一致，否则出错，所以相比此方法更推荐使用上述方法或- (instancetype)initWithData:(NSData *)data fileTypeHint:(NSString *)utiString error:(NSError **)outError方法进行初始化 */
- (instancetype)initWithData:(NSData *)data error:(NSError **)outError  
- (BOOL)prepareToPlay; //加载音频文件到缓冲区，注意即使在播放之前音频文件没有加载到缓冲区程序也会隐式调用此方法。   
- (BOOL)play;    //播放音频文件
- (BOOL)playAtTime:(NSTimeInterval)time //在指定的时间开始播放音频
- (void)pause;  //暂停播放
- (void)stop;   //停止播放
- (void)updateMeters    //更新音频测量值，注意如果要更新音频测量值必须 设置meteringEnabled为YES，通过音频测量值可以即时获得音频分贝等信息
- (float)peakPowerForChannel:(NSUInteger)channelNumber; //获得指定声道的分贝峰值，注意如果要获得分贝峰值必须在此之前调用updateMeters方法
- (float)averagePowerForChannel:(NSUInteger)channelNumber;  //获得指定声道的分贝平均值，注意如果要获得分贝平均值必须在此之前调用updateMeters方法

代理方法

/* 音频播放完成后调用 */
- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag;    
/* 音频解码发生错误后调用 */
- (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError *)error;  

---

好了，我们也了解了 AVAudioPlayer 有哪些属性和方法了，下面就开始代码实战吧！

#import "ViewController.h"
#import 

@interface ViewController ()

@property (weak, nonatomic) IBOutlet UIButton *previousMusicButton;   //上一首按钮
@property (weak, nonatomic) IBOutlet UIButton *playButton;            //播放按钮
@property (weak, nonatomic) IBOutlet UIButton *nextMusicButton;       //下一首按钮
@property (weak, nonatomic) IBOutlet UIProgressView *playProgress;    //播放进度

@property (strong, nonatomic) NSTimer       *timer;//进度更新定时器
@property (strong, nonatomic) AVAudioPlayer *audioPlayer;//播放器

@property (strong, nonatomic) NSArray       *musicArray; //播放队列

@end

@implementation ViewController
{
    NSInteger _index; //当前播放的第几首歌
}

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.

    _index = 0;
    _musicArray = @[@"金玟岐 - 才华有限公司.mp3",@"郝云 - 活着.mp3",@"陈粒 - 奇妙能力歌.mp3"];

    //1、初始化audioPlayer
    NSURL *url= [self contentsURLWithFileName:_musicArray[_index]];
    NSError *error=nil;
    _audioPlayer=[[AVAudioPlayer alloc]initWithContentsOfURL:url error:&error];
    //设置播放器属性
    _audioPlayer.numberOfLoops = 0;//设置为0不循环
    _audioPlayer.volume = 1.0; //设置音量大小为最大
    _audioPlayer.delegate = self;  //设置代理
    [_audioPlayer prepareToPlay];  //加载音频文件到缓存. *注意这个方便必须执行，否则是不能够正常播放歌曲
    if(error){
        NSLog(@"初始化播放器过程发生错误,错误信息:%@",error.localizedDescription);
    }

    //2.初始化NSTimer用来更新播放进度条
    _timer = [NSTimer timerWithTimeInterval:0.5 target:self selector:@selector(updatePlayprogress) userInfo:nil repeats:YES];
    [[NSRunLoop mainRunLoop]addTimer:_timer forMode:NSRunLoopCommonModes]; //如果你的播放页面有scrollView的话建议加上这段代码
}

/* 根据文件名返回一个URL对象 */
- (NSURL *)contentsURLWithFileName:(NSString *)fileName{
    NSString *urlStr=[[NSBundle mainBundle]pathForResource:fileName ofType:nil];
    NSURL *url=[NSURL fileURLWithPath:urlStr];
    return url;
}

#pragma mark - Timer
/* 更新进度条 */
- (void)updatePlayprogress{
    float progress= self.audioPlayer.currentTime /self.audioPlayer.duration;
    [self.playProgress setProgress:progress animated:true];
}

#pragma mark - ButtonAction
/* 播放/暂停 */
- (IBAction)playButtonAction:(UIButton *)sender {
    if (!sender.selected) {
        [_audioPlayer play];
        self.timer.fireDate = [NSDate distantPast];
    }else{
        [_audioPlayer pause];
        self.timer.fireDate = [NSDate distantFuture];
    }
    sender.selected = !sender.selected;
}
/* 上一首 */
- (IBAction)previousButtonAction:(id)sender {
    [_audioPlayer stop];
    _index --;
    NSURL *url = [self contentsURLWithFileName:_musicArray[(labs(_index))%3]];
    _audioPlayer = [[AVAudioPlayer alloc]initWithContentsOfURL:url error:nil];
    [_audioPlayer prepareToPlay];
    [_audioPlayer play];

    self.playButton.selected = YES;
}
/* 下一首 */
- (IBAction)nextButtonAction:(id)sender {
    [_audioPlayer stop];
    _index ++;
    NSURL *url = [self contentsURLWithFileName:_musicArray[(labs(_index))%3]];
    _audioPlayer = [[AVAudioPlayer alloc]initWithContentsOfURL:url error:nil];
    [_audioPlayer prepareToPlay];
    [_audioPlayer play];

    self.playButton.selected = YES;
}
#pragma mark - AVAudioPlayerDelegate
-(void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag{
    NSLog(@"音乐播放完成...");
}

看完代码是不是发现离线歌曲的播放其实很简单（其实就是很简单），由于也没有什么技术难点，这篇文章也就写到这了。下一篇我们会对音频会话AVAudioSession进行探讨。