QML类型说明-Audio

Audio

ImportStatement:   import QtMultimedia5.0

 

Properties

autoLoad : bool

autoPlay : bool

availability : enumeration

bufferProgress : real

duration : int

error : enumeration

errorString : string

hasAudio : bool

hasVideo : bool

loops : int

metaData.albumArtist : variant

metaData.albumTitle : variant

metaData.audioBitRate : variant

metaData.audioCodec : variant

metaData.author : variant

metaData.averageLevel : variant

metaData.category : variant

metaData.channelCount : variant

metaData.chapterNumber : variant

metaData.comment : variant

metaData.composer : variant

metaData.conductor : variant

metaData.contributingArtist : variant

metaData.copyright : variant

metaData.coverArtUrlLarge : variant

metaData.coverArtUrlSmall : variant

metaData.date : variant

metaData.description : variant

metaData.director : variant

metaData.genre : variant

metaData.keywords : variant

metaData.language : variant

metaData.leadPerformer : variant

metaData.lyrics : variant

metaData.mediaType : variant

metaData.mood : variant

metaData.parentalRating : variant

metaData.peakValue : variant

metaData.pixelAspectRatio : variant

metaData.posterUrl : variant

metaData.publisher : variant

metaData.ratingOrganization : variant

metaData.resolution : variant

metaData.sampleRate : variant

metaData.size : variant

metaData.subTitle : variant

metaData.title : variant

metaData.trackCount : variant

metaData.trackNumber : variant

metaData.userRating : variant

metaData.videoBitRate : variant

metaData.videoCodec : variant

metaData.videoFrameRate : variant

metaData.writer : variant

metaData.year : variant

muted : bool

playbackRate : real

playbackState : enumeration

position : int

seekable : bool

source : url

status : enumeration

volume : real

 

Signals

error(error, errorString)

paused()

playbackStateChanged()

playing()

stopped()

Methods

pause()

play()

seek(offset)

stop()

 

DetailedDescription

这个类型是QtMultimedia 5.0模块的一部分。

import QtQuick 2.0

import QtMultimedia 5.0

 

Text {

    text: "ClickMe!";

   font.pointSize: 24;

    width: 150;height: 50;

 

    Audio {

       id: playMusic

       source: "music.wav"

    }

    MouseArea{

       id: playArea

       anchors.fill: parent

       onPressed:  { playMusic.play() }

    }

}

上面的代码以及为简单的方式播放音频文件music.wav。

 

PropertyDocumentation

autoLoad : bool

在用source指定媒体文件的时候，媒体是否立刻加载。如果为假，媒体只在播放启动时加载。

 

autoPlay : bool

媒体是否自动播放。默认为假，如果为真，autoLoad被设置为真。注意：自动播放不等于重复播放，这意味着，我们source另一个文件，会自动播放，而source同一个文件，没有影响。

 

availability : enumeration

返回媒体播放器的状态。它是下面的其中一个值：

值

描述

Available

媒体播放器可用

Busy

媒体播放器被别人用

Unavailable

不支持媒体播放器

ResourceMissing

媒体播放器缺少资源

 

 

bufferProgress : real

这个属性指明了当前数据buffer填充了多少。从0（空）到1.0（满）。只有当buffer被填满时，播放才能开始或继续播放。此时状态是Audio.Buffered或Audio.Buffering。当这个属性的值小于1.0意味着状态为Audio.Stalled。

同时参阅status属性。

 

duration : int

以毫秒为单位的媒体持续时间，如果媒体没有固定时间，则这个值为0。

 

error : enumeration

audio的错误状态，它是下面的一个值：

值

描述

NoError

没有错误

ResourceError

因为资源导致音频不能播放

FormatError

媒体格式错误

NetworkError

网络错误

AccessDenied

没有播放权限

ServiceMissing

缺少服务端

注意：QT的媒体部分分成媒体服务器和播放器。播放器是与人机交互相关的部分，服务器是整个媒体播放的后台，完成调用相关的解码器，和解码插件交互等工作。如果我们没有安装QT媒体部分的服务器部分，就会出现ServiceMissing错误。

 

errorString : string

字符形式的信息，更详细的描述了错误。

 

hasAudio : bool

媒体是否包含音频。

 

hasVideo : bool

媒体是否包含视频。

 

loops : int

媒体循环播放的次数。值为0或1意味着媒体只播放一次。设置成Audio.Infinite媒体将无限循环播放。它可以在媒体播放时改变，这种改动只会将剩余的循环次数设置成新值。默认值为1。

 

metaData.albumArtist : variant

媒体的扩展信息，艺术家专辑

 

metaData.albumTitle : variant

媒体的扩展信息，媒体的标题。注意这可能和媒体的文件名不同。

 

metaData.audioBitRate : variant

媒体每秒的比特流

 

metaData.audioCodec : variant

媒体的音频编码器的名字

 

metaData.author : variant

媒体的作者信息

 

metaData.averageLevel : variant

媒体的平均音量强度。

 

metaData.category : variant

媒体的类别

 

metaData.channelCount : variant

媒体音频流的通道数。

 

metaData.chapterNumber : variant

媒体的章节数。

 

metaData.comment : variant

媒体的用户评价

 

metaData.composer : variant

媒体的作曲家

 

metaData.conductor : variant

媒体的媒介。光盘、磁带、老胶片之类的

 

metaData.contributingArtist : variant

媒体的贡献艺术家的名字

 

metaData.copyright : variant

媒体的拷贝权利。

 

metaData.coverArtUrlLarge : variant

大彩报的URL

 

metaData.coverArtUrlSmall : variant

小画报的URL

 

metaData.date : variant

媒体的发行日期

 

metaData.description : variant

媒体的描述

 

metaData.director : variant

媒体的导演。

 

metaData.genre : variant

媒体的流派，像摇滚、爵士之类的。

 

metaData.keywords : variant

媒体的关键词列表

 

metaData.language : variant

媒体的语言，ISO 639-2 编码的代码

 

metaData.leadPerformer : variant

媒体的主要演员

 

metaData.lyrics : variant

媒体的歌词

 

metaData.mediaType : variant

媒体的类型

 

metaData.mood : variant

媒体的情绪

 

metaData.parentalRating : variant

媒体的评级

 

metaData.peakValue : variant

媒体音频流的峰值音量（流量？）

 

metaData.pixelAspectRatio : variant

图像或视频的像素长宽比

 

metaData.posterUrl : variant

海报图片的URL

 

metaData.publisher : variant

媒体的出版商

 

metaData.ratingOrganization : variant

对媒体进行评级的机构名称。

 

metaData.resolution : variant

图像或视频的纬度。

 

metaData.sampleRate : variant

媒体音频流的采样率。

 

metaData.size : variant

以字节描述的媒体尺寸。

 

metaData.subTitle : variant

媒体的小标题。

 

metaData.title : variant

媒体的标题

 

metaData.trackCount : variant

专辑中包含的媒体轨迹的数量

 

metaData.trackNumber : variant

媒体的轨迹数

 

metaData.userRating : variant

在0~100之间的用户评级，打分

 

metaData.videoBitRate : variant

媒体每秒的视频比特流。

 

metaData.videoCodec : variant

媒体视频流的编码。

 

metaData.videoFrameRate : variant

媒体视频流的帧率

 

metaData.writer : variant

媒体的作家

 

metaData.year : variant

媒体的发布年

 

muted : bool

是否静音

 

playbackRate : real

媒体正常播放的速率，默认1.0

 

playbackState : enumeration

媒体的播放状态，它是下面的一个值

PlayingState - 正在播放

PausedState - 暂停

StoppedState - 停止

 

position : int

以毫秒为单位的媒体当前播放位置。可用seek()改变这个位置。

 

seekable : bool

媒体是否能seek()，如果为真，则seek()方法能改变当前播放位置。

 

source : url

媒体来源的URL

 

status : enumeration

媒体播放的状态，是下面的其中一个值：

NoMedia - 没有媒体

Loading - 媒体正在被加载

Loaded - 媒体加载完毕

Buffering - 正在缓冲数据

Stalled - 为了缓冲数据而中断播放

Buffered - 数据缓冲完毕

EndOfMedia - 媒体播放完毕

InvalidMedia - 媒体不能被播放

UnknownStatus - 未知播放状态

 

volume : real

音频输出的音量，0为沉默，1.0为最大音量。默认1.0

 

SignalDocumentation

error(error, errorString)

当错误出现时，这个信号发射。错误信息在errorString中。操作句柄onError。

 

paused()

播放暂停时发射这个信号。操作句柄onPaused

 

playbackStateChanged()

当playbackState发生改变时，发射这个信号。操作句柄onPlaybackStateChanged。

 

playing()

当播放暂停或恢复时，发射这个信号。操作句柄onPlaying。

 

stopped()

当播放停止时，发射这个信号。操作句柄onStopped。

 

MethodDocumentation

pause()

暂停媒体的播放，设置playbackState为 PausedState

 

 play()

开始播放媒体，设置playbackState为PlayingState

 

seek(offset)

如果seekable属性为真，设置offset为当前播放未知。Seeking可以是异步的，所以位置属性有可能不是立刻更新。

 

stop()

停止媒体的播放。设置playbackState为StoppedState