如何在OSX中用Objective-C播放Documents目录下的WAV文件？播放异常求助

针对你遇到的NSSound偶尔播放成功、AVAudioPlayer完全无法播放的问题，我从两种实现的常见坑点和通用排查方向给你梳理解决方案：

一、NSSound 不稳定问题的修复 #

你提到5次尝试仅1次成功，最可能的原因是对象生命周期问题和缺少错误校验：

• 如果sound是局部变量，ARC会在方法执行完毕后立即释放它，导致播放还没开始就终止；
• 初始化时没有校验文件是否存在、实例是否创建成功，无法定位失败原因。

修复后的代码示例 #

// 先在你的类的@interface块中声明实例变量（避免局部变量被提前释放）
@property (nonatomic, strong) NSSound *playerSound;

// 播放逻辑
- (void)playAudioWithNSSound {
    NSString *soundFilePath = @"/Users/admin/Library/Containers/com.abc.myApp/Data/Documents/MyAudioSample1.wav";
    
    // 第一步：校验文件是否存在且可读
    NSFileManager *fm = [NSFileManager defaultManager];
    if (![fm isReadableFileAtPath:soundFilePath]) {
        NSLog(@"错误：音频文件不存在或无读取权限，路径：%@", soundFilePath);
        return;
    }
    
    // 第二步：初始化并校验实例
    self.playerSound = [[NSSound alloc] initWithContentsOfFile:soundFilePath byReference:YES];
    if (!self.playerSound) {
        NSLog(@"错误：NSSound 初始化失败");
        return;
    }
    
    // 第三步：配置并播放
    self.playerSound.volume = 1.0;
    self.playerSound.delegate = self;
    BOOL isPlaying = [self.playerSound play];
    NSLog(@"NSSound 播放请求结果：%@", isPlaying ? @"成功" : @"失败");
}

// 实现NSSoundDelegate方法，监听播放状态
- (void)sound:(NSSound *)sound didFinishPlaying:(BOOL)flag {
    NSLog(@"NSSound 播放结束，是否正常完成：%@", flag ? @"是" : @"否");
}

二、AVAudioPlayer 无法播放的修复 #

你的AVAudioPlayer代码缺少错误捕获和对象生命周期管理，这是最常见的失败原因：

• 局部的audioPlayer会被ARC快速释放，导致播放逻辑直接中断；
• 没有捕获初始化错误，无法知道是文件问题、格式问题还是权限问题。

修复后的代码示例 #

// 同样声明实例变量
@property (nonatomic, strong) AVAudioPlayer *audioPlayer;

// 播放逻辑
- (void)playAudioWithAVAudioPlayer {
    NSString *soundFilePath = @"/Users/admin/Library/Containers/com.abc.myApp/Data/Documents/MyAudioSample1.wav";
    NSURL *fileURL = [NSURL fileURLWithPath:soundFilePath];
    NSError *error = nil;
    
    // 初始化时捕获错误
    self.audioPlayer = [[AVAudioPlayer alloc] initWithContentsOfURL:fileURL error:&error];
    if (!self.audioPlayer) {
        NSLog(@"AVAudioPlayer 初始化失败：%@", error.localizedDescription);
        return;
    }
    
    // 配置参数并准备播放
    self.audioPlayer.volume = 1.0;
    self.audioPlayer.delegate = self;
    
    // 先准备播放（预加载音频数据）
    if ([self.audioPlayer prepareToPlay]) {
        BOOL isPlaying = [self.audioPlayer play];
        NSLog(@"AVAudioPlayer 播放请求结果：%@", isPlaying ? @"成功" : @"失败");
    } else {
        NSLog(@"AVAudioPlayer 预加载失败");
    }
}

// 实现AVAudioPlayerDelegate方法
- (void)audioPlayerDidFinishPlaying:(AVAudioPlayer *)player successfully:(BOOL)flag {
    NSLog(@"AVAudioPlayer 播放结束，是否正常完成：%@", flag ? @"是" : @"否");
}

- (void)audioPlayerDecodeErrorDidOccur:(AVAudioPlayer *)player error:(NSError * __nullable)error {
    NSLog(@"AVAudioPlayer 解码错误：%@", error.localizedDescription);
}

三、通用排查要点 #

1. 校验音频文件本身：用QuickTime打开这个WAV文件，确认文件没有损坏，且是支持的编码格式（比如PCM编码，避免使用压缩型WAV）；
2. 沙盒权限检查：如果你的App开启了沙盒，确认在Capabilities中勾选了Audio Input/Output权限，同时验证容器内的Documents目录是否可读写；
3. 线程检查：确保播放方法在主线程调用，NSSound和AVAudioPlayer的UI/播放逻辑都依赖主线程；
4. 重复播放处理：如果需要多次尝试播放，要先停止之前的播放实例（调用stop方法），再重新初始化播放。

内容的提问来源于stack exchange，提问作者Swati