feat: 添加下载 AI 原声翻译音轨功能

- 在视频下载功能中支持选择音轨
- 更新相关数据结构以包含音轨信息
- 修改界面以显示可用音轨选项

Author: EricZhou05

registry/lib/components/video/download/DownloadVideo.vue

@@ -37,6 +37,15 @@
           @change="saveSelectedQuality()"
         />
       </div>
+      <div v-if="audioTracks && audioTracks.length > 0" class="download-video-config-item">
+        <div class="download-video-config-title">AI 原声翻译:</div>
+        <VDropdown
+          v-model="selectedAudioTrack"
+          :items="audioTrackOptions"
+          value-key="name"
+          @change="saveSelectedAudioTrack()"
+        />
+      </div>
       <template v-if="!testData.multiple && selectedQuality">
         <div v-if="testData.videoInfo" class="download-video-config-description">
           预计大小: {{ formatFileSize(testData.videoInfo.totalSize) }}
@@ -166,6 +175,8 @@ const getFallbackTestVideoInfo = () =>
     title: getFriendlyTitle(true),
   } as DownloadVideoInputItem)
 
+const DEFAULT_AUDIO_TRACK = { name: '', displayName: '原声' }
+
 export default Vue.extend({
   components: {
     VPopup,
@@ -199,6 +210,8 @@ export default Vue.extend({
       assets,
       qualities: [],
       selectedQuality: undefined,
+      audioTracks: [],
+      selectedAudioTrack: undefined,
       inputs: [],
       selectedInput: undefined,
       apis: [],
@@ -220,12 +233,19 @@ export default Vue.extend({
       }
       return this.qualities
     },
+    audioTrackOptions() {
+      const options = this.audioTracks.map(t => ({ name: t.id, displayName: t.name }))
+      if (options.length > 0) {
+        options.unshift(DEFAULT_AUDIO_TRACK)
+      }
+      return options
+    },
     canStartDownload() {
       if (this.busy || !this.open) {
         return false
       }
       const isAnySelectionEmpty = Object.entries(this)
-        .filter(([key]) => key.startsWith('selected'))
+        .filter(([key]) => key.startsWith('selected') && key !== 'selectedAudioTrack')
         .some(([, value]) => !value)
       if (isAnySelectionEmpty) {
         return false
@@ -289,6 +309,11 @@ export default Vue.extend({
       basicConfig.quality = quality.value
       this.updateTestVideoInfo()
     },
+    saveSelectedAudioTrack() {
+      // 避免冗余请求：这里不再使用引用对比，依赖 VDropdown 的 value-key="name" 属性
+      // 它能够正确阻止触发不需要的 change 事件
+      this.updateTestVideoInfo()
+    },
     async getVideoItems() {
       const input = this.selectedInput as DownloadVideoInput
       const videoItems = await input.getInputs(this.$refs.inputOptions)
@@ -307,6 +332,8 @@ export default Vue.extend({
       try {
         const videoInfo = await api.downloadVideoInfo(testItem)
         this.qualities = videoInfo.qualities
+        this.audioTracks = videoInfo.audioTracks || []
+
         const isSelectedQualityOutdated =
           !this.selectedQuality ||
           !videoInfo.qualities.some(q => q.value === this.selectedQuality.value)
@@ -319,8 +346,22 @@ export default Vue.extend({
             }
           }
         }
+
+        const isSelectedAudioTrackOutdated =
+          !this.selectedAudioTrack ||
+          (this.selectedAudioTrack.name !== '' &&
+            !this.audioTracks.some(t => t.id === this.selectedAudioTrack.name))
+
+        if (isSelectedAudioTrackOutdated) {
+          if (this.audioTracks.length > 0) {
+            this.selectedAudioTrack = DEFAULT_AUDIO_TRACK
+          } else {
+            this.selectedAudioTrack = undefined
+          }
+        }
         // 填充 quality 后要再请求一次得到对应 quality 的统计数据
         testItem.quality = this.selectedQuality
+        testItem.audioTrack = this.selectedAudioTrack?.name
         const qualityVideoInfo = await api.downloadVideoInfo(testItem)
         this.testData.videoInfo = qualityVideoInfo
         console.log('[qualityVideoInfo]', qualityVideoInfo)
@@ -341,6 +382,7 @@ export default Vue.extend({
         }
         videoInputs.forEach(item => {
           item.quality = this.selectedQuality
+          item.audioTrack = this.selectedAudioTrack?.name
         })
         const videoInfos = await Promise.all(videoInputs.map(i => api.downloadVideoInfo(i)))
         if (videoInfos.length === 0 || lodash.sumBy(videoInfos, it => it.fragments.length) === 0) {

registry/lib/components/video/download/apis/dash.ts

@@ -8,6 +8,7 @@ import { Options } from '..'
 import { compareQuality } from '../error'
 import {
   DownloadVideoApi,
+  DownloadVideoAudioTrack,
   DownloadVideoFragment,
   DownloadVideoInfo,
   DownloadVideoInputItem,
@@ -115,8 +116,8 @@ const downloadDash = async (
     audio: () => true,
     ...filters,
   }
-  const { aid, cid, quality } = input
-  const params = {
+  const { aid, cid, quality, audioTrack } = input
+  const params: Record<string, string | number> = {
     avid: aid,
     cid,
     qn: quality?.value ?? '',
@@ -125,6 +126,9 @@ const downloadDash = async (
     fnver: 0,
     fnval: 4048,
   }
+  if (audioTrack) {
+    params.cur_language = audioTrack
+  }
   const isBanugmi = bangumiUrls.some(url => matchUrlPattern(url))
   const api = isBanugmi ? bangumiApi(formData(params)) : videoApi(formData(params))
   const data = await bilibiliApi(getJsonWithCredentials(api), '获取视频链接失败')
@@ -219,6 +223,13 @@ const downloadDash = async (
   })()
   const currentCodec = fragments.find(x => x.type === 'video')?.codec
   const currentBandWidth = fragments.reduce((p, c) => p + c.bandWidth, 0)
+  let audioTracks: DownloadVideoAudioTrack[] | undefined
+  if (data.language?.items?.length) {
+    audioTracks = data.language.items.map((item: any) => ({
+      id: item.lang,
+      name: item.title,
+    }))
+  }
   const info = new DownloadVideoInfo({
     input,
     jsonData: data,
@@ -227,6 +238,7 @@ const downloadDash = async (
     currentQuality,
     currentCodec,
     currentBandWidth,
+    audioTracks,
   })
   compareQuality(input, info)
   return info

registry/lib/components/video/download/types.ts

@@ -19,6 +19,12 @@ export interface DownloadVideoInputItem {
   quality?: VideoQuality
   /** 是否允许画质回退, 当实际画质和期望画质不符时此项将决定是否抛出异常 */
   allowQualityDrop?: boolean
+  /** 请求的音轨语言 */
+  audioTrack?: string
+}
+export interface DownloadVideoAudioTrack {
+  id: string
+  name: string
 }
 /** 页面数据提供者 */
 export interface DownloadVideoInput<InputParameter = any> extends VueInstanceInput, WithName {
@@ -50,6 +56,7 @@ export class DownloadVideoInfo {
   public currentQuality: VideoQuality
   public currentCodec?: string
   public currentBandWidth?: number
+  public audioTracks?: DownloadVideoAudioTrack[]
   public jsonData: any
   constructor(
     parameters: Omit<DownloadVideoInfo, 'totalSize' | 'totalLength' | 'titledFragments'>,

src/ui/VDropdown.vue

@@ -89,6 +89,10 @@ export default Vue.extend({
       type: Function,
       default: (item: any) => item.name,
     },
+    valueKey: {
+      type: String,
+      default: '',
+    },
     round: {
       type: Boolean,
       default: false,
@@ -118,7 +122,14 @@ export default Vue.extend({
   },
   methods: {
     selectItem(item: any) {
-      if (item !== this.value) {
+      let isChanged = false
+      if (this.valueKey && item && this.value) {
+        isChanged = item[this.valueKey] !== this.value[this.valueKey]
+      } else {
+        isChanged = item !== this.value
+      }
+
+      if (isChanged) {
         this.$emit('change', item)
       }
       this.popupOpen = false