HarmonyOS 鸿蒙Next中AVPlayer里如何使用AI字幕组件？

有官方资料，但我没查到“AVPlayer + AICaptionComponent”打包成一个完整页面的官方 Demo。
目前官方能直接找到的是两块内容：

• AICaptionComponent 的独立示例，演示如何显示字幕，以及如何通过 AICaptionController.writeAudio() 手动喂 PCM 数据。AI字幕控件 AICaptionComponent API
• AVPlayer 的独立示例，演示视频播放、事件监听和外挂字幕，不包含 AI 字幕控件接入。AVPlayer 视频播放 AVPlayer API

关键结论

1. AICaptionComponent 可以用于音视频场景

官方 API 明确写了，AI 字幕组件适用于“音乐类、视频类等音视频内容 App”。AICaptionComponent API

2. 从 API 18 开始，isShown: true 支持“自动识别应用音频生成字幕”

这点非常关键。官方在 AICaptionComponent 参数说明里写明：

• isShown = true：显示字幕
• 从 5.1.0(18) 开始支持自动识别应用音频生成字幕
  见：AICaptionComponent API

这意味着如果你是 AVPlayer 播放视频，最值得先试的方案不是自己喂 PCM，而是：

• 页面上叠一个 AICaptionComponent
• 打开显示状态
• 让它自动识别当前应用播放出来的音频

3. writeAudio() 是“手动喂音频流”方案，而且要求很严

官方要求手动写入的音频必须是：

• pcm
• 16000 采样率
• 单声道
• 16bit
• 每次 640 或 1280 字节
  见：AICaptionComponent API

而且官方还明确写了：

• 调用 writeAudio() 后，会停止自动获取应用音频生成字幕，以后以你写入的音频流为准。AICaptionComponent API

4. AVPlayer 本身没有给你“PCM 回调接口”

我查了 AVPlayer API，它提供的是：

• 播放控制
• 状态事件
• 进度事件
• 视频尺寸
• 外挂字幕等

但没有直接给你一条“取当前播放音频 PCM 数据”的 ArkTS 回调接口。AVPlayer API

所以如果你想走 writeAudio() 方案，通常不能直接从 AVPlayer 无缝拿 PCM。

所以怎么接最合理

方案 A：优先用“自动识别应用音频”

这是最适合 AVPlayer 的接法。

思路是：

1. 正常用 AVPlayer 播视频
2. 页面上叠加 AICaptionComponent
3. isShown = true
4. 不调用 writeAudio()

这样让 AI 字幕组件自动识别当前应用播放出来的音频。

最小接法示意

import { media } from '@kit.MediaKit';
import { AICaptionComponent, AICaptionController, AICaptionOptions, AICaptionFontSize } from '@kit.SpeechKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  private avPlayer?: media.AVPlayer;
  private captionController: AICaptionController = new AICaptionController();
  private captionOptions?: AICaptionOptions;

  @State isCaptionShown: boolean = true;
  @State surfaceId: string = '';

  async aboutToAppear() {
    this.captionOptions = {
      initialOpacity: 1,
      sourceLanguage: 'zh',
      targetLanguage: 'zh',
      fontSize: AICaptionFontSize.NORMAL,
      onPrepared: () => {
        console.info('caption prepared');
      },
      onError: (err: BusinessError) => {
        console.error(`caption error: ${err.code} ${err.message}`);
      }
    };

    this.avPlayer = await media.createAVPlayer();
    this.avPlayer.on('error', (err: BusinessError) => {
      console.error(`player error: ${err.code} ${err.message}`);
    });
  }

  async startPlay(url: string) {
    if (!this.avPlayer || !this.surfaceId) {
      return;
    }
    this.avPlayer.url = url;
    this.avPlayer.surfaceId = this.surfaceId;
    await this.avPlayer.prepare();
    await this.avPlayer.play();
  }

  build() {
    Stack() {
      XComponent({
        id: 'videoSurface',
        type: XComponentType.SURFACE,
        controller: new XComponentController()
      })
      .onLoad(() => {
        // 这里获取 surfaceId
        // this.surfaceId = ...
      })
      .width('100%')
      .height('100%')

      AICaptionComponent({
        isShown: this.isCaptionShown,
        controller: this.captionController,
        options: this.captionOptions
      })
      .width('100%')
      .height(120)
      .align(Alignment.Bottom)
    }
    .width('100%')
    .height('100%')
  }
}

这不是官方现成 Demo，但它是基于官方两份文档最合理的组合方式。AI字幕控件 AVPlayer 视频播放

方案 B：手动 writeAudio() 喂 PCM

这个只适合你满足下面条件时：

• 你的音频源不是直接来自 AVPlayer
• 或你自己有解码链路
• 能稳定拿到符合 AI 字幕要求的 PCM 数据

因为官方 AICaptionController.getAudioInfo() / writeAudio() 就是为这种模式准备的。AICaptionComponent API

但如果你现在只是普通 AVPlayer 播 MP4，这条路通常不如方案 A 直接。

你还要注意两点

1. 不是所有字幕都该用 AI 字幕

如果视频本身已经有外挂字幕/内封字幕，AVPlayer 其实已经支持外挂字幕能力：

• addSubtitleFromFd
• addSubtitleFromUrl
• on('subtitleUpdate')
  见：AVPlayer API 和 使用AVPlayer添加视频外挂字幕

所以：

• 已有字幕文件：优先 AVPlayer 字幕
• 没有字幕文件，想实时识别：用 AICaptionComponent

2. AI 字幕是识别“音频内容”，不是读视频轨本身

所以它对音频质量、语言、设备能力都会有影响。官方给的 AICaptionOptions 也支持源语言、目标语言和字体设置。AICaptionComponent API

最后直接回答你

AVPlayer 里如何使用 AICaptionComponent？

最推荐做法是：

• AVPlayer 负责播放
• AICaptionComponent 叠在视频层上
• isShown = true
• 先不要调用 writeAudio()
• 先验证“自动识别应用音频”是否满足需求

有没有官方 Demo？

• 没有查到官方现成的 AVPlayer + AICaptionComponent 一体 Demo
• 官方只有：
  • AICaptionComponent 独立示例
  • AVPlayer 独立示例
    你需要把两者拼起来用。AI字幕控件 AVPlayer 视频播放

把这两个案例结合一下：

https://gitcode.com/HarmonyOS_Samples/sample-code_-aicaption-arkts

https://gitcode.com/HarmonyOS_Samples/avplayer-short-video