iOS - AVAudioPlayer 音频播放

时间:2022-04-06 12:10:44

前言

	NS_CLASS_AVAILABLE(10_7, 2_2) @interface AVAudioPlayer : NSObject
@available(iOS 2.2, *) public class AVAudioPlayer : NSObject
  • 本地音乐播放:
    • 添加库文件:AVFoundation.framework
    • 包含头文件:#import <AVFoundation/AVFoundation.h>

1、本地音乐播放

  • Objective-C

    	// 添加库文件:AVFoundation.framework
    // 包含头文件:#import <AVFoundation/AVFoundation.h> // 声明音乐播放控件,必须声明为全局属性变量,否则可能不会播放,AVAudioPlayer 只能播放本地音乐
    @property(nonatomic, retain)AVAudioPlayer *musicPlayer; // 获取音乐文件路径
    NSURL *musicUrl = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"蓝莲花" ofType:@"mp3"]]; // 实例化音乐播放控件
    musicPlayer = [[AVAudioPlayer alloc] initWithContentsOfURL:musicUrl error:nil]; // 准备(缓冲)播放
    [musicPlayer prepareToPlay]; // 开始播放音乐
    [musicPlayer play];
  • Swift

    	// 添加库文件:AVFoundation.framework
    // 包含头文件:import AVFoundation // 声明音乐播放控件,必须声明为全局属性变量,否则可能不会播放,AVAudioPlayer 只能播放本地音乐
    var musicPlayer:AVAudioPlayer! // 获取音乐文件路径
    let musicUrl = NSURL(fileURLWithPath: NSBundle.mainBundle().pathForResource("蓝莲花", ofType: "mp3")!) // 实例化音乐播放控件
    musicPlayer = try? AVAudioPlayer(contentsOfURL: musicUrl) // 准备(缓冲)播放
    musicPlayer.prepareToPlay() // 开始播放音乐
    musicPlayer.play()

2、本地音乐播放设置

  • Objective-C

     	// 设置代理,需遵守 <AVAudioPlayerDelegate> 协议
    musicPlayer.delegate = self; // 判断播放状态
    BOOL isPlaying = musicPlayer.isPlaying; // 获取音乐通道数
    NSUInteger numberOfChannels = musicPlayer.numberOfChannels; // 获取音乐时长
    /*
    获取音乐的长度,单位秒
    */
    NSTimeInterval duration = musicPlayer.duration; // 获取与输出设备相关联的当前播放进度
    NSTimeInterval deviceCurrentTime = musicPlayer.deviceCurrentTime; // 获取当前音乐文件的路径
    /*
    音乐文件播放控件由 url 创建,returns nil if object was not created with a URL
    */
    NSURL *currentMusicUrl = musicPlayer.url; // 获取当前音乐文件的数据
    /*
    音乐文件播放控件由 data 创建,returns nil if object was not created with a data object
    */
    NSData *currentMusicData = musicPlayer.data; // 设置声道
    /*
    -1.0:左声道, 0.0:左右声道(默认), 1.0:右声道
    */
    musicPlayer.pan = 1.0; // 设置音量
    /*
    音量范围是 0.0 ~ 1.0,默认为 1.0
    */
    musicPlayer.volume = 0; // 设置是否允许控制播发速度
    /*
    设置播放速度时必须设置此项为 YES,必须在 [musicPlayer prepareToPlay] 之前设置,默认为 NO
    */
    musicPlayer.enableRate = YES; // 设置播放速度
    /*
    enableRate 必须设置为 YES,1.0 is normal, 0.5 is half speed, 2.0 is double speed
    */
    musicPlayer.rate = 1; // 设置当前播放位置
    /*
    设置音乐从指定的时间处开始播放
    */
    musicPlayer.currentTime = 30; // 设置循环播放次数
    /*
    = 0:只播放一次(默认),> 0:播放设置的次数,< 0:循环播放
    */
    musicPlayer.numberOfLoops = 1; // 缓冲音乐
    [musicPlayer prepareToPlay]; // 开始播放
    [musicPlayer play]; // 定时播放
    /*
    在指定的时间播放音乐
    */
    [musicPlayer playAtTime:[[NSDate dateWithTimeIntervalSinceNow:10] timeIntervalSince1970]]; // 暂停播放
    [musicPlayer pause]; // 停止播放
    [musicPlayer stop];
  • Swift

    	// 设置代理
    /*
    需遵守 AVAudioPlayerDelegate 协议
    */
    musicPlayer.delegate = self // 判断播放状态
    let isPlaying:Bool = musicPlayer.playing // 获取音乐通道数
    let numberOfChannels:Int = musicPlayer.numberOfChannels // 获取音乐时长
    /*
    获取音乐的长度,单位秒
    */
    let duration:NSTimeInterval = musicPlayer.duration // 获取与输出设备相关联的当前播放进度
    let deviceCurrentTime:NSTimeInterval = musicPlayer.deviceCurrentTime // 获取当前音乐文件的路径
    /*
    音乐文件播放控件由 url 创建,returns nil if object was not created with a URL
    */
    let currentMusicUrl:NSURL = musicPlayer.url! // 获取当前音乐文件的数据
    /*
    音乐文件播放控件由 data 创建,returns nil if object was not created with a data object
    */
    let currentMusicData = musicPlayer.data // 设置声道
    /*
    -1.0:左声道, 0.0:左右声道(默认), 1.0:右声道
    */
    musicPlayer.pan = 1.0 // 设置音量
    /*
    音量范围是 0.0 ~ 1.0,默认为 1.0
    */
    musicPlayer.volume = 0 // 设置是否允许控制播发速度
    /*
    设置播放速度是必须设置此项为 YES,必须在 [musicPlayer prepareToPlay] 之前设置,默认为 NO
    */
    musicPlayer.enableRate = true // 设置播放速度
    /*
    enableRate 必须设置为 YES,1.0 is normal, 0.5 is half speed, 2.0 is double speed
    */
    musicPlayer.rate = 1 // 设置当前播放位置
    /*
    设置音乐从指定的时间处开始播放
    */
    musicPlayer.currentTime = 30 // 设置循环播放次数
    /*
    = 0:只播放一次(默认),> 0:播放设置的次数,< 0:循环播放
    */
    musicPlayer.numberOfLoops = 1 // 缓冲音乐
    musicPlayer.prepareToPlay() // 开始播放
    musicPlayer.play() // 定时播放
    /*
    在指定的时间播放音乐
    */
    musicPlayer.playAtTime(NSDate(timeIntervalSinceNow: 10).timeIntervalSince1970) // 暂停播放
    musicPlayer.pause() // 停止播放
    musicPlayer.stop()

3、本地音乐文件解析

  • Objective-C

    	/*
    注意观察 commonKey 和 value: commonKey = title 歌曲名称
    commonKey = artist 歌手名称
    commonKey = albumName 专辑名称
    commonKey = artwork 专辑图片
    */
    NSString *titleString = nil;
    NSString *artistString = nil;
    NSString *albumNameString = nil;
    UIImage *artworkImage = nil; // 获取音乐文件路径
    NSURL *musicUrl = [NSURL fileURLWithPath:[[NSBundle mainBundle] pathForResource:@"蓝莲花" ofType:@"mp3"]]; // 加载音乐文件
    AVURLAsset *URLAsset = [AVURLAsset URLAssetWithURL:musicUrl options:nil]; // 解析音乐文件
    /*
    获取音乐文件中的信息,固定格式 org.id3
    */
    NSArray *musicInfoArray = [URLAsset metadataForFormat:@"org.id3"]; for (AVMetadataItem *item in musicInfoArray) { // 解析歌曲名称
    if ([item.commonKey isEqualToString:@"title"]) { titleString = (NSString *)item.value;
    } // 解析歌手名称
    if ([item.commonKey isEqualToString:@"artist"]) { artistString = (NSString *)item.value;
    } // 解析专辑名称
    if ([item.commonKey isEqualToString:@"albumName"]) { albumNameString = (NSString *)item.value;
    } // 解析专辑图片
    if ([item.commonKey isEqualToString:@"artwork"]) { // value 值为 NSData 时,直接取值
    NSData *data = (NSData *)item.value; artworkImage = [UIImage imageWithData:data];
    }
    } // 显示解析值 musicInfoLabel.text = [NSString stringWithFormat:@"歌曲名称: %@\n歌手名称: %@\n专辑名称: %@",
    titleString, artistString, albumNameString]; musicInfoImageView.image = artworkImage;
  • Swift

    	/*
    注意观察 commonKey 和 value: commonKey = title 歌曲名称
    commonKey = artist 歌手名称
    commonKey = albumName 专辑名称
    commonKey = artwork 专辑图片
    */
    var titleString:String!
    var artistString:String!
    var albumNameString:String!
    var artworkImage:UIImage! // 获取音乐文件路径
    let musicUrl:NSURL = NSURL(fileURLWithPath: NSBundle.mainBundle().pathForResource("蓝莲花", ofType: "mp3")!) // 加载音乐文件
    let URLAsset = AVURLAsset(URL: musicUrl, options: nil) // 解析音乐文件
    /*
    获取音乐文件中的信息,固定格式 org.id3
    */
    let musicInfoArray = URLAsset.metadataForFormat("org.id3") for item in musicInfoArray { let itemCommonKey:String? = (item as! AVMutableMetadataItem).commonKey // 解析歌曲名称
    if itemCommonKey == "title" { titleString = (item as! AVMutableMetadataItem).value as! String
    } // 解析歌手名称
    if itemCommonKey == "artist" { artistString = (item as! AVMutableMetadataItem).value as! String
    } // 解析专辑名称
    if itemCommonKey == "albumName" { albumNameString = (item as! AVMutableMetadataItem).value as! String
    } // 解析专辑图片
    if itemCommonKey == "artwork" { // value 值为 NSData 时,直接取值
    let data = (item as! AVMutableMetadataItem).value as! NSData artworkImage = UIImage(data: data)
    }
    } // 显示解析值 musicInfoLabel.text = "歌曲名称: \(titleString)\n歌手名称: \(artistString)\n专辑名称: \(albumNameString)" musicInfoImageView.image = artworkImage

4、AVAudioPlayerDelegate 协议方法

  • Objective-C

    	// 播放完成
    - (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag { } // 播放失败
    - (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError *)error { }
  • Swift

    	// 播放完成
    func audioPlayerDidFinishPlaying(player: AVAudioPlayer, successfully flag: Bool) { } // 播放失败
    func audioPlayerDecodeErrorDidOccur(player: AVAudioPlayer, error: NSError?) { }