MediaRecorder QML Type

For encoding and recording media generated in a CaptureSession . 更多...

import 語句：	import QtMultimedia
實例化：	QMediaRecorder

所有成員列錶，包括繼承成員

特性

actualLocation : QUrl
duration : qint64
error : enumeration
errorString : string
isAvailable : bool
mediaFormat : MediaFormat
metaData : mediaMetaData
outputLocation : QUrl
quality : enumeration
recorderState : enumeration

信號

actualLocationChanged (const QUrl & location )
durationChanged (qint64 duration )
errorOccurred (Error error , const QString & errorString )
metaDataChanged ()
recorderStateChanged (RecorderState state )

方法

pause ()
record ()
stop ()

詳細描述

The MediaRecorder element can be used within a CaptureSession to record and encode audio and video captured from a microphone and camera

The code below shows a simple capture session containing a MediaRecorder using the default camera and default audio input.

CaptureSession {
    id: captureSession
    camera: Camera {
        id: camera
        active: true
    }
    audioInput: AudioInput {}
    recorder: MediaRecorder {
        id: recorder
    }
}

The code below shows how the recording can be started and stopped.

CameraButton {
    text: "Record"
    visible: recorder.recorderState !== MediaRecorder.RecordingState
    onClicked: recorder.record()
}
CameraButton {
    id: stopButton
    text: "Stop"
    visible: recorder.recorderState === MediaRecorder.RecordingState
    onClicked: recorder.stop()
}

另請參閱 CaptureSession , Camera , AudioInput ，和 ImageCapture .

特性文檔編製

[read-only] actualLocation : QUrl

The actual location of the last media content.

The actual location is usually available after recording starts, and reset when new location is set or new recording starts.

[read-only] duration : qint64

此特性保持錄製媒體的持續時間 (以毫秒為單位)。

[read-only] error : enumeration

This property holds the current media recorder error state.

常量	描述
`MediaRecorder.NoError`	Not in an error state.
`MediaRecorder.ResourceError`	Not enough system resources
`MediaRecorder.FormatError`	the current format is not supported.
`MediaRecorder.OutOfSpaceError`	設備沒有剩餘空間。
`MediaRecorder.LocationNotWriteable`	The output location is not writable.

[read-only] errorString : string

This property holds a string describing the current error state.

另請參閱 error .

isAvailable : bool

This property holds whether the recorder service is ready to use.

返迴 true if media recorder service ready to use.

mediaFormat : MediaFormat

This property holds the current MediaFormat of the recorder.

metaData : mediaMetaData

This property holds meta data associated with the recording.

When a recording is started, any meta-data assigned will be attached to that recording.

注意： Ensure that meta-data is assigned correctly by assigning it before starting the recording.

另請參閱 mediaMetaData .

outputLocation : QUrl

The destination location of media content.

Setting the location can fail, for example when the service supports only local file system locations but a network URL was passed. If the operation fails an errorOccured() signal is emitted.

The location can be relative or empty. If empty the recorder uses the system specific place and file naming scheme.

另請參閱 errorOccurred ().

quality : enumeration

枚舉品質編碼級彆。

常量	值
`MediaRecorder.VeryLowQuality`
`MediaRecorder.LowQuality`
`MediaRecorder.NormalQuality`
`MediaRecorder.HighQuality`
`MediaRecorder.VeryHighQuality`

[read-only] recorderState : enumeration

This property holds the current media recorder state.

The state property represents the user request and is changed synchronously during record (), pause () 或 stop () calls. RecorderSstate may also change asynchronously when recording fails.

常量	描述
`MediaRecorder.StoppedState`	The recorder is not active.
`MediaRecorder.RecordingState`	請求錄製。
`MediaRecorder.PausedState`	The recorder is pause.

信號文檔編製

actualLocationChanged (const QUrl & location )

Signals that the actual location of the recorded media has changed.

This signal is usually emitted when recording starts.

注意： 相應處理程序是 onActualLocationChanged .

durationChanged ( qint64 duration )

發射信號，當 duration of the recorded media has changed.

注意： 相應處理程序是 onDurationChanged .

errorOccurred ( Error error , const QString & errorString )

發射信號，當 error has occurred.

The errorString contains a description of the error.

注意： 相應處理程序是 onErrorOccurred .

metaDataChanged ()

Signals that a media object's meta-data has changed.

If multiple meta-data elements are changed metaDataChanged() is emitted once.

注意： 相應處理程序是 onMetaDataChanged .

recorderStateChanged ( RecorderState state )

Signals that a media recorder's state 已改變。

注意： 相應處理程序是 onRecorderStateChanged .

方法文檔編製

pause ()

Pauses recording.

The recorder state is changed to QMediaRecorder .PausedState.

Depending on the platform, pausing recording may be not supported. In this case the recorder state is unchanged.

record ()

Starts recording.

While the recorder state is changed immediately to MediaRecorder.RecordingState , recording may start asynchronously.

If recording fails, the error() signal is emitted with recorder state being reset back to QMediaRecorder.StoppedState .

注意： On mobile devices, recording will happen in the orientation the device had when calling record and is locked for the duration of the recording. To avoid artifacts on the user interface, we recommend to keep the user interface locked to the same orientation as long as the recording is ongoing using the contentOrientation property of the Window and unlock it again once the recording is finished.

stop ()

Stops the recording.

The recorder will stop the recording. Processing pending video and audio data might however still take some time. The recording is finished, once the state of the media recorder changes to QMediaRecorder::StoppedState .