Home · All Classes · Grouped Classes · Annotated · Functions

VideoRingtone Class Reference

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

    #include <VideoRingtone>

Inherits QObject.

Public Functions

Signals

Static Public Members

Additional Inherited Members


Detailed Description

The VideoRingtone class provides an interface to the Qtopia 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.

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

RingControl is responsible for responding to the videoRingtoneFailed() signal.

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

    CallScreen::CallScreen() {
        ...
        connect( VideoRingtone::instance(), SIGNAL(videoWidgetReady()),
            this, SLOT(showVideo()) );
        ...
    }

    CallScreen::showVideo() {
        QWidget *widget = videoTone->videoWidget();

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

        layout()->addWidget( widget );
    }

This class is part of the Qtopia server and cannot be used by other Qtopia applications.


Member Function Documentation

VideoRingtone::~VideoRingtone ()

Destroys the VideoRingtone object.

VideoRingtone * VideoRingtone::instance ()   [static]

Returns the VideoRingtone instance.

void VideoRingtone::playVideo ( const QString & fileName )

Attempts to play the video fileName.

void VideoRingtone::stopVideo ()

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.


Copyright © 2008 Nokia Trademarks
Qtopia 4.3.3