diff -r 51a74ef9ed63 -r ae94777fff8f Symbian3/SDK/Source/GUID-5F4510C9-5B16-593A-A225-37606800915B.dita --- a/Symbian3/SDK/Source/GUID-5F4510C9-5B16-593A-A225-37606800915B.dita Wed Mar 31 11:11:55 2010 +0100 +++ b/Symbian3/SDK/Source/GUID-5F4510C9-5B16-593A-A225-37606800915B.dita Fri Jun 11 12:39:03 2010 +0100 @@ -1,32 +1,32 @@ - - - - - -Controlling Video Playback

This tutorial describes how to control video playback.

Purpose

The purpose of this tutorial is to show you how to use the video player to control video playback.

Required Background

The Video Client Overview introduces the video client utilities.

Introduction

The video player utility is used to open, play, and obtain information from sampled video data. This functionality is implemented by the CVideoPlayerUtility class. The video data can be supplied either in a file, a descriptor or a URL.

The sequence diagram below explains the different functionalities of the Video Player Utility:

- Video Player sequence diagram -
Using Video Player

The following tasks will be covered in this tutorial:

  • Play Video Clips

  • Get Current Frame

Playing Video Clips

The high level steps to play video clips are shown here:

  1. After configuring the properties, the CVideoPlayerUtility::Play() function is called for the video clip to be played.

  2. The play can be paused for a small duration using CVideoPlayerUtility::PauseL() and later resumed by calling CVideoPlayerUtility::Play() function once again.

  3. To halt the video play CVideoPlayerUtility::Stop() is called.

  4. In order to unload all related controllers and return, use CVideoPlayerUtility::Close().

These high level steps are shown in the following example code:

void CPlayVideo::Play() //Starts playback of the video clip - { - iVideoUtility->Play(); - } - -void CPlayVideo::PauseL() //Call to this function will maintain the current position - //playback can be resumed by calling Play function again - { - TRAPD(err,iVideoUtility->PauseL()); - } - -TInt CPlayVideo::Stop() //Stops playing - { - TInt err = iVideoUtility->Stop(); - return err; - }

Note: You must call the CVideoPlayerUtility::Prepare() function, before calling any of the functions used in the above given code.

Getting the Current Frame

The high level steps to get the current frame are shown here:

  1. To get the video frame currently being played, use the CVideoPlayerUtility::GetFrameL() function.

    void CPlayVideo::GetFrameL(TDisplayMode aDisplayMode) //Returns the current frame - { - iVideoUtility->GetFrameL(aDisplayMode); + + + + + +Controlling Video Playback

    This tutorial describes how to control video playback.

    Purpose

    The purpose of this tutorial is to show you how to use the video player to control video playback.

    Required Background

    The Video Client Overview introduces the video client utilities.

    Introduction

    The video player utility is used to open, play, and obtain information from sampled video data. This functionality is implemented by the CVideoPlayerUtility class. The video data can be supplied either in a file, a descriptor or a URL.

    The sequence diagram below explains the different functionalities of the Video Player Utility:

    + Video Player sequence diagram +
    Using Video Player

    The following tasks will be covered in this tutorial:

    • Play Video Clips

    • Get Current Frame

    Playing Video Clips

    The high level steps to play video clips are shown here:

    1. After configuring the properties, the CVideoPlayerUtility::Play() function is called for the video clip to be played.

    2. The play can be paused for a small duration using CVideoPlayerUtility::PauseL() and later resumed by calling CVideoPlayerUtility::Play() function once again.

    3. To halt the video play CVideoPlayerUtility::Stop() is called.

    4. In order to unload all related controllers and return, use CVideoPlayerUtility::Close().

    These high level steps are shown in the following example code:

    void CPlayVideo::Play() //Starts playback of the video clip + { + iVideoUtility->Play(); + } + +void CPlayVideo::PauseL() //Call to this function will maintain the current position + //playback can be resumed by calling Play function again + { + TRAPD(err,iVideoUtility->PauseL()); + } + +TInt CPlayVideo::Stop() //Stops playing + { + TInt err = iVideoUtility->Stop(); + return err; + }

    Note: You must call the CVideoPlayerUtility::Prepare() function, before calling any of the functions used in the above given code.

    Getting the Current Frame

    The high level steps to get the current frame are shown here:

    1. To get the video frame currently being played, use the CVideoPlayerUtility::GetFrameL() function.

      void CPlayVideo::GetFrameL(TDisplayMode aDisplayMode) //Returns the current frame + { + iVideoUtility->GetFrameL(aDisplayMode); }
    2. The current frame is sent to the client asynchronously via the MVideoPlayerUtilityObserver::MvpuoFrameReady() callback function.

    See Also

    Creating and Preparing a Video Player

    Configuring the Video Player

    Enabling/Disabling Audio or Video Playback Separately

    Scaling Automatically

    Fast Forwarding and Rewinding

    Stepping Frames

    Controlling the Video Controller Plugin

    \ No newline at end of file