往期鸿蒙全套实战文章必看：

• 鸿蒙开发核心知识点，看这篇文章就够了

• 最新版！鸿蒙HarmonyOS Next应用开发实战学习路线

• 鸿蒙HarmonyOS NEXT开发技术最全学习路线指南

• 鸿蒙应用开发实战项目，看这一篇文章就够了（部分项目附源码）

添加视频外挂字幕

当前仅支持视频播放前设置外挂字幕。

在进行应用开发的过程中，开发者可以通过AVPlayer的实例注册on('subtitleUpdate')方法监听字幕信息。

开发步骤及注意事项

使用视频播放的AVPlayer实例设置外挂字幕资源。

1. let context = getContext(this) as common.UIAbilityContext
   let fileDescriptor = await context.resourceManager.getRawFd('xxx.srt')
   
   avPlayer.addSubtitleFromFd(fileDescriptor.fd, fileDescriptor.offset, fileDescriptor.length)
   
   // 或者使用addSubtitleFromUrl接口
   let fdUrl:string = "http://xxx.xxx.xxx.xxx:xx/xx/index.srt" 
   avPlayer.addSubtitleFromUrl(fdUrl)

2. 使用视频播放的AVPlayer实例注册字幕回调函数。

   avPlayer.on('subtitleUpdate', (info: media.SubtitleInfo) => {
     if (!!info) {
       let text = (!info.text) ? '' : info.text
       let startTime = (!info.startTime) ? 0 : info.startTime
       let duration = (!info.duration) ? 0 : info.duration
       console.info('subtitleUpdate info: text=' + text + ' startTime=' + startTime +' duration=' + duration)
     } else {
       console.info('subtitleUpdate info is null')
     }
   })

3. (可选)当需要不显示字幕的时候，使用视频播放的AVPlayer实例注销字幕回调函数。

   avPlayer.off('subtitleUpdate')

完整示例

import { media } from '@kit.MediaKit';
import { common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export class AVPlayerSubtitleDemo {
  private avPlayer: media.AVPlayer | undefined = undefined;
  // 注册avplayer回调函数
  setAVPlayerCallback(avPlayer: media.AVPlayer) {
    // error回调监听函数,当avPlayer在操作过程中出现错误时调用reset接口触发重置流程
    avPlayer.on('error', (err: BusinessError) => {
      console.error(`Invoke avPlayer failed, code is ${err.code}, message is ${err.message}`)
      avPlayer.reset() // 调用reset重置资源，触发idle状态
    })
    // 注册字幕回调函数
    avPlayer.on('subtitleUpdate', (info: media.SubtitleInfo) => {
      if (info) {
        let text = (!info.text) ? '' : info.text
        let startTime = (!info.startTime) ? 0 : info.startTime
        let duration = (!info.duration) ? 0 : info.duration
        console.info('subtitleUpdate info: text=' + text + ' startTime=' + startTime +' duration=' + duration)
      } else {
        console.info('subtitleUpdate info is null')
      }
    })
  }

  // 以下demo为使用资源管理接口获取打包在HAP内的媒体资源文件并通过url属性设置
  async avPlayerSubtitleUrlDemo() {
    // 创建avPlayer实例对象
    this.avPlayer = await media.createAVPlayer()
    // 设置视频信息
    // 创建回调函数
    this.setAVPlayerCallback(this.avPlayer)



    let fdUrl:string = "http://xxx.xxx.xxx.xxx:xx/xx/index.srt"

    this.avPlayer.addSubtitleFromUrl(fdUrl)
  }

  // 以下demo为使用资源管理接口获取打包在HAP内的媒体资源文件并通过FromFd属性设置
  async avPlayerSubtitleFromFdDemo() {
    // 创建avPlayer实例对象
    this.avPlayer = await media.createAVPlayer()
    // 设置视频信息
    // 创建回调函数
    this.setAVPlayerCallback(this.avPlayer)

    let context = getContext(this) as common.UIAbilityContext
    let fileDescriptor = await context.resourceManager.getRawFd('xxx.srt')

    this.avPlayer.addSubtitleFromFd(fileDescriptor.fd, fileDescriptor.offset, fileDescriptor.length)
  }

  // 注销字幕回调函数
  async avPlayerSubtitleOffDemo() {
    if(this.avPlayer) {
      this.avPlayer.off('subtitleUpdate')
    }
  }

}