| Home · All Classes · All Namespaces · Modules · Functions · Files

# Tp::MediaStream Class Reference
[Channel proxies]

The MediaStream class provides an object representing a Telepathy media stream. More...

`#include <TelepathyQt4/StreamedMediaChannel>`

Inherits Tp::ReadyObject, and Tp::RefCounted.

List of all members.

## Public Types

- enum SendingState { SendingStateNone, SendingStatePendingSend, SendingStateSending }

## Signals

- void localSendingStateChanged (Tp::MediaStream::SendingState localSendingState)
- void remoteSendingStateChanged (const QHash< Tp::ContactPtr, Tp::MediaStream::SendingState > &remoteSendingStates)
- void membersRemoved (const Tp::Contacts &members)

## Public Member Functions

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

## Detailed Description

The MediaStream class provides an object representing a Telepathy media stream.

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

See Asynchronous Object Model

## Member Enumeration Documentation

enum Tp::MediaStream::SendingState

Enumerator:

  SendingStateNone |
  SendingStatePendingSend |
  SendingStateSending |

## Constructor & Destructor Documentation

Tp::MediaStream::~MediaStream | ( |  | ) |

Class destructor.

## Member Function Documentation

MediaContentPtr Tp::MediaStream::content | ( |  | ) | const

Return the content owning this media stream.

Returns:
  The content owning this media stream.

StreamedMediaChannelPtr Tp::MediaStream::channel | ( |  | ) | const

Return the channel owning this media stream.

Returns:
  The channel owning this media stream.

uint Tp::MediaStream::id | ( |  | ) | const

Return the id of this media stream.

Returns:
  An integer representing the media stream id.

Contacts Tp::MediaStream::members | ( |  | ) | const

Return the contacts whose the media stream is with.

Returns:
  The contacts whose the media stream is with.

See also:
  membersRemoved()

ContactPtr Tp::MediaStream::contact | ( |  | ) | const

Return the contact who this media stream is with.

Returns:
  The contact who this media stream is with.

MediaStreamState Tp::MediaStream::state | ( |  | ) | const

Return the state of this media stream.

Returns:
  The state of this media stream.

MediaStreamType Tp::MediaStream::type | ( |  | ) | const

Return the type of this media stream.

Returns:
  The type of this media stream.

MediaStream::SendingState Tp::MediaStream::localSendingState | ( |  | ) | const

Return the media stream local sending state.

Returns:
  The media stream local sending state.

See also:
  localSendingStateChanged()

MediaStream::SendingState Tp::MediaStream::remoteSendingState | ( | const ContactPtr & | contact | ) | const

Return the media stream remote sending state for a given contact.

Returns:
  The media stream remote sending state for a contact.

See also:
  remoteSendingStateChanged()

bool Tp::MediaStream::sending | ( |  | ) | const

Return whether media is being sent on this media stream.

Returns:
  `true` if media being sent on this media stream, `false` otherwise.

See also:
  localSendingStateChanged()

bool Tp::MediaStream::receiving | ( |  | ) | const

Return whether media is being received on this media stream.

Returns:
  `true` if media is being received on this media stream, `false` otherwise.

See also:
  remoteSendingStateChanged()

bool Tp::MediaStream::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 on this media stream, `false` otherwise.

See also:
  localSendingStateChanged()

bool Tp::MediaStream::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 on this media stream, `false` otherwise.

See also:
  remoteSendingStateChanged()

MediaStreamDirection Tp::MediaStream::direction | ( |  | ) | const

Return the direction of this media stream.

Returns:
  The direction of this media stream.

See also:
  localSendingStateChanged(), remoteSendingStateChanged()

MediaStreamPendingSend Tp::MediaStream::pendingSend | ( |  | ) | const

Return the pending send flags of this media stream.

Returns:
  The pending send flags of this media stream.

See also:
  localSendingStateChanged()

PendingOperation * Tp::MediaStream::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()

PendingOperation * Tp::MediaStream::requestReceiving | ( | const ContactPtr & | contact,
|  | bool | receive |
| ) |  |  |

Request that a 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()

PendingOperation * Tp::MediaStream::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::MediaStream::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::MediaStream::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 TELEPATHY_ERROR_NOT_AVAILABLE.

If the channel() does not support the TELEPATHY_INTERFACE_CHANNEL_INTERFACE_DTMF interface, the resulting PendingOperation will fail with error code TELEPATHY_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::MediaStream::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 TELEPATHY_ERROR_NOT_AVAILABLE.

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

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

See also:
  startDTMFTone()

void Tp::MediaStream::localSendingStateChanged | ( | Tp::MediaStream::SendingState | localSendingState | ) | `[signal]`

This signal is 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::MediaStream::remoteSendingStateChanged | ( | const QHash< Tp::ContactPtr, Tp::MediaStream::SendingState > & | remoteSendingStates | ) | `[signal]`

This signal is emitted when any remote sending state of this media stream changes.

Parameters:

  | remoteSendingStates | The new remote sending states of this media stream.

See also:
  remoteSendingState()

void Tp::MediaStream::membersRemoved | ( | const Tp::Contacts & | members | ) | `[signal]`

This signal is emitted when one or more members of this stream are removed.

Parameters:

  | members | The members that were removed from this media stream.

See also:
  members()