AVAudioPlayer类创建的实例可以看作为一个音频播放器,可以播放来自文件或存储的音频数据。
它支持多种音频格式,而且能够进行进度、音量、播放速度等控制。
使用这个类,可以:
1、在指定的时间开始播放音频
2、从文件或内存缓冲区播放音频
3、循环播放

 

属性

描述

@property(readonly, getter=isPlaying) BOOL playing

是否正在播放,只读

@property float volume

音量大小,范围0~1.0

@property float pan

立体声,-1.0完全左声道,0.0左右声道平衡,1.0完全右声道

@property float rate

播放速率,范围0.5~2.0,1.0时为正常播放,如果需要更改播放速率必须设置enableRate为YES

@property BOOL enableRate

是否可以更改播放速率

@property NSInteger numberOfLoops

重复播放次数,为0时只播放一次,小于0时为无限播放,大于0时表示循环次数

@property(readonly) NSDictionary *settings

音频播放次数信息,只读

@property(readonly) NSUInteger numberOfChannels

与音频播放器相关联的声音通道的数量。(只读)

@property(nonatomic, copy) NSArray *channelAssignments

与音频播放器相关AVAudioSessionChannelDescription对象数组

@property(readonly) NSTimeInterval duration

播放时长

@property NSTimeInterval currentTime

当前播放时长

@property(readonly) NSTimeInterval deviceCurrentTime

输出设备播放音频的时间,注意如果播放中被暂停此时间也会继续累加

@property(readonly) NSURL *url

音频文件路径,只读

@property(readonly) NSData *data

音频数据,只读

@property(getter=isMeteringEnabled) BOOL meteringEnabled

否启用音频测量,默认为NO,一旦启用音频测量可以通过updateMeters方法更新测量值

对象方法

描述

- (instancetype)initWithContentsOfURL:(NSURL *)url  error:(NSError **)outError

使用文件URL初始化播放器,注意这个URL不能是HTTP URL,AVAudioPlayer不支持加载网络媒体流,只能播放本地文件

- (instancetype)initWithData:(NSData *)data error:(NSError **)outError

使用NSData初始化播放器,注意使用此方法时必须文件格式和文件后缀一致,否则出错,所以相比此方法更推荐使用上述方法

或- (instancetype)initWithData:(NSData *)data fileTypeHint:(NSString *)utiString error:(NSError **)outError方法进行初始化

- (BOOL)play

播放音频文件

- (BOOL)playAtTime:(NSTimeInterval)time

在指定的时间开始播放音频

- (void)pause

暂停播放

- (void)stop

停止播放

- (BOOL)prepareToPlay

将音频文件加载到缓冲区

- (float)averagePowerForChannel:(NSUInteger)channelNumber

获得指定声道的分贝平均值,注意如果要获得分贝平均值必须在此之前调用updateMeters方法

- (float)peakPowerForChannel:(NSUInteger)channelNumber

获得指定声道的分贝峰值,注意如果要获得分贝峰值必须在此之前调用updateMeters方法

- (void)updateMeters

更新音频测量值,注意如果要更新音频测量值必须设置meteringEnabled为YES,通过音频测量值可以即时获得音频分贝等信息

代理方法

说明

- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag

播放完成后调用,在这里可以进行一些属性的设置

- (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError *)error

音频解码发生错误

AVAudioPlayer的使用比较简单:

1、初始化AVAudioPlayer对象,通常指定本地文件路径

2、设置播放器属性,例如播放次数,音量大小,设置代理等

3、开始播放,调用play方法

下面就是AVAudioPlayer实现的一个简单播放器,它播放本地的音频文件,实现了播放、暂停、显示播放进度,现实播放时间等功能:

1 #import "JZViewController.h"
  2 #import <AVFoundation/AVFoundation.h>
  3 
  4 @interface JZViewController() <AVAudioPlayerDelegate>
  5 
  6 @property (nonatomic, strong) AVAudioPlayer * audioPlayer;
  7 @property (nonatomic, strong) UIImageView * imageView;
  8 @property (nonatomic, strong) UIProgressView * progressView;
  9 @property (nonatomic, strong) UILabel * timeLabel;
 10 @property (nonatomic, strong) UILabel * currenttimeLabel;
 11 @property (nonatomic, assign) NSTimer * timer;
 12 @property (nonatomic, assign) int intTime;
 13 @property (nonatomic, assign) int timeNum;
 14 @property (nonatomic, assign) UIButton * button;
 15 
 16 @end
 17 
 18 @implementation JZViewController
 19 
 20 - (void)viewDidLoad
 21 {
 22     [super viewDidLoad];
 23     self.title = @"礼物"; //播放音频为 礼物.mp3 钢琴曲
 24     self.view.backgroundColor = [UIColor whiteColor];
 25     
 26     [self.view addSubview:self.imageView];
 27     
 28     [self initView];
 29 }
 30 
 31 //界面初始化,添加一个view、一个进度条、3个label、一个button
 32 - (void)initView
 33 {
 34     UIView * view = [[UIView alloc] initWithFrame:CGRectMake(0, [UIScreen mainScreen].bounds.size.height - 150, [UIScreen mainScreen].bounds.size.width, 150)];
 35     view.backgroundColor = [UIColor colorWithRed:246 / 255.0 green:246 / 255.0 blue:246 / 255.0 alpha:0.9];
 36     view.alpha = 0.8f;
 37     [self.view addSubview:view];
 38 
 39     UIProgressView * progressView = [[UIProgressView alloc] initWithFrame:CGRectMake(40, 50, [UIScreen mainScreen].bounds.size.width - 80, 0)];
 40     self.progressView = progressView;
 41     [view addSubview:progressView];
 42     
 43     UILabel * timeLabel = [[UILabel alloc] initWithFrame:CGRectMake([UIScreen mainScreen].bounds.size.width - 40, 40, 40, 20)];
 44     timeLabel.backgroundColor = [UIColor clearColor];
 45     timeLabel.font = [UIFont systemFontOfSize:11];
 46     timeLabel.textAlignment = NSTextAlignmentCenter;
 47     self.timeLabel = timeLabel;
 48     [view addSubview:timeLabel];
 49     
 50     UILabel * currentTimeLabel = [[UILabel alloc] initWithFrame:CGRectMake(0, 40, 40, 20)];
 51     currentTimeLabel.backgroundColor = [UIColor clearColor];
 52     currentTimeLabel.font = [UIFont systemFontOfSize:11];
 53     currentTimeLabel.textAlignment = NSTextAlignmentCenter;
 54     self.currenttimeLabel = currentTimeLabel;
 55     [view addSubview:currentTimeLabel];
 56     
 57     UILabel * label = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, 50)];
 58     label.backgroundColor = [UIColor clearColor];
 59     label.text = @"礼物";
 60     label.textAlignment = NSTextAlignmentCenter;
 61     [view addSubview:label];
 62     
 63     UIButton * button = [[UIButton alloc] initWithFrame:CGRectMake([UIScreen mainScreen].bounds.size.width / 2 - 30, 70, 60, 60)];
 64     button.backgroundColor = [UIColor clearColor];
 65     [button setImage:[UIImage imageNamed:@"start.jpg"] forState:UIControlStateNormal];
 66     [button addTarget:self action:@selector(clickButton:) forControlEvents:UIControlEventTouchUpInside];
 67     self.button = button;
 68     button.tag = 10;
 69     [view addSubview:button];
 70 }
 71 
 72 //初始化imageView,添加背景图片
 73 - (UIImageView *)imageView
 74 {
 75     if(!_imageView){
 76         UIImage * image = [UIImage imageNamed:@"sjz.jpg"];
 77         UIImageView * imageView = [[UIImageView alloc] initWithImage:image];
 78         imageView.frame = [UIScreen mainScreen].bounds;
 79         _imageView = imageView;
 80     }
 81     return _imageView;
 82 }
 83 
 84 //懒加载,创建audioPlayer
 85 - (AVAudioPlayer *)audioPlayer
 86 {
 87     if(!_audioPlayer){
 88         NSString * urlStr = [[NSBundle mainBundle] pathForResource:@"礼物.mp3" ofType:nil];
 89         NSURL * url = [NSURL fileURLWithPath:urlStr];
 90         NSError * error = nil;
 91         _audioPlayer = [[AVAudioPlayer alloc] initWithContentsOfURL:url error:&error];
 92         //设置播放属性
 93         _audioPlayer.numberOfLoops = 0;
 94         _audioPlayer.delegate = self;
 95         [_audioPlayer prepareToPlay];  //加载音频文件到缓存
 96         
 97         
 98         if(error){
 99             NSLog(@"初始化播放器过程发生错误,错误信息:%@", error.localizedDescription);
100             return nil;
101         }
102         
103     }
104     return _audioPlayer;
105 }
106 
107 //点击button后调用的方法,播放、暂停音乐
108 - (void)clickButton:(UIButton *)sender
109 {
110     if(sender.tag == 10){
111         sender.tag = 20;
112         [sender setImage:[UIImage imageNamed:@"stop.jpg"] forState:UIControlStateNormal];
113         [self.audioPlayer play];
114         self.timer.fireDate = [NSDate distantPast];
115     }else{
116         sender.tag = 10;
117         [sender setImage:[UIImage imageNamed:@"start.jpg"] forState:UIControlStateNormal];
118         [self.audioPlayer pause];
119         self.timer.fireDate = [NSDate distantFuture];
120     }
121 }
122 
123 //初始化定时器
124 - (NSTimer *)timer
125 {
126     if(!_timer){
127         _timer = [NSTimer scheduledTimerWithTimeInterval:1.0f target:self selector:@selector(updateTimeAddProgress) userInfo:nil repeats:YES];
128         self.timeNum = (int)self.audioPlayer.duration;
129     }
130     return _timer;
131 }
132 
133 //定时器的调用方法,在这里更新进度条,并且更新时间
134 - (void)updateTimeAddProgress
135 {
136     float progress = self.audioPlayer.currentTime / self.audioPlayer.duration;
137     [self.progressView setProgress:progress animated:YES];
138     
139     self.intTime++;
140     NSString * str = [NSString stringWithFormat:@"%.2d:%.2d", self.intTime / 60, self.intTime % 60];
141     self.currenttimeLabel.text = str;
142     
143     self.timeNum--;
144     NSString * strTime = [NSString stringWithFormat:@"%.2d:%.2d", self.timeNum / 60, self.timeNum % 60];
145     self.timeLabel.text = strTime;
146 }
147 
148 //代理方法,做一些播放完成后的处理,删除掉定时器,button图片的更改、停止音乐播放等
149 - (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag
150 {
151     self.intTime = 0;
152     [self.audioPlayer stop];
153     [self.timer invalidate];
154     self.timer = nil;
155     
156     self.button.tag = 10;
157     [self.button setImage:[UIImage imageNamed:@"start.jpg"] forState:UIControlStateNormal];
158 }
159 
160 @end