The StreamedMediaStream class represents a Telepathy streamed media stream. More...

#include <TelepathyQt4/StreamedMediaStream>

Inherits Tp::Object, and Tp::ReadyObject.

Public Types

enum SendingState { SendingStateNone, SendingStatePendingSend, SendingStateSending }

Signals

void localSendingStateChanged (Tp::StreamedMediaStream::SendingState localSendingState)
void remoteSendingStateChanged (Tp::StreamedMediaStream::SendingState remoteSendingState)

Public Member Functions

~StreamedMediaStream ()
StreamedMediaChannelPtr channel () const
uint id () const
ContactPtr contact () const
MediaStreamState state () const
MediaStreamType type () const
SendingState localSendingState () const
SendingState remoteSendingState () const
bool sending () const
bool receiving () const
bool localSendingRequested () const
bool remoteSendingRequested () const
MediaStreamDirection direction () const
MediaStreamPendingSend pendingSend () const
PendingOperation * requestSending (bool send)
PendingOperation * requestReceiving (bool receive)
PendingOperation * requestDirection (MediaStreamDirection direction)
PendingOperation * requestDirection (bool send, bool receive)
PendingOperation * startDTMFTone (DTMFEvent event)
PendingOperation * stopDTMFTone ()

Detailed Description

The StreamedMediaStream class represents a Telepathy streamed media stream.

Instances of this class cannot be constructed directly; the only way to get one is via StreamedMediaChannel.

Member Enumeration Documentation

enum Tp::StreamedMediaStream::SendingState

Enumerator:

SendingStateNone
SendingStatePendingSend
SendingStateSending

Constructor & Destructor Documentation

Tp::StreamedMediaStream::~StreamedMediaStream ( )

Class destructor.

Member Function Documentation

StreamedMediaChannelPtr Tp::StreamedMediaStream::channel ( ) const

Return the channel owning this media stream.

Returns:: A pointer to the StreamedMediaChannel object.

uint Tp::StreamedMediaStream::id ( ) const

Return the id of this media stream.

Returns:: An integer representing the media stream id.

ContactPtr Tp::StreamedMediaStream::contact ( ) const

Return the contact who this media stream is with.

Returns:: A pointer to the Contact object.

MediaStreamState Tp::StreamedMediaStream::state ( ) const

Return the state of this media stream.

Returns:: The state as MediaStreamState.

MediaStreamType Tp::StreamedMediaStream::type ( ) const

Return the type of this media stream.

Returns:: The type as MediaStreamType.

StreamedMediaStream::SendingState Tp::StreamedMediaStream::localSendingState ( ) const

Return the media stream local sending state.

Returns:: The local sending state as StreamedMediaStream::SendingState.

See also:: localSendingStateChanged()

StreamedMediaStream::SendingState Tp::StreamedMediaStream::remoteSendingState ( ) const

Return the media stream remote sending state.

Returns:: The remote sending state as StreamedMediaStream::SendingState.

See also:: remoteSendingStateChanged()

bool Tp::StreamedMediaStream::sending ( ) const

Return whether media is being sent on this media stream.

Returns:: true if media is being sent, false otherwise.

See also:: localSendingStateChanged()

bool Tp::StreamedMediaStream::receiving ( ) const

Return whether media is being received on this media stream.

Returns:: true if media is being received, false otherwise.

See also:: remoteSendingStateChanged()

bool Tp::StreamedMediaStream::localSendingRequested ( ) const

Return whether the local user has been asked to send media by the remote user on this media stream.

Returns:: true if the local user has been asked to send media by the remote user, false otherwise.

See also:: localSendingStateChanged()

bool Tp::StreamedMediaStream::remoteSendingRequested ( ) const

Return whether the remote user has been asked to send media by the local user on this media stream.

Returns:: true if the remote user has been asked to send media by the local user, false otherwise.

See also:: remoteSendingStateChanged()

MediaStreamDirection Tp::StreamedMediaStream::direction ( ) const

Return the direction of this media stream.

Returns:: The direction as MediaStreamDirection.

See also:: localSendingState(), remoteSendingState(), localSendingStateChanged(), remoteSendingStateChanged(), sending(), receiving()

MediaStreamPendingSend Tp::StreamedMediaStream::pendingSend ( ) const

Return the pending send flags of this media stream.

Returns:: The pending send flags as MediaStreamPendingSend.

See also:: localSendingStateChanged()

PendingOperation * Tp::StreamedMediaStream::requestSending ( bool send )

Request that media starts or stops being sent on this media stream.

Returns:: A PendingOperation which will emit PendingOperation::finished when the call has finished.

See also:: localSendingStateChanged(), requestDirection()

PendingOperation * Tp::StreamedMediaStream::requestReceiving ( bool receive )

Request that the remote contact stops or starts sending on this media stream.

Returns:: A PendingOperation which will emit PendingOperation::finished when the call has finished.

See also:: remoteSendingStateChanged(), requestDirection()

PendingOperation * Tp::StreamedMediaStream::requestDirection ( MediaStreamDirection direction )

Request a change in the direction of this media stream. In particular, this might be useful to stop sending media of a particular type, or inform the peer that you are no longer using media that is being sent to you.

Parameters:

direction The new direction.

Returns:: A PendingOperation which will emit PendingOperation::finished when the call has finished.

See also:: localSendingStateChanged(), remoteSendingStateChanged()

PendingOperation * Tp::StreamedMediaStream::requestDirection	(	bool	send,
		bool	receive
	)

Request a change in the direction of this media stream.

In particular, this might be useful to stop sending media of a particular type, or inform the peer that you are no longer using media that is being sent to you.

Returns:: A PendingOperation which will emit PendingOperation::finished when the call has finished.

See also:: requestDirection(Tp::MediaStreamDirection direction), localSendingStateChanged(), remoteSendingStateChanged()

PendingOperation * Tp::StreamedMediaStream::startDTMFTone ( DTMFEvent event )

Start sending a DTMF tone on this media stream.

Where possible, the tone will continue until stopDTMFTone() is called. On certain protocols, it may only be possible to send events with a predetermined length. In this case, the implementation may emit a fixed-length tone, and the stopDTMFTone() method call should return TP_QT4_ERROR_NOT_AVAILABLE.

If the channel() does not support the TP_QT4_IFACE_CHANNEL_INTERFACE_DTMF interface, the resulting PendingOperation will fail with error code TP_QT4_ERROR_NOT_IMPLEMENTED.

Parameters:

event A numeric event code from the DTMFEvent enum.

Returns:: A PendingOperation which will emit PendingOperation::finished when the request finishes.

See also:: stopDTMFTone()

PendingOperation * Tp::StreamedMediaStream::stopDTMFTone ( )

Stop sending any DTMF tone which has been started using the startDTMFTone() method.

If there is no current tone, the resulting PendingOperation will finish successfully.

If continuous tones are not supported by this media stream, the resulting PendingOperation will fail with error code TP_QT4_ERROR_NOT_AVAILABLE.

If the channel() does not support the TP_QT4_IFACE_CHANNEL_INTERFACE_DTMF interface, the resulting PendingOperation will fail with error code TP_QT4_ERROR_NOT_IMPLEMENTED.

Returns:: A PendingOperation which will emit PendingOperation::finished when the request finishes.

See also:: startDTMFTone()

void Tp::StreamedMediaStream::localSendingStateChanged ( Tp::StreamedMediaStream::SendingState localSendingState ) [signal]

Emitted when the local sending state of this media stream changes.

Parameters:

localSendingState The new local sending state of this media stream.

See also:: localSendingState()

void Tp::StreamedMediaStream::remoteSendingStateChanged ( Tp::StreamedMediaStream::SendingState remoteSendingState ) [signal]