播放系统音的方法和遇到的坑

本人有若干成套学习视频, 可试看! 可试看! 可试看, 重要的事情说三遍 包含Java, 数据结构与算法, iOS, 安卓, python, flutter等等, 如有需要, 联系微信tsaievan.

今天说个简单的.
在实际项目中, 我们经常会遇到一些需要播放简短音效的地方, 比如我发送一条消息, 有提示音效, 我点击某个按钮, 有提示音效, 这种短的音效当然也可以用播放音频的AVAudioPlayer的方式播放出来, 但是我们有更简单的方法.

我们可以封装一个播放音效的管理类, 比如YFSoundEffectHelper什么的, 然后写一个类方法, 专门用来缓存soundID

static NSMutableDictionary *_soudIDs;
+ (NSMutableDictionary *)soudIDs {
    if (!_soudIDs) {
        _soudIDs = [NSMutableDictionary dictionary];
    }
    return _soudIDs;
}

因为我们使用的这个播放音效的方法是C语言的, 我们需要将其封装为OC的, 这样调用就更方便

+ (void)playSoundEffect:(NSString *)effectName completionHandler:(void(^)())completionHandler{
    if (!effectName) {
        return;
    }
    SystemSoundID soundID = [[self soundIDs][effectName] unsignedIntValue];
    if (!soundID) {
        NSURL *url = [[NSBundle mainBundle] URLForResource:effectName withExtension:nil];
        if (!url) {
            return;
        }
        OSStatus status = AudioServicesCreateSystemSoundID((__bridge CFURLRef _Nonnull)(url), &soundID);
        NSLog(@"%d",(int)status);
        [self soundIDs][effectName] = @(soundID);
    }
    AudioServicesPlaySystemSoundWithCompletion(soundID, ^{
        if (completionHandler) {
            completionHandler();
        }
    });
}

这里面有两个关键方法

• AudioServicesCreateSystemSoundID(CFURLRef _Nonnull inFileURL, SystemSoundID * _Nonnull outSystemSoundID)
  第一个参数填url的地址, 当然这里不是NSURL,而是需要用(__bridge CFURLRef _Nonnull)关键字进行桥接, 当然这个不用记,你填了OC的URL之后, 会自动有一个红色的大胖圆点, 你一点就自动给你改好了.
  第二个参数填soundID的地址.

• AudioServicesPlaySystemSoundWithCompletion( SystemSoundID inSystemSoundID,void (^__nullable inCompletionBlock)(void))
  第一个参数填你需要播放音效的soundID,第二个参数填音效播放完成后需要执行的代码, 这是一个Block回调.

也就是说, 播放音效只需要执行以下步骤,

1.注册soundID, 就是把音效文件的url(bundle)地址和soundID的指针地址传给AudioServicesCreateSystemSoundID(_,_)这个函数.

2.播放音效,将soundID和回调代码传给AudioServicesPlaySystemSoundWithCompletion(_,_)这个函数

框架同时还提供了一个方法,AudioServicesPlaySystemSound(_),只需要传soundID这一个参数即可, 但是这是有坑的, 为什么呢?
因为在播放声音的时候, 可能会有其他打扰音效播放的事情, 比如你点击按钮准备录音, 这时候音效是无法从扬声器播放出来的, 也就是你只能从听筒听到, 声音很小, 因为播放音效是异步执行的, 可录音同时进行, 系统就默认了声音不从扬声器放出, 所以你必须使用带block的方法 , 让音频完全播放完毕之后再执行录音代码.

可能就是因为这一点, 苹果将在下一个版本废弃掉AudioServicesPlaySystemSound(_)这个方法.

如果要保持始终从扬声器播放音效, 还需要添加如下代码:

AVAudioSession *session = [AVAudioSession sharedInstance];
    NSError *setCategoryError = nil;
    if (![session setCategory:AVAudioSessionCategoryPlayback
                  withOptions:AVAudioSessionCategoryOptionMixWithOthers
                        error:&setCategoryError]) {
        NSLog(@"开启扬声器发生错误:%@",setCategoryError.localizedDescription);
    }

之前我没有添加以上代码, 在真机上运行时 ,还是会出现不从扬声器,而从听筒播放声音的现象, 在+ (void)playSoundEffect:(NSString *)effectName completionHandler:(void(^)())completionHandler添加了以上代码之后,解决了问题, 会话session在设置的时候, 有如下几个选项

AVAudioSessionCategoryOptionMixWithOthers
AVAudioSessionCategoryOptionDuckOthers
AVAudioSessionCategoryOptionAllowBluetooth
AVAudioSessionCategoryOptionDefaultToSpeaker
AVAudioSessionCategoryOptionInterruptSpokenAudioAndMixWithOthers

• AVAudioSessionCategoryOptionMixWithOthers: 音频将和其他的已经激活的音频合并, 假设现在有2个激活的音频会话, 那么这两个会话会并存, 不会将另一个沉默掉

• AVAudioSessionCategoryOptionDuckOthers : 这个选项会沉默掉其他音频会话, 使其他音频会话的音量减小
  我估计在项目中, 我的音频会话就是被另一个音频会话给沉默掉了

• AVAudioSessionCategoryOptionAllowBluetooth: 这个选项是允许蓝牙设备作为输入音轨

• AVAudioSessionCategoryOptionDefaultToSpeaker : 将会话中的音频转至默认的内置扬声器

• AVAudioSessionCategoryOptionInterruptSpokenAudioAndMixWithOthers : 如果你的APP偶然要说句话什么的, 比如导航类的APP或者运动类的APP, 就使用这个选项, 将打断连续的音频, 比如音乐播放器或者语音电子书一类APP

如果一个录音完成后又要播放提示音, 这时候使用AudioServicesPlaySystemSoundWithCompletion(_,_)也没有用, 为什么呢?因为录音的事情可能还没有执行完, 有个小技巧是延时0.1秒执行播放代码

dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(0.1 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
            [YFSoundEffectHelper playSoundEffect:kZHLVoiceRecognizeEndSoundEffect completionHandler:nil];
        });

这个时候就不会有影响

还有一点需要注意的是, 在C语言中, 有creat就必须要释放, 此时, 框架给我提供的方法是AudioServicesDisposeSystemSoundID(SystemSoundID inSystemSoundID)

同样的, 我们将其封装为OC的代码方便调用

+ (void)disposeSoundEffect:(NSString *)effectName {
    if (!effectName) {
        return;
    }
    SystemSoundID soundID = [[self soundIDs][effectName] unsignedIntValue];
    if (soundID) {
        AudioServicesDisposeSystemSoundID(soundID);
        [[self soundIDs]removeObjectForKey:effectName];
    }
}

以上就是播放系统音/音效的方法, 是不是很简单呢?

PS. 本人有若干成套学习视频, 包含Java, 数据结构与算法, iOS, 安卓, python, flutter等等, 如有需要, 联系微信tsaievan.