From b8ab414baceb165449752f7e1b5195aa84ded6a6 Mon Sep 17 00:00:00 2001
From: lyf <2514544224@qq.com>
Date: Fri, 17 Jul 2026 23:08:45 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=AE=B2=E8=A7=A3=E8=AF=A6?=
 =?UTF-8?q?=E6=83=85=E9=A1=B5=E9=80=80=E5=87=BA=E9=9F=B3=E9=A2=91=E6=B8=85?=
 =?UTF-8?q?=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/pages/exhibit/detail.vue               | 21 ++++++++++++----
 tests/unit/ExhibitDetailAudioFirst.spec.ts | 29 +++++++++++++++++++++-
 2 files changed, 44 insertions(+), 6 deletions(-)

diff --git a/src/pages/exhibit/detail.vue b/src/pages/exhibit/detail.vue
index 24d1f96..d00102f 100644
--- a/src/pages/exhibit/detail.vue
+++ b/src/pages/exhibit/detail.vue
@@ -134,8 +134,8 @@
 </template>
 
 <script setup lang="ts">
-import { computed, ref, watch } from 'vue'
-import { onLoad, onUnload } from '@dcloudio/uni-app'
+import { computed, onBeforeUnmount, ref, watch } from 'vue'
+import { onHide, onLoad, onUnload } from '@dcloudio/uni-app'
 import GuidePageFrame from '@/components/navigation/GuidePageFrame.vue'
 import type { AudioItem } from '@/components/audio/AudioPlayer.vue'
 import { useGlobalAudioPlayer } from '@/composables/useGlobalAudioPlayer'
@@ -305,6 +305,14 @@ const isCurrentDetailAudioTarget = computed(() => {
     && source.targetId === targetId
   )
 })
+let detailAudioClosedOnExit = false
+
+const closeDetailAudioOnExit = () => {
+  if (detailAudioClosedOnExit || !isCurrentDetailAudioTarget.value) return
+
+  detailAudioClosedOnExit = true
+  globalAudioPlayer.close()
+}
 const audioDockTitle = computed(() => displayTitle.value || '讲解内容')
 const formatDetailAudioTime = (seconds?: number) => {
   const normalizedSeconds = Number.isFinite(seconds || 0)
@@ -482,6 +490,7 @@ const loadExplainDetail = async (
 }
 
 onLoad(async (options: any = {}) => {
+  detailAudioClosedOnExit = false
   const tab = Array.isArray(options.tab) ? options.tab[0] : options.tab
   if (isGuideTopTab(tab)) {
     activeTopTab.value = tab
@@ -525,9 +534,10 @@ onLoad(async (options: any = {}) => {
   }
 })
 
-onUnload(() => {
-  globalAudioPlayer.close()
-})
+// iOS H5 may hide a uni page before its route is fully unloaded.
+onHide(closeDetailAudioOnExit)
+onUnload(closeDetailAudioOnExit)
+onBeforeUnmount(closeDetailAudioOnExit)
 
 const detailTextFor = (lang: AudioLanguage) => {
   return detailTextByLanguage.value[lang] || fallbackTextForLanguage(lang)
@@ -908,6 +918,7 @@ const fallbackToExplainObjectList = () => {
 }
 
 const returnToExplainObjectList = () => {
+  closeDetailAudioOnExit()
   const pages = getCurrentPages()
   const previousPage = pages[pages.length - 2] as ExplainDetailPageStackEntry | undefined
   if (previousPage?.route === 'pages/explain/guide-stop-list') {
diff --git a/tests/unit/ExhibitDetailAudioFirst.spec.ts b/tests/unit/ExhibitDetailAudioFirst.spec.ts
index ff2bc6f..bf6d8e7 100644
--- a/tests/unit/ExhibitDetailAudioFirst.spec.ts
+++ b/tests/unit/ExhibitDetailAudioFirst.spec.ts
@@ -6,6 +6,8 @@ import { flushPromises, mount } from '@vue/test-utils'
 
 const mocks = vi.hoisted(() => ({
   onLoadHandler: null as null | ((options?: Record<string, unknown>) => Promise<void>),
+  onHideHandler: null as null | (() => void),
+  onUnloadHandler: null as null | (() => void),
   enterExplainDetail: vi.fn(),
   loadExplainDetailText: vi.fn(),
   selectAudioForExplainDetail: vi.fn(),
@@ -30,7 +32,12 @@ vi.mock('@dcloudio/uni-app', () => ({
   onLoad: (handler: (options?: Record<string, unknown>) => Promise<void>) => {
     mocks.onLoadHandler = handler
   },
-  onUnload: () => undefined
+  onHide: (handler: () => void) => {
+    mocks.onHideHandler = handler
+  },
+  onUnload: (handler: () => void) => {
+    mocks.onUnloadHandler = handler
+  }
 }))
 
 vi.mock('@/usecases/explainUseCase', () => ({
@@ -93,6 +100,8 @@ const exhibit = {
 describe('讲解详情音频优先布局', () => {
   beforeEach(() => {
     mocks.onLoadHandler = null
+    mocks.onHideHandler = null
+    mocks.onUnloadHandler = null
     audioState.currentAudio.value = null
     audioState.currentSource.value = null
     audioState.playing.value = false
@@ -301,6 +310,24 @@ describe('讲解详情音频优先布局', () => {
     expect(uni.redirectTo).not.toHaveBeenCalled()
   })
 
+  it('离开详情页时立即关闭当前讲解播放器', async () => {
+    audioState.currentAudio.value = { id: 'audio-1', audioUrl: exhibit.audioUrl }
+    audioState.currentSource.value = { targetType: 'STOP', targetId: 'stop-1', lang: 'en-US' }
+    const wrapper = mount(ExhibitDetail, {
+      global: { stubs: { GuidePageFrame: GuidePageFrameStub } }
+    })
+
+    await mocks.onLoadHandler?.({ id: exhibit.id, lang: 'en-US', targetType: 'STOP', targetId: 'stop-1' })
+    await flushPromises()
+
+    mocks.onHideHandler?.()
+    mocks.onUnloadHandler?.()
+    wrapper.getComponent(GuidePageFrameStub).vm.$emit('back')
+    await flushPromises()
+
+    expect(mocks.close).toHaveBeenCalledTimes(1)
+  })
+
   it('深链详情按展厅上下文回退至讲解对象列表', async () => {
     const wrapper = mount(ExhibitDetail, {
       global: { stubs: { GuidePageFrame: GuidePageFrameStub } }