QML类型说明-CameraRecorder

CameraRecorder

ImportStatement:   import QtMultimedia 5.0

 

Properties

actualLocation: string

audioBitRate: int

audioChannels: int

audioCodec :string

audioEncodingMode: enumeration

audioSampleRate: int

duration :int

errorCode :enumeration

errorString: string

frameRate :qreal

mediaContainer: string

muted : bool

outputLocation: string

recorderState: enumeration

recorderStatus: enumeration

resolution :size

videoBitRate: int

videoCodec :string

videoEncodingMode: enumeration

 

Methods

record()

setMetadata(key,value)

stop()

 

DetailedDescription

CameraRecorder允许记录视频流到文件，可以为视频调节录像设置和metadata。

它是Camera的一个属性，不能被单独构建。

Camera {

    videoRecorder.audioEncodingMode:CameraRecorder.ConstantBitrateEncoding;

    videoRecorder.audioBitRate: 128000

    videoRecorder.mediaContainer:"mp4"

    // ...

}

这个组件为录像的每一部分都提供了许多不同设置（声音、视频和输出格式），它和控制静音和文件的保存位置。

 

PropertyDocumentation

actualLocation: string

最后保存的媒体的路径。它常常处于可利用的状态。当新的路径设置或新录像开始，它复位。

 

audioBitRate: int

用于录像的音频比特率。（每秒的比特数）

 

audioChannels: int

录像时编码的音频通道数（1是mono，2是立体声）

 

audioCodec :string

用于录像的音频编码器。典型的编码器是AAC或AMR-Wb

 

audioEncodingMode: enumeration

录制音频时的编码方法，它是下面的值之一：

值	描述
ConstantQualityEncoding	恒定质量编码，比特率会自动调整。这是默认值，audioBitRate将被忽略。
ConstantBitRateEncoding	恒定比特率编码，质量将会调整。它常常用于优化存储空间。
AverageBitRateEncoding	编码尽量保持在设置的比特率。实际可能比需要的大或者小。

 

audioSampleRate: int

录像时用于编码音频的声音采样率。

 

duration :int

以毫秒计算的最后的录像的时间。

 

errorCode :enumeration

最后的错误码。它是下面的一个值：

值	描述
NoError	没有错误。
ResourceError	设备没有准备好或不可用。
FormatError	当前格式不支持。
OutOfSpaceError	设备没有更多的空间。

 

errorString: string

最后的错误的详细信息。

 

frameRate :qreal

录像时每秒的帧数。

 

mediaContainer: string

录像时媒体的容器，典型值是mp4。

 

muted : bool

录像是否静音。

 

outputLocation: string

媒体的保存路径。如果路径为空，录像将自动命名录像，并保存在系统指定位置。

 

recorderState: enumeration

当前录像的状态，它是下面的一个值。

StoppedState：相机没有录像

RecordingState：相机正在录像

 

recorderStatus: enumeration

录像的状况，它是下面的值之一：

值	描述
UnavailableStatus	录像不被相机支持。
UnloadedStatus	录像机可用，但没有加载。
LoadingStatus	录像机正在初始化。
LoadedStatus	录像机完成初始化，准备录像
StartingStatus	录像被请求，但还没有激活。
RecordingStatus	录像被激活，录像中
PausedStatus	暂停录像
FinalizingStatus	录像停止，媒体文件被结束。

 

resolution :size

视频捕捉时的帧尺寸。

 

videoBitRate: int

录像时的视频比特率（每秒的比特数）。

 

videoCodec :string

录像时视频的编码器，典型值是H264

 

videoEncodingMode: enumeration

录像时的视频编码模式，它是下面的值之一：

值	描述
ConstantQualityEncoding	恒定质量编码，码率会变化。
ConstantBitRateEncoding	恒定码率编码，质量会变化。
AverageBitRateEncoding	平均编码。尝试保持比特流在设定值，实际可能大或小

 

MethodDocumentation

record()

开始录像

 

setMetadata(key,value)

为下一个录像设置metadata，为给定的键配上值。

 

stop()

停止录像。