多媒体

阅读时间：1分钟更新于 2025-02-19 14:20

音视频文件体积会影响动效的加载速度，请保证音视频文件体积适中

插件引入

需要额外接入 插件（请确保插件版本号与 @galcean/effects 版本号一致）。

$ npm i @galacean/effects-plugin-multimedia --save
import { Player } from '@galacean/effects';
// 确保在 @galacean/effects 引入之后再引入插件, 插件版本保持和 @galacean/effects 一致
import '@galacean/effects-plugin-multimedia';

API

视频 API

获取视频时常
/**
 * 获取当前视频时长
 * @returns 视频时长
 */
getDuration (): number;
获取当前视频播放时刻
/**
 * 获取当前视频播放时刻
 * @returns 当前视频播放时刻
 */
getCurrentTime (): number;
设置视频音量
/**
 * 设置视频音量
 * @param volume 视频音量
 */
setVolume (volume: number) ;

注意：

  • API 使用问题：由于视频元素的渲染更新依赖 Video 组件的相关功能，导致使用 player.gotoAndPlay 时会跳帧，目前暂无解决方案。在使用该 API 时需要注意合成中是否存在视频元素。

音频 API

获取当前音频播放时刻
/**
 * 获取音频播放时刻
 * @returns 当前音频播放时刻
 */
getCurrentTime (): number;
设置音频音量
/**
 * 设置音频音量
 * @param volume 音频音量
 */
setVolume (volume: number) ;
Preview