适配讲解详情聚合接口

src/usecases/explainUseCase.ts

@@ -183,21 +183,29 @@ export class ExplainUseCase {
       }
     }
 
+    const playable = (variant.playable ?? variant.available) === true && Boolean(variant.audioUrl)
+    const textAvailable = variant.textAvailable ?? (variant.hasText === true || Boolean(variant.text))
+    const guideText = variant.text
+      || (language === 'yue-HK' ? mandarinText : undefined)
+      || `${this.languageLabel(language)}讲解词暂未配置。`
+
     return {
       ...exhibit,
       guideTitle: variant.title || exhibit.guideTitle,
-      guideText: language === 'yue-HK'
-        ? mandarinText || '当前讲解词暂未配置。'
-        : variant.text || `${this.languageLabel(language)}讲解词暂未配置。`,
-      audioUrl: variant.audioUrl,
+      guideText,
+      audioUrl: playable ? variant.audioUrl : undefined,
       audioDuration: variant.audioDuration,
       audioLanguage: language,
-      audioHasText: language === 'yue-HK' ? Boolean(mandarinText) : variant.hasText === true,
-      audioAvailable: variant.available === true && Boolean(variant.audioUrl),
-      audioStatus: variant.available && variant.audioUrl ? 'READY' : 'MISSING',
-      audioUnavailableReason: variant.available && variant.audioUrl
+      audioHasText: textAvailable,
+      audioText: variant.text || undefined,
+      audioTextLength: variant.textLength,
+      audioTextHash: variant.textHash,
+      audioNarrationTier: variant.narrationTier,
+      audioAvailable: playable,
+      audioStatus: variant.audioStatus || (playable ? 'READY' : 'MISSING'),
+      audioUnavailableReason: playable
         ? undefined
-        : `当前讲解暂无${this.languageLabel(language)}音频`,
+        : audioReasonToText(variant.reason || 'NO_PUBLISHED_AUDIO'),
       supportedLanguages
     }
   }
@@ -213,7 +221,27 @@ export class ExplainUseCase {
       : undefined
     const description = stopInfo.description || fallback?.description || '该讲解暂无简介。'
     const audioTarget = this.resolveStopInfoAudioTarget(stopInfo)
-    const audioAvailable = stopInfo.audioStatus === 'READY'
+    const audioVariants = Object.fromEntries(Object.values(stopInfo.languageVariants).map((variant) => [variant.lang, {
+      title: stopInfo.title,
+      text: variant.text,
+      textAvailable: variant.textAvailable,
+      textLength: variant.textLength,
+      textHash: variant.textHash,
+      audioUrl: variant.playUrl,
+      audioDuration: variant.duration,
+      format: variant.format,
+      audioId: variant.audioId,
+      narrationTier: variant.narrationTier,
+      hasText: variant.hasText,
+      enabled: variant.enabled,
+      playable: variant.playable,
+      available: variant.playable,
+      audioStatus: variant.audioStatus,
+      fallback: variant.fallback,
+      reason: variant.reason
+    }]))
+    const currentVariant = audioVariants[stopInfo.lang]
+    const audioAvailable = currentVariant?.playable === true && Boolean(currentVariant.audioUrl)
 
     return {
       ...(fallback || {}),
@@ -235,21 +263,22 @@ export class ExplainUseCase {
       size: fallback?.size,
       tags: fallback?.tags,
       guideTitle: stopInfo.title || fallback?.guideTitle,
-      guideText: stopInfo.description || fallback?.guideText || fallback?.description,
-      audioUrl: undefined,
-      audioDuration: undefined,
+      guideText: currentVariant?.text || stopInfo.description || fallback?.guideText || fallback?.description,
+      audioUrl: audioAvailable ? currentVariant?.audioUrl : undefined,
+      audioDuration: currentVariant?.audioDuration,
       audioLanguage: stopInfo.lang,
-      audioHasText: stopInfo.hasText,
-      audioText: undefined,
-      audioTextLength: undefined,
-      audioTextHash: undefined,
-      audioNarrationTier: undefined,
+      audioHasText: currentVariant?.textAvailable || stopInfo.hasText,
+      audioText: currentVariant?.text,
+      audioTextLength: currentVariant?.textLength,
+      audioTextHash: currentVariant?.textHash,
+      audioNarrationTier: currentVariant?.narrationTier,
       audioUnavailableReason: audioAvailable
         ? undefined
-        : audioReasonToText(stopInfo.reason || (stopInfo.audioStatus === 'MISSING' ? 'NO_PUBLISHED_AUDIO' : undefined)),
+        : audioReasonToText(currentVariant?.reason || stopInfo.reason || (stopInfo.audioStatus === 'MISSING' ? 'NO_PUBLISHED_AUDIO' : undefined)),
       audioAvailable,
-      audioStatus: stopInfo.audioStatus,
+      audioStatus: currentVariant?.audioStatus || stopInfo.audioStatus,
       supportedLanguages: stopInfo.supportedLanguages,
+      audioVariants,
       imageStatus: stopInfo.imageStatus,
       imageSource: stopInfo.imageSource,
       galleryUrls: stopInfo.imageStatus === 'READY' ? stopInfo.galleryUrls : [],
@@ -434,6 +463,10 @@ export class ExplainUseCase {
     throw stopInfoResult.error || new Error('讲解详情加载失败')
   }
 
+  selectExplainDetailLanguage(exhibit: MuseumExhibit, language: AudioLanguage) {
+    return this.applyLanguageVariant(exhibit, language)
+  }
+
   async loadExplainDetailText(exhibit: MuseumExhibit): Promise<ExplainTextSelection> {
     const targetType = exhibit.playTargetType || 'ITEM'
     const targetId = exhibit.playTargetId || exhibit.id