項目為使用uniapp框架開發的Android/iOS APP應用

實現功能需求

假設手機正在播放音樂，當前APP處于前臺收到消息，需播放提示音提示用戶。目標為降低后臺正在播放音樂的音量，播放提示音，播放完畢后恢復后臺音樂音量

需求分析

乍一看，需求看似很簡單，實則以目前uni官方所封裝的API根本無法實現，附上鏈接uni.createInnerAudioContext，該API中的sessionCategory配置，實則為當前APP的音頻模式，播放的時候影響到其他APP的行為只有一個結果——暫停
很明顯，這并非我們能接受的結果，只能另尋他路，既然uni不行，那就只能靠native.js調用原生方法了

查閱文檔

博主找遍了uni官方的文檔、論壇，找不到任何相關的功能實現文章。無奈，只能查原生文檔，Android、iOS，在閱讀了大量原生實現文章后，注意到一個關鍵詞——音頻焦點，就是說后續的編碼均是圍繞著音頻焦點而開展的

Android端

Android端的實現，需要使用到AudioManager、MediaPlayer、AudioAttributes這三個類，首先AudioManager實例需要使用Context去獲取

MediaPlayer類則直接import后new一個新實例就可以了，AudioAttributes則用來設置所播放音頻的屬性。最后，還有一個音頻播放結束后釋放音頻焦點的監聽方法，這個在Java中為Interface接口方法——MediaPlayer.OnCompletionListener
參考鏈接：AudioManager類、MediaPlayer類、AudioAttributes類、
MediaPlayer.OnCompletionListener接口

<script> export default {data() {return {audioManager: null, // 音頻管理innerAudioContext: {}, // 播放器實例audioFocus: false // 音頻焦點}},created() {this.buildAudio();},methods: {buildAudio() {let path = plus.io.convertLocalFileSystemURL('xxx/voice.mp3');if (this.$store.state.platform == 'android') {// Android端// 導入聲音管理類（必須步驟，不引會導致功能無法正常運行）plus.android.importClass('android.media.AudioManager');let main = plus.android.runtimeMainActivity(); // 獲取應用主Activity實例對象let Context = plus.android.importClass('android.content.Context'); // 全局上下文this.audioManager = main.getSystemService(Context.AUDIO_SERVICE);let MediaPlayer = plus.android.importClass('android.media.MediaPlayer');let AudioAttributes = plus.android.importClass('android.media.AudioAttributes');this.innerAudioContext = new MediaPlayer();// Android中的接口實現使用plus.android.implements，注意接口名稱類與接口方法之間要用符號$連接let event = plus.android.implements('android.media.MediaPlayer$OnCompletionListener', {onCompletion: () => {if (this.audioFocus) {this.audioManager.abandonAudioFocus(null); // 放棄音頻焦點this.audioFocus = false;}}});this.innerAudioContext.setOnCompletionListener(event); // 設置播放完畢監聽this.innerAudioContext.setDataSource(path); // 設置播放器播放音頻this.innerAudioContext.setAudioAttributes(AudioAttributes.CONTENT_TYPE_SONIFICATION); // 設置音頻屬性，CONTENT_TYPE_SONIFICATION為短暫提示音this.innerAudioContext.prepare();} else {// iOS端...}}} } </script>

需要播放音頻時，則判斷一下后臺是否播放著音樂，若正在播放，則請求音頻焦點，設置系統類型為音樂類型（STREAM_MUSIC），設置持續時間提示為短暫打斷模式（AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK）

if (this.$store.state.platform === 'android') {// Android端if (this.audioManager.isMusicActive()) {// 判斷是否正在播放音樂this.audioFocus = true;this.audioManager.requestAudioFocus(null, this.audioManager.STREAM_MUSIC, this.audioManager.AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK); // 請求音頻聚焦}this.innerAudioContext.start(); // 播放 } else {// iOS端... }

iOS端

iOS端的實現，需要用到AVAudioSession、NSData、AVAudioPlayer這三個類，其中AVAudioSession需要使用sharedInstance獲取分享音頻會話實例

NSData用于轉換本地文件路徑為二進制數據，供AVAudioPlayer類實例用于初始化播放器。最后，還需要掛載播放完畢的代理方法AVAudioPlayerDelegate，用于在音頻播放結束后設置音頻會話激活狀態（相當于Android端的釋放音頻焦點）為false
參考鏈接：AVAudioSession類、AVAudioPlayer類、NSData類、
AVAudioPlayerDelegate代理

<script> export default {methods: {buildAudio() {let path = plus.io.convertLocalFileSystemURL('xxx/voice.mp3');if (this.$store.state.platform == 'android') {// Android端...} else {// iOS端let AVAudioSession = plus.ios.importClass('AVAudioSession');this.audioManager = AVAudioSession.sharedInstance(); // 獲取分享音頻會話實例/*** 設置音頻會話類型為AVAudioSessionCategoryPlayback，同時配置選項為AVAudioSessionCategoryOptionMixWithOthers和AVAudioSessionCategoryOptionDuckOthers* Constants that specify optional audio behaviors. setCategory:withOptions:error* setCategory:(AVAudioSessionCategory)category:* @param AVAudioSessionCategoryPlayback The category for playing recorded music or other sounds that are central to the successful use of your app.* withOptions:(AVAudioSessionCategoryOptions)options:* @param AVAudioSessionCategoryOptionMixWithOthers = 0x1 An option that indicates whether audio from this session mixes with audio from active sessions in other audio apps.* @param AVAudioSessionCategoryOptionDuckOthers = 0x2 An option that reduces the volume of other audio sessions while audio from this session plays.*/this.audioManager.setCategorywithOptionserror('AVAudioSessionCategoryPlayback', 0x1 | 0x2, null);let NSData = plus.ios.importClass('NSData');let AVAudioPlayer = plus.ios.importClass('AVAudioPlayer');let pathFileData = NSData.dataWithContentsOfFile(path); // 音頻文件轉為二進制數據this.innerAudioContext = new AVAudioPlayer(); // new一個音頻播放器實例this.innerAudioContext.initWithDataerror(pathFileData, null); // 初始化數據// iOS中掛載代理方法使用plus.ios.implements，注意掛載的方法名需一個字符不差寫完整audioPlayerDidFinishPlaying:successfully:let delegate = plus.ios.implements('AVAudioPlayerDelegate', {'audioPlayerDidFinishPlaying:successfully:': () => {if (this.audioFocus) {/*** 設置音頻會話激活狀態（相當于Android端的音頻焦點）為false，同時配置選項為AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation，用于通知其他被中斷的APP恢復播放* Activates or deactivates your app’s audio session using the specified options. setActive:withOptions:error* setActive:(BOOL)active:* Specify YES to activate your app’s audio session, or NO to deactivate it.（Objective-C中的YES相當于JS的true，NO相當于false）* withOptions:(AVAudioSessionSetActiveOptions)options:* @param AVAudioSessionSetActiveOptionNotifyOthersOnDeactivation = 1 An option that indicates that the system should notify other apps that you’ve deactivated your app’s audio session.*/this.audioManager.setActivewithOptionserror(false, 1, null);this.audioFocus = false;}}});this.innerAudioContext.plusSetAttribute('delegate', delegate); // 使用plusSetAttribute設置實例對象屬性delegate}}} } </script>

接下來是音頻播放，跟Android端差不多，iOS端這邊是激活音頻會話

if (this.$store.state.platform === 'android') {// Android端... } else {// iOS端if (this.audioManager.plusGetAttribute('isOtherAudioPlaying')) {// 獲取判斷音頻會話屬性isOtherAudioPlayingthis.audioFocus = true;this.audioManager.setActiveerror(true, null); // 激活音頻會話}this.innerAudioContext.play(); // 播放 }

總結

編碼完畢，實際上手調試，在后臺其他APP（如音樂播放器）正在播放音樂時，本APP播放提示音，在Android/iOS兩端都是表現為降低音樂音量，播放提示音，提示音播放完畢后，恢復音樂音量。
至此，已完美完成需求，這里簡單說一下本功能的開發感受：uni官方沒有實現的功能，確實通過H5+plus絕大部分功能都是可以實現的，但對于沒人寫過參考的功能，就只能靠自己查閱原生開發文檔、查閱原生開發相關代碼，之后嘗試使用native.js改寫，這整套流程下來，對一個純前端開發而言確實不容易。但是，博主認為這個過程是收獲頗豐的，也是讓人有成就感的，畢竟全網第一份。
就說這么多了，Keep learning…

總結

以上是生活随笔為你收集整理的uniapp实现音频播放抢占系统音频焦点的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。