This tutorial describes how to get started with the video recorder utility.
The purpose of this tutorial is to show you how to create a new video recorder utility and prepare it for recording video data.
The Video Client Overview introduces the video client utilities.
The video recorder utility is used to record video clips to files, descriptors or URLs and manipulate embedded meta data. This functionality is implemented by the CVideoRecorderUtility class.
The following tasks will be covered in this tutorial:
The high level steps to create a video recorder utility object are shown here:
You can create an object of this utility class using the CVideoRecorderUtility::NewL function. Some video formats also allow storing of audio data. To facilitate this feature, the class contains audio functions that can manipulate audio data.
The high level steps to open a recording device are shown here:
Certain parameters like, the handle to the camera, the controller UID, video format and the codecs to use for video and audio need to be specified for recording. This is shown in the range of open statements shown below based on where you want to save the video clip:
CVideoRecorderUtility::OpenFileL : This function stores the recorded video clip in a file.
void OpenFileL(const TDesC& aFileName, TInt aCameraHandle, TUid aControllerUid, TUid aVideoFormat, TFourCC aVideoType=KFourCCNULL, TFourCC aAudioType=KFourCCNULL);
Note: There is also another method to save a video clip to a file. It is strongly recommended to use this method.
Where aSource is a filename or an open handle to a file where the video clip has to be saved and aControllerUid is an optionally specified plugin. If specified, it will force the video player to use the controller with the given UID. If no controller plugin is specified, this function searches through a list of all available plugins and attempts to use each one until successful or the end of the list is reached.
CVideoRecorderUtility::OpenDesL : This function stores the recorded video clip in a descriptor.
CVideoRecorderUtility::OpenUrlL : This function stores the recorded video clip in a URL.
Once the opening of the recording device is complete, successfully or otherwise, the callback function MVideoRecorderUtilityObserver::MvruoOpenComplete() is called. This notifies the client whether the video clip was successfully opened or not.
The high level steps to prepare to record video are shown here:
Once the camera is ready and the video clip is opened successfully, call the CVideoRecorderUtility::Prepare() function. This function prepares the record controller for use.
When the preparation of the record controller is complete, successfully or otherwise, a callback function MVideoRecorderUtilityObserver::MvruoPrepareComplete is called to notify that the video recorder is ready to record.
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License v1.0.