uniapp语音播放Android端细节进阶实现

承接上回语音功能的实现《uniapp实现语音播放功能》，仍存在有瑕疵，问题如下：
1. 语音播放时，会直接打断后台正在播放的音乐，播放完毕无自动恢复音乐
2. 语音播放的输出（耳机/扬声器）全凭各种品牌手机的实现，不可控

基于此，博主又深入研究了一下，目前实现了Android端的优化方案，暂无iOS端 o(╥﹏╥)o

背景

首先，语音播放打断音乐的解决方案，在上一篇博客《uniapp实现音频播放抢占系统音频焦点》中已解决，实现的细节均已清晰指明。
由于音频的初始化加载，由原来的plus.audio.createPlayer转为使用android.media.MediaPlayer类来实现，引出问题3. 音频输出频道（扬声器/听筒）的切换问题

初始化播放器

先声明相关变量

data() {return {voicePlayer: null, // 语音播放器watchProximity: null, // 设备距离监听器sessionPlayMode: 0, // 语音播放模式 0扬声器 1听筒wakeLock: null, // Android端唤醒锁audioManager: null, // Android音频管理器audioFocus: false // 音频聚焦状态}
},
onLoad() {plus.android.importClass('android.media.AudioManager');
}

初始化播放器

async initPlayer(src) {return new Promise((resolve) => {let path = plus.io.convertLocalFileSystemURL(src); // 本地文件路径转为系统路径// 用于判断文件是否存在plus.io.resolveLocalFileSystemURL(path,() => {console.log('路径', path);let MediaPlayer = plus.android.importClass('android.media.MediaPlayer');let AudioAttributes = plus.android.importClass('android.media.AudioAttributes');this.voicePlayer = new MediaPlayer();let completionCB = plus.android.implements('android.media.MediaPlayer$OnCompletionListener', {onCompletion: () => {this.voicePlayEnded(); // 语音播放完毕}});this.voicePlayer.setOnCompletionListener(completionCB);this.voicePlayer.setDataSource(path);this.voicePlayer.setAudioAttributes(AudioAttributes.CONTENT_TYPE_SPEECH); // 设置类型为语音resolve(true);},(err) => {// 文件获取失败console.log('文件获取失败，请重新获取', err);// 释放唤醒锁if (this.wakeLock) {this.wakeLock.release();this.wakeLock = null;}// 销毁正在监听设备距离的监听器if (this.watchProximity) {plus.proximity.clearWatch(this.watchProximity);this.watchProximity = null;}resolve(false);});});
}

播放语音

async playVoice(src) {console.log('播放地址', src);if (!(await this.initPlayer(src))) {return;}let main = plus.android.runtimeMainActivity();let Context = plus.android.importClass('android.content.Context');this.audioManager = main.getSystemService(Context.AUDIO_SERVICE);// 判断是否有音乐播放，若存在音乐播放，把音频聚焦到语音上let isMusicActive = this.audioManager.isMusicActive();if (isMusicActive) {this.audioFocus = true;// 请求音频焦点，暂停音乐播放，待语音播放完毕后恢复this.audioManager.requestAudioFocus(null, this.audioManager.STREAM_MUSIC, this.audioManager.AUDIOFOCUS_GAIN_TRANSIENT);}// 设置播放模式let headsetStatus = false;let AudioDeviceInfo = plus.android.importClass('android.media.AudioDeviceInfo');let audioDevices = this.audioManager.getDevices(this.audioManager.GET_DEVICES_OUTPUTS);// 判断设备类型for (let deviceInfo of audioDevices) {let status = plus.android.invoke(deviceInfo, 'getType');if (status == AudioDeviceInfo.TYPE_WIRED_HEADPHONES ||status == AudioDeviceInfo.TYPE_WIRED_HEADSET ||status == AudioDeviceInfo.TYPE_BLUETOOTH_A2DP ||status == AudioDeviceInfo.TYPE_BLUETOOTH_SCO) {headsetStatus = true;}}if (headsetStatus) {// 有耳机this.audioManager.setSpeakerphoneOn(false);this.audioManager.setMode(this.audioManager.MODE_NORMAL);this.voicePlayer.setAudioStreamType(this.audioManager.STREAM_MUSIC);} else {// 无耳机if (!this.sessionPlayMode) {// 扬声器this.audioManager.setSpeakerphoneOn(true);this.audioManager.setMode(this.audioManager.MODE_NORMAL);this.voicePlayer.setAudioStreamType(this.audioManager.STREAM_MUSIC);// 扬声器模式下，需要监听距离对声道进行实时修改this.watchProximity = plus.proximity.watchProximity((distance) => {// Android端接近为0，远离为5this.voicePlayer.pause();if (distance !== 0) {// 扬声器this.audioManager.setSpeakerphoneOn(true);this.audioManager.setMode(this.audioManager.MODE_NORMAL);} else {// 听筒this.voicePlayer.seekTo(0); // 播放进度调回0this.audioManager.setSpeakerphoneOn(false);this.audioManager.setMode(this.audioManager.MODE_IN_COMMUNICATION);}this.voicePlayer.start();});} else {// 听筒this.audioManager.setSpeakerphoneOn(false);this.audioManager.setMode(this.audioManager.MODE_IN_COMMUNICATION);this.voicePlayer.setAudioStreamType(this.audioManager.STREAM_VOICE_CALL);}// Android端需要设置唤醒模式才能在接近传感器激活时关闭屏幕let PowerManager = plus.android.importClass('android.os.PowerManager');let pm = main.getSystemService(Context.POWER_SERVICE);// 32代表PROXIMITY_SCREEN_OFF_WAKE_LOCK，唤醒锁定电平：当接近传感器激活时关闭屏幕let wakeStatus = pm.isWakeLockLevelSupported(PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK);// 系统支持该唤醒模式if (wakeStatus) {this.wakeLock = pm.newWakeLock(PowerManager.PROXIMITY_SCREEN_OFF_WAKE_LOCK, 'TAG');this.wakeLock.acquire();}}this.voicePlayer.prepare();this.voicePlayer.start();
}

语音播放完毕

voicePlayEnded() {// 销毁正在监听设备距离的监听器if (this.watchProximity) {plus.proximity.clearWatch(this.watchProximity);this.watchProximity = null;}// 释放唤醒锁if (this.wakeLock) {this.wakeLock.release();this.wakeLock = null;}// 放弃系统音频焦点if (this.audioFocus) {this.audioManager.setMode(this.audioManager.MODE_NORMAL);this.audioManager.abandonAudioFocus(null);this.audioFocus = false;}// 释放资源this.voicePlayer.release();this.voicePlayer = null;
}

分析总结

上述代码片段基本实现了语音播放的各种细节，以及解决文章开头的三个问题，调用仅需要this.playVoice('xxx')传入语音文件路径即可。
针对问题1，使用音频焦点的请求聚焦及放弃，在播放音频时聚焦设置其持续时间为AUDIOFOCUS_GAIN_TRANSIENT，用于指示临时增益或音频焦点的请求，预计会持续很短的时间；
针对问题2，使用音频管理类的getDevices方法获取GET_DEVICES_OUTPUTS输出设备，配合AudioDeviceInfo类，判断输出设备的类型是否为耳机，最后配合问题3的解决方案即可实现耳机/扬声器的切换控制；
针对问题3，使用音频管理类的setSpeakerphoneOn、setMode方法来控制音频切换扬声器/听筒。
至此问题已全部解决，完美实现Android端的语音播放功能，继续加油吧…

附上参考链接：AudioManager类、MediaPlayer类、AudioAttributes类、AudioDeviceInfo类