diff -r 43e37759235e -r 51a74ef9ed63 Symbian3/SDK/Source/GUID-AB9A3EA2-2B99-4502-A161-8EE5BF477D41.dita --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/Symbian3/SDK/Source/GUID-AB9A3EA2-2B99-4502-A161-8EE5BF477D41.dita Wed Mar 31 11:11:55 2010 +0100 @@ -0,0 +1,87 @@ + + + + + +Capturing +a video clip +

To record video data to a file, descriptor, or an URL, use the video +recorder utility of the Multimedia Framework (MMF) to develop your application. +To make use of the onboard camera to capture a video clip, the application +needs to repeat the steps described in the illustration below.

+The steps required to capture a video clip +

Important implementation considerations include:

+ +
To capture a +video clip +

Use the methods of the CVideoRecorderUtility class to construct your application.

+
    +

  1. Initialize +the video recorder.

    +
      +

    • Create a video recorder object using the CVideoRecorderUtility::NewL method.

      +
      • +

    • Resolve the supported video format and retrieve a list of +controllers using the CMMFControllerPluginSelectionParameters and CMMFFormatSelectionParameters classes, and the respective type definitions RMMFControllerImplInfoArray and RMMFFormatImplInfoArray.

      • +

    • Open a file, descriptor or an URL to store the video clip +in using the respective CVideoRecorderUtility::OpenFileL, CVideoRecorderUtility::OpenDesL, or CVideoRecorderUtility::OpenUrlL method.

      +
      • +

    • Set the maximum video clip size using the CVideoRecorderUtility::SetMaxClipSizeL() method.

      +
      • +

    • Prepare the record controller using the CVideoRecorderUtility::Prepare() method. MVideoRecorderUtilityObserver::MvruoPrepareComplete is +called upon completion.

      • +
    +
    2. +

  2. Configure +the audio and video settings.

    You can check and set, for example, +the recording priority, audio track, video frame size and frame rate, audio +and video codecs and bit rates, and recording gain of the video clip. For +more information on the options, see the CVideoRecorderUtility class.

    3. +

  3. Capture the +video clip.

    +
      +

    • Start recording a video using the CVideoRecorderUtility::Record() method.

      • +

    • Pause recording using the CVideoRecorderUtility::PauseL() method.

      • +

    • Stop recording using the CVideoRecorderUtility::Stop() method.

      • +
    +
    4. +

  4. To exit the +application or to switch it to the background, close audio and video controllers +using the CVideoRecorderUtility::Close() method.

    +
    5. +

  5. Include VideoRecorder.h and mmfcontrollerpluginresolver.h header files in the appropriate class files.

    6. +

  6. Make sure +you have correct capabilities information +set for your application. You need at least the UserEnvironment capability. +If you want to set the recording priority for the video and audio device, +you need the MultimediaDD capability.

    7. +

  7. Make sure mediaclientvideo.lib and mmfcontrollerframework.lib are accessible to your linker when compiling your application by including +it in your mmp file or by editing the project properties +in your IDE, depending on your build environment.

    8. +
+
+
Additional information +on capturing a video +

For a reference example, see the Camera +Example: Capturing and controlling the images using Camera.

+

For more information on CVideoRecorderUtility, see Multimedia +recipes at the Symbian Foundation.

+

For more information on CVideoRecorderUtility see the Recording Video Data tutorial +in the Video Client library.

+
+ \ No newline at end of file