微信iOS收款到帐语音提醒开发总结

本文来自于腾讯Bugly公众号（weixinBugly），未经做者赞成，请勿转载，原文地址：https://mp.weixin.qq.com/s/yYCaPMxHGT9LyRyAPewVWQ

做者：littleliang

1、背景

为了解决小商户老板们在频繁交易中不方便核对、确认到帐的痛点，产品MM提出了新版本须要支持收款到帐语音提醒功能。这篇文章总结了开发过程当中遇到的坑和一些小技巧。

2、技术方案

后台唤醒App

收款到帐语音提醒须要收款方在收到款后，播放一段TTS合成语音播报金额，微信在前台时能够经过模板消息将须要播报的金额带下来，再请求TTS数据并播放，可是app在挂起或者被kill掉的状况下要如何请求语音数据并播放呢？
iOS提供了两种方式唤醒处于挂起或已经被kill掉的app。分别是Silent Notification和VoIP Push Notification，客户端在被唤醒以后将得到30s的后台运行时间，这段运行时间足以请求合成语音数据并播放。

1.Silent Notification：
Silent Notification在iOS7以上即可以支持，可是每小时能推送的Silent Notification次数有限制。

2.VoIP Push Notification
VoIP Push Notification则是在iOS8以上才支持的新Push类型，相比于Silent Notification，VoIP Push具备高优先级、低延迟的优点，而且没有次数限制。
对比这两种技术方案，VoIP Push Notification明显更适合用于收款到帐语音提醒的唤醒方案。

TTS合成语音

TTS语音合成方案分为离线合成方案和在线合成方案，离线合成方案省去网络请求，合成速度更快，节省网络流量，可是合成音的听起来比较机械，语速和停顿的处理较差一些。若是对合成音的效果要求不是特别高，能够考虑采用iOS自带的AVSpeechSynthesis框架，免去语音库的合入，减小安装包大小。

在线合成方案的效果则相对更像人声，富有感情。考虑到产品体验，咱们采用了搜索产品部提供的在线语音合成方案，接入方式能够看这篇文章。合成音格式支持wav，mp3，silk，amr，speex，对比后发现，在合成相同文本的状况下，amr的压缩率最高，可是能听到音质降低明显。silk格式压缩率次高，且能保持相对清晰的音质，单条合成语音大小在2KB左右。

唤醒后播放音频文件

在请求到合成语音后，要在后台或者锁屏状态下播放音频文件，AVAudio Session的Category值须要使用AVAudioSessionCategoryPlayback或是AVAudioSessionCategoryPlayAndRecord，CategoryOptions根据实际须要可选择MixWithOthers（与其余声音混音）或是DuckOthers（调低其余声音的音量）。

须要注意的是，只有iOS10以上才支持app被唤醒后在后台/锁屏状态下播放音频。因此iOS10如下的设备，在收到VoIP Push后只能在local push上设定一段固定铃声，这也是为何iOS10如下只有“微信支付收款到帐”，而没有后面具体的金额数值。

3、静音开关检测

不幸的是，在产品发布后没多久就受到了某互联网大佬的吐槽。

从产品体验上来讲，收款到帐的金额播报是随着local push的弹出一块儿播放的，更像是一种特殊的push铃声，而苹果对push铃声的处理是受到静音开关控制的，因此讲道理，这个吐槽是合理的。然而前面提到App在被VoIP Push唤醒以后，须要将AudioSessionCategory设置为AVAudioSessionCategoryPlayback或AVAudioSessionCategoryPlayAndRecord才能够在后台播放音频文件，这两种模式是不受静音开关控制的。要实现这个需求，就必须获取当前静音开关的状态。而苹果在iOS5以后并无明确地提供一种方式让开发获取静音开关的状态，这就陷入了一个尴尬的局面。

苹果在iOS5以前可使用如下方式监听静音键开关

- (BOOL)isMuted  
{  
    CFStringRef route;  
    UInt32 routeSize = sizeof(CFStringRef);  

    OSStatus status = AudioSessionGetProperty(kAudioSessionProperty_AudioRoute, &routeSize, &route);  
    if (status == kAudioSessionNoError)  
    {  
        if (route == NULL || !CFStringGetLength(route))  
            return YES;  
    }  

    return NO;  
}

苹果在iOS5以后便禁止了使用这种方式监听静音按键，背后的缘由应该是苹果但愿开发者使用AVAudioSession来提供统一的音频播放效果。

最后我在Reddit上找到了一种曲线救国的方式，实现起来也不复杂：使用AudioServicesPlaySystemSound播放一段0.2s的空白音频，并监听音频播放完成事件，若是从开始播放到回调完成方法的间隔时间小于0.1s，则意味当前静音开关为开启状态。

void SoundMuteNotificationCompletionProc(SystemSoundID  ssID,void* clientData){
    MMSoundSwitchDetector* detecotr = (__bridge MMSoundSwitchDetector*)clientData;
    [detecotr complete];
}

- (instancetype)init {
    self = [super init];
    if (self) {
        NSURL *pathURL = [[NSBundle mainBundle] URLForResource:@"mute" withExtension:@"caf"];
        if (AudioServicesCreateSystemSoundID((__bridge CFURLRef)pathURL, &_soundId) == kAudioServicesNoError){
            AudioServicesAddSystemSoundCompletion(self.soundId, CFRunLoopGetMain(), kCFRunLoopDefaultMode, SoundMuteNotificationCompletionProc,(__bridge void *)(self));
            UInt32 yes = 1;
            AudioServicesSetProperty(kAudioServicesPropertyIsUISound, sizeof(_soundId),&_soundId,sizeof(yes), &yes);
        } else {
            MMErrorWithModule(LOGMODULE, @"Create Sound Error.");
            _soundId = 0;
        }
    }
    return self;
}

- (void)checkSoundSwitchStatus:(CheckSwitchStatusCompleteBlk)completHandler {
    if (self.soundId == 0) {
        completHandler(YES);
        return;
    }
    self.completeHandler = completHandler;
    self.beginTime = CACurrentMediaTime();
    AudioServicesPlaySystemSound(self.soundId);
}

- (void)complete {
    CFTimeInterval elapsed = CACurrentMediaTime() - self.beginTime;
    BOOL isSwitchOn = elapsed > 0.1;
    if (self.completeHandler) {
        self.completeHandler(isSwitchOn);
    }
}

4、设置声音阈值

另一个用户反馈较多的问题是听不到播报声音，经过查看日志发现是触发语音播报时，用户设置的系统音量太小所致使。首先想到的解决方案是直接设置AVAudioPlayer的volume（或者是AudioQueue中的kAudioQueueParam_Volume），然而实验事后发现这样行不通，volume属性受制于系统音量（好比系统volume是0.5，AVAudioPlayer的音量是0.6，则最终的音量为0.5*0.6 =0.3）。要解决音量太小的问题，仍是须要经过调节系统音量。最终的解决方案借鉴了进入收付款展现二维码时自动调节屏幕亮度的方案：若是屏幕亮度未达到阈值，则调高屏幕亮度到阈值，离开页面时，将亮度设回原亮度。同理，播放提示音时，若用户设置的系统音量小于阈值，则调节到阈值。提示音播放完毕后，将提示音调回原音量。

控制系统音量有两种方式：

方式一：经过MPMusicPlayerController设置音量

MPMusicPlayerController *mpc = [MPMusicPlayerController applicationMusicPlayer];
//This property is deprecated -- use MPVolumeView for volume control instead.
mpc.volume = 0;  //0.0~1.0

第一种方式简单粗暴，在设置的时候会弹出系统音量提示框，若是用户在使用app的过程忽然弹出音量框，会对用户形成困扰，不建议使用这种方式，而且苹果在iOS7.0之后已将该属性标为deprecated。

方式二：经过MPVolumeView设置音量

第二种方式则是将一个看不见的MPVolumeView添加到当前视图上，系统音量提示框就不会显示了
须要注意的是，在调节完系统音量须要将MPVolumeView移除，不然后续用户手动调节音量会出现系统音量提示框不显示的状况。

调节音量的方式，则是先取到MPVolumeView中名为MPVolumeSlider的子View，并对其发送模拟用户操做的事件。

- (void)setSystemVolume:(float)volume {
    UISlider* volumeViewSlider = nil;
    for (UIView *view in [self.m_privateVoulmeView subviews]){
        if ([view.class.description isEqualToString:@"MPVolumeSlider"]){
            volumeViewSlider = (UISlider*)view;
            break;
        }
    }
    if (volumeViewSlider != nil) {
        [volumeViewSlider setValue:volume animated:NO];
        //经过send
        [volumeViewSlider sendActionsForControlEvents:UIControlEventTouchUpInside];
    }
}