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()
停止录像。