diff -r 000000000000 -r 89d6a7a84779 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 Thu Jan 21 18:18:20 2010 +0000 @@ -0,0 +1,83 @@ + + + + + +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. +
  3. 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.

  4. +
  5. 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.

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

    +
  8. +
  9. Include VideoRecorder.h and mmfcontrollerpluginresolver.h header files in the appropriate class files.

  10. +
  11. 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.

  12. +
  13. 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.

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

For a reference example, see the S60 Platform Video Example v2.0 on Forum Nokia.

+

For more information on CVideoRecorderUtility, see Multimedia recipes in the Symbian Developer Network.

+

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

+
+
\ No newline at end of file