Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

VideoRingtone Class Reference
[QtTelephonyModule]

The VideoRingtone class provides an interface to the Qt Extended media system to play the video tones for incoming calls. More...

    #include <VideoRingtone>

Inherits QObject.

• List of all members, including inherited members

Public Functions

• VideoRingtone ( QObject * parent = 0 )
• ~VideoRingtone ()
• QWidget * videoWidget ()

• 29 public functions inherited from QObject

Public Slots

• void playVideo ( const QString & fileName )
• void stopVideo ()

• 1 public slot inherited from QObject

Signals

• void videoRingtoneFailed ()
• void videoRingtoneStopped ()
• void videoWidgetReady ()

• 1 signal inherited from QObject

Additional Inherited Members

• 1 property inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QObject
• 7 protected functions inherited from QObject
• 2 protected variables inherited from QObject

Detailed Description

The VideoRingtone class provides an interface to the Qt Extended media system to play the video tones for incoming calls.

The VideoRingtone acts as a bridge between RingControl and other part of the system that is interested in displaying the video widget, for example, CallScreen.

The RingControl class communicates with this class via messages on the QPE/VideoRingtone QCop channel. The following messages are supported.

RingControl calls playVideo() when the video ringtone is preferred. The CallScreen should be listening to the videoWidgetReady() signal to retreive the video widget object by calling videoWidget().

The signal videoRingtoneStopped() is emitted when the tone finished playing.

    CallScreen::CallScreen() {
        ...
        VideoRingtone *vrt = qtopiaTask<VideoRingtone>();
        if ( vrt )
            connect( vrt, SIGNAL(videoWidgetReady()),
                this, SLOT(showVideo()) );
        ...
    }

    CallScreen::showVideo() {
        VideoRingtone *vrt = qtopiaTask<VideoRingtone>();
        if (!vrt)
            return;
        QWidget *widget = vrt->videoWidget();

        // set the new parent to manage resource
        widget->setParent( this );

        layout()->addWidget( widget );
    }

This class is a Qt Extended server task and is part of the Qt Extended server. It cannot be used by other Qt Extended applications.

See also RingControl.

Member Function Documentation

VideoRingtone::VideoRingtone ( QObject * parent = 0 )

Creates a new VideoRingtone instance with the specified parent.

VideoRingtone::~VideoRingtone ()

Destroys the VideoRingtone object.

void VideoRingtone::playVideo ( const QString & fileName )   [slot]

Attempts to play the video fileName.

void VideoRingtone::stopVideo ()   [slot]

Stops the media content.

void VideoRingtone::videoRingtoneFailed ()   [signal]

This signal is emitted when the media system fails to play the video tone.

void VideoRingtone::videoRingtoneStopped ()   [signal]

This signal is emitted when the video tone is stopped.

QWidget * VideoRingtone::videoWidget ()

Returns the video widget instance.

void VideoRingtone::videoWidgetReady ()   [signal]

This signal is emitted when the video widget is created and ready to be used.