组件/数据展示

EMediaPlayer 媒体播放器

import EUI 1.0

示例与代码

媒体播放器

音视频播放依赖桌面多媒体后端，请在 Gallery 中体验。

在 Gallery 中体验 ↗

QML 代码QML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 EMediaPlayer { width: 480 height: 300 source: "file:///C:/media/video.mp4" }

属性

属性说明取值与默认值

autoPlayalias

加载媒体后自动播放。

默认值别名：player.autoPlay

controlsVisiblebool

是否显示播放控制栏。

默认值true

enabledbool

是否允许交互；false 时控件禁用。

默认值true

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

mutedalias

是否静音。

默认值别名：player.muted

sourcealias

图片或媒体资源地址，支持 Qt 可加载的 URL。

默认值别名：player.source

visiblebool

是否显示组件。

默认值true

volumealias

播放音量，范围 0～1。

0–1

默认值别名：player.volume

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

durationint只读

动画或显示持续时间，单位为毫秒；组件的绑定表达式给出实际用途。

默认值由运行时计算

errorStringstring只读

最近一次操作失败的说明。

默认值由运行时计算

playbackStateint只读

Qt Multimedia 播放状态，停止、播放或暂停。

MediaPlayer.StoppedState
MediaPlayer.PlayingState
MediaPlayer.PausedState

默认值由运行时计算

positionint只读

媒体当前的播放位置，单位为毫秒。

0–duration（毫秒）

默认值由运行时计算

信号

签名作用

failed(string message)

操作失败时触发，message 为错误信息。

方法

签名作用

play()

开始或继续播放媒体。

stop()

停止媒体播放。

pause()

暂停媒体播放。

seek(position)

跳转到 position 指定的播放位置。