iOS开发拓展篇—封装音频文件播放工具类

一、简单说明

1.关于音乐播放的简单说明

（1）音乐播放用到一个叫做AVAudioPlayer的类

（2）AVAudioPlayer常用方法

　　加载音乐文件

- (id)initWithContentsOfURL:(NSURL *)url error:(NSError **)outError;

- (id)initWithData:(NSData *)data error:(NSError **)outError;

　　准备播放（缓冲，提高播放的流畅性）　- (BOOL)prepareToPlay;

　　播放（异步播放）- (BOOL)play;

　　暂停　- (void)pause;

　　停止- (void)stop;

　　是否正在播放　　@property(readonly, getter=isPlaying) BOOL playing;

　　时长　　　　　　@property(readonly) NSTimeInterval duration;

　　当前的播放位　　@property NSTimeInterval currentTime;

　　播放次数（-1代表无限循环播放，其他代表播放numberOfLoops+1次　@property NSInteger numberOfLoops;

　　音量　　　　　　@property float volume;

　　是否允许更改速率@property BOOL enableRate;

　　播放速率（1是正常速率，0.5是一般速率，2是双倍速率）　　@property float rate;

　　有多少个声道　@property(readonly) NSUInteger numberOfChannels;

2.播放多个音乐文件

说明：如果要播放多个音乐文件，那么最傻瓜的做法是，创建多个全局的播放器去播放对应的音乐文件，但是这种方法无法适用于需要播放的文件数量巨大的情况。

　　另外一种做法是：自己封装一个播放音乐文件的工具类。

 

封装工具类的实现步骤：

　　新建一个类，继承自NSObject类。提供三个对外的接口：

　　

分别是：

播放音乐（参数：文件名）

暂停音乐（参数：文件名）

停止音乐（参数：文件名）

该工具类中的代码设计如下：

XZAudioTool.h文件

#import <Foundation/Foundation.h>

@interface XZAudioTool : NSObject

/**
 *  根据音乐文件名称播放音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)playMusicWithFilename:(NSString  *)filename;

/**
 *  根据音乐文件名称暂停音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)pauseMusicWithFilename:(NSString  *)filename;

/**
 *  根据音乐文件名称停止音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)stopMusicWithFilename:(NSString  *)filename;
@end

XZAudioTool.m文件测试程序：

#import "XZAudioTool.h"
#import <AVFoundation/AVFoundation.h>

@implementation XZAudioTool
/**
 *  存放所有的音乐播放器
 */
static NSMutableDictionary *_players;
+ (NSMutableDictionary *)players
{
    if (!_players) {
        _players = [NSMutableDictionary dictionary];
    }
    return _players;
}

/**
 *  根据音乐文件名称播放音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)playMusicWithFilename:(NSString  *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出播放器
    AVAudioPlayer *player = [self players][filename];
    
    // 2.判断播放器是否为nil
    if (!player) {
        NSLog(@"创建新的播放器");
        
        // 2.1根据文件名称加载音效URL
        NSURL *url = [[NSBundle mainBundle] URLForResource:filename withExtension:nil];
        
        // 2.2判断url是否为nil
        if (!url) {
            return;
        }
        
        // 2.3创建播放器
        player = [[AVAudioPlayer alloc] initWithContentsOfURL:url error:nil];
        
        // 2.4准备播放
        if(![player prepareToPlay])
        {
            return; //如果缓冲失败，那么就直接返回
        }
        // 允许快进
        player.enableRate = YES;
        player.rate = 3;
        
        // 2.5将播放器添加到字典中
        [self players][filename] = player;
        
    }
    // 3.播放音乐
    if (!player.playing)
    {
        [player play];
    }
   
}

/**
 *  根据音乐文件名称暂停音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)pauseMusicWithFilename:(NSString  *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出播放器
    AVAudioPlayer *player = [self players][filename];

    // 2.判断播放器是否存在
    if(player)
    {
        // 2.1判断是否正在播放
        if (player.playing)
        {
            // 暂停
            [player pause];
        }
    }
    
}

/**
 *  根据音乐文件名称停止音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)stopMusicWithFilename:(NSString  *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出播放器
    AVAudioPlayer *player = [self players][filename];

    // 2.判断播放器是否为nil
    if (player) {
        // 2.1停止播放
        [player stop];
        // 2.2清空播放器
//        player = nil;
        // 2.3从字典中移除播放器
        [[self players] removeObjectForKey:filename];
    }
}
@end

 在storyboard中拖拽控件，并进行连线，以做控制。

导入可供播放的音乐素材。

测试程序的代码设计如下：

//
//  ViewController.m
//  03-多个音乐文件的播放
//
//  Created by XZ on 14/11/7.
//  Copyright (c) 2014年 github. All rights reserved.
//

#import "ViewController.h"
#import <AVFoundation/AVFoundation.h>
#import "XZAudioTool.h"

@interface ViewController ()
//  播放器
@property (nonatomic, strong) AVAudioPlayer *player;

// 播放
- (IBAction)playMusic;

// 暂停
- (IBAction)pauseMusic;

// 停止
- (IBAction)stopMusic;

// 下一首
- (IBAction)nextMusic;

// 用一个数组来保存所有的音乐文件
@property (nonatomic, strong) NSArray *musics;

// 用一个int型的属性来记录当前播放音乐的索引
@property (nonatomic, assign) int  currentIndex;
@end

@implementation ViewController

#pragma mark - 懒加载
- (NSArray *)musics
{
    if (!_musics) {
        _musics = @[@"最佳损友.mp3", @"心碎了无痕.mp3", @"瓦解.mp3", @"简单爱.mp3"];
    }
    return _musics;
}

- (void)viewDidLoad {
    [super viewDidLoad];
}

- (IBAction)playMusic {
    // 开始播放/继续播放
    [XZAudioTool playMusicWithFilename:self.musics[self.currentIndex]];
}

- (IBAction)pauseMusic {
    // 暂停
    [XZAudioTool pauseMusicWithFilename:self.musics[self.currentIndex]];
}

- (IBAction)stopMusic {
    // 停止
    [XZAudioTool stopMusicWithFilename:self.musics[self.currentIndex]];

}

- (IBAction)nextMusic {
    // 下一首
    
    // 1.递增索引
    int nextIndex = self.currentIndex + 1;
    
    // 1.1.判断是否越界
    if (nextIndex >= self.musics.count) {
        nextIndex = 0;
    }
    NSLog(@"当前 %d  下一首 %d",  self.currentIndex, nextIndex);
    // 2.播放
    // 2.1停止上一首播放
    [self stopMusic];
    self.currentIndex = nextIndex;
    // 2.2播放下一首
    [self playMusic];
}

@end

二、对工具类进行改造，让其兼能播放音效文件

说明：

　　音效只有创建、播放和销毁（停止）三个操作，因为音效一般都很短，因此没有暂停的方法。

　　

把对音效文件的播放加入到工具类中，实现的代码如下：

XZAudioTool.h文件

#import <Foundation/Foundation.h>

@interface XZAudioTool : NSObject
/**
 *  根据音效文件名称播放音效
 *
 *  @param filename 音效文件名称
 */
+ (void)playAudioWithFilename:(NSString  *)filename;

/**
 *  根据音效文件名称销毁音效
 *
 *  @param filename 音效文件名称
 */
+ (void)disposeAudioWithFilename:(NSString  *)filename;

/**
 *  根据音乐文件名称播放音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)playMusicWithFilename:(NSString  *)filename;

/**
 *  根据音乐文件名称暂停音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)pauseMusicWithFilename:(NSString  *)filename;

/**
 *  根据音乐文件名称停止音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)stopMusicWithFilename:(NSString  *)filename;
@end

SLAudioTool.m文件测试程序：

#import "XZAudioTool.h"
#import <AVFoundation/AVFoundation.h>

@implementation XZAudioTool
/**
 *  存放所有的音效ID
 */
static NSMutableDictionary *_soundIDs;
+ (NSMutableDictionary *)soundIDs
{
    if (!_soundIDs) {
        _soundIDs = [NSMutableDictionary dictionary];
    }
    return _soundIDs;
}

/**
 *  存放所有的音乐播放器
 */
static NSMutableDictionary *_players;
+ (NSMutableDictionary *)players
{
    if (!_players) {
        _players = [NSMutableDictionary dictionary];
    }
    return _players;
}

/**
 *  根据音效文件名称播放音乐
 *
 *  @param filename 音效文件名称
 */
+ (void)playAudioWithFilename:(NSString *)filename
{
    
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出音效ID
    SystemSoundID soundID = [[self soundIDs][filename] unsignedIntValue];
    
    // 判断音效ID是否为nil
    if (!soundID) {
        NSLog(@"创建新的soundID");
        
        // 音效ID为nil
        // 根据文件名称加载音效URL
        NSURL *url = [[NSBundle mainBundle] URLForResource:filename withExtension:nil];
        
        // 判断url是否为nil
        if (!url) {
            return;
        }
        
        // 创建音效ID
        AudioServicesCreateSystemSoundID((__bridge CFURLRef)(url), &soundID);
        
        // 将音效ID添加到字典中
        [self soundIDs][filename] = @(soundID);
    }
    // 播放音效
    AudioServicesPlaySystemSound(soundID);
}

/**
 *  根据音效文件名称销毁音乐
 *
 *  @param filename 音效文件名称
 */
+ (void)disposeAudioWithFilename:(NSString *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出音效ID
    SystemSoundID soundID = [[self soundIDs][filename] unsignedIntValue];
    
    if (soundID) {
        // 2.销毁音效ID
        AudioServicesDisposeSystemSoundID(soundID);
        
        // 3.从字典中移除已经销毁的音效ID
        [[self soundIDs] removeObjectForKey:filename];
    }
    
}


/**
 *  根据音乐文件名称播放音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)playMusicWithFilename:(NSString  *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出播放器
    AVAudioPlayer *player = [self players][filename];
    
    // 2.判断播放器是否为nil
    if (!player) {
        NSLog(@"创建新的播放器");
        
        // 2.1根据文件名称加载音效URL
        NSURL *url = [[NSBundle mainBundle] URLForResource:filename withExtension:nil];
        
        // 2.2判断url是否为nil
        if (!url) {
            return;
        }
        
        // 2.3创建播放器
        player = [[AVAudioPlayer alloc] initWithContentsOfURL:url error:nil];
        
        // 2.4准备播放
        if(![player prepareToPlay])
        {
            return; //如果缓冲失败，那么就直接返回
        }
        // 允许快进
        player.enableRate = YES;
        player.rate = 3;
        
        // 2.5将播放器添加到字典中
        [self players][filename] = player;
        
    }
    // 3.播放音乐
    if (!player.playing)
    {
        [player play];
    }
   
}

/**
 *  根据音乐文件名称暂停音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)pauseMusicWithFilename:(NSString  *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出播放器
    AVAudioPlayer *player = [self players][filename];

    // 2.判断播放器是否存在
    if(player)
    {
        // 2.1判断是否正在播放
        if (player.playing)
        {
            // 暂停
            [player pause];
        }
    }
    
}

/**
 *  根据音乐文件名称停止音乐
 *
 *  @param filename 音乐文件名称
 */
+ (void)stopMusicWithFilename:(NSString  *)filename
{
    // 0.判断文件名是否为nil
    if (filename == nil) {
        return;
    }
    
    // 1.从字典中取出播放器
    AVAudioPlayer *player = [self players][filename];

    // 2.判断播放器是否为nil
    if (player) {
        // 2.1停止播放
        [player stop];
        // 2.2清空播放器
//        player = nil;
        // 2.3从字典中移除播放器
        [[self players] removeObjectForKey:filename];
    }
}
@end

代码测试：

- (IBAction)playMusic {
    // 开始播放/继续播放
//    [HMAudioTool playMusicWithFilename:self.musics[self.currentIndex]];
    [HMAudioTool playAudioWithFilename:@"buyao.wav"];
}

代码说明：

打印的值为0，播放成功（因为函数是C++中的）