Home · All Classes · All Namespaces · Modules · Functions · Files |
The CallChannel class provides an object representing a Telepathy channel of type Call. More...
#include <TelepathyQt/CallChannel>
Inherits Tp::Channel.
The CallChannel class provides an object representing a Telepathy channel of type Call.
Tp::CallChannel::~CallChannel | ( | ) | [virtual] |
Class destructor.
Tp::CallChannel::CallChannel | ( | const ConnectionPtr & | connection, |
const QString & | objectPath, | ||
const QVariantMap & | immutableProperties, | ||
const Feature & | coreFeature = CallChannel::FeatureCore |
||
) | [protected] |
Construct a new CallChannel associated with the given object on the same service as the given connection.
connection | Connection owning this channel, and specifying the service. |
objectPath | The object path of this channel. |
immutableProperties | The immutable properties of this channel. |
coreFeature | The core feature of the channel type. The corresponding introspectable should depend on Channel::FeatureCore. |
CallChannelPtr Tp::CallChannel::create | ( | const ConnectionPtr & | connection, |
const QString & | objectPath, | ||
const QVariantMap & | immutableProperties | ||
) | [static] |
Create a new CallChannel object.
connection | Connection owning this channel, and specifying the service. |
objectPath | The object path of this channel. |
immutableProperties | The immutable properties of this channel. |
Reimplemented from Tp::Channel.
bool Tp::CallChannel::handlerStreamingRequired | ( | ) | const |
Check whether media streaming by the handler is required for this channel.
If false
, all of the media streaming is done by some mechanism outside the scope of Telepathy, otherwise the handler is responsible for doing the actual media streaming.
true
if required, false
otherwise. Return the initial transport type used for this call if set on a requested channel.
Where not applicable, this property is defined to be StreamTransportTypeUnknown, in particular, on CMs with hardware streaming.
bool Tp::CallChannel::hasInitialAudio | ( | ) | const |
Return whether an audio content was requested at the channel's creation time.
true
if an audio content was requested, false
otherwise. bool Tp::CallChannel::hasInitialVideo | ( | ) | const |
Return whether a video content was requested at the channel's creation time.
true
if an video content was requested, false
otherwise. QString Tp::CallChannel::initialAudioName | ( | ) | const |
Return the name of the initial audio content if hasInitialAudio() returns true
.
QString Tp::CallChannel::initialVideoName | ( | ) | const |
Return the name of the initial video content if hasInitialVideo() returns true
.
bool Tp::CallChannel::hasMutableContents | ( | ) | const |
Return whether new contents can be added on the call after the Channel has been requested.
true
if a new content can be added after the Channel has been requested, false
otherwise. Indicate that the local user has been alerted about the incoming call.
Notify the CM that the local user is already in a call, so this call has been put in a call-waiting style queue.
Accept an incoming call, or begin calling the remote contact on an outgoing call.
PendingOperation * Tp::CallChannel::hangup | ( | CallStateChangeReason | reason = CallStateChangeReasonUserRequested , |
const QString & | detailedReason = QString() , |
||
const QString & | message = QString() |
||
) |
Request that the call is ended.
reason | A generic hangup reason. |
detailedReason | A more specific reason for the call hangup, if one is available, or an empty string otherwise. |
message | A human-readable message to be sent to the remote contact(s). |
CallState Tp::CallChannel::callState | ( | ) | const |
Return the current high-level state of this call.
This function requires CallChannel::FeatureCallState to be enabled.
CallFlags Tp::CallChannel::callFlags | ( | ) | const |
Return the flags representing the status of this call as a whole, providing more specific information than callState().
This function requires CallChannel::FeatureCallState to be enabled.
Return the reason for the last change to the callState() and/or callFlags().
This function requires CallChannel::FeatureCallState to be enabled.
QVariantMap Tp::CallChannel::callStateDetails | ( | ) | const |
Return optional extensible details for the callState(), callFlags() and/or callStateReason().
This function requires CallChannel::FeatureCallState to be enabled.
Contacts Tp::CallChannel::remoteMembers | ( | ) | const |
Return the remote members of this call.
This function requires CallChannel::FeatureCallMembers to be enabled.
CallMemberFlags Tp::CallChannel::remoteMemberFlags | ( | const ContactPtr & | member | ) | const |
Return the flags that describe the status of a given member of this call.
This function requires CallChannel::FeatureCallMembers to be enabled.
member | The member of interest. |
CallContents Tp::CallChannel::contents | ( | ) | const |
Return a list of media contents in this channel.
This methods requires CallChannel::FeatureContents to be enabled.
CallContents Tp::CallChannel::contentsForType | ( | MediaStreamType | type | ) | const |
Return a list of media contents in this channel for the given type type.
This methods requires CallChannel::FeatureContents to be enabled.
type | The interested type. |
CallContentPtr Tp::CallChannel::contentByName | ( | const QString & | contentName | ) | const |
Return the media content in this channel that has the specified name.
This methods requires CallChannel::FeatureContents to be enabled.
name | The interested name. |
PendingCallContent * Tp::CallChannel::requestContent | ( | const QString & | name, |
MediaStreamType | type, | ||
MediaStreamDirection | direction | ||
) |
Request a new media content to be created to exchange the given type type of media.
This methods requires CallChannel::FeatureContents to be enabled.
Return whether the local user has placed this channel on hold.
This method requires CallChannel::FeatureHoldState to be enabled.
Return the reason why localHoldState() changed to its current value.
This method requires CallChannel::FeatureLocalHoldState to be enabled.
PendingOperation * Tp::CallChannel::requestHold | ( | bool | hold | ) |
Request that the channel be put on hold (be instructed not to send any media streams to you) or be taken off hold.
If the connection manager can immediately tell that the requested state change could not possibly succeed, the resulting PendingOperation will fail with error code TP_QT_ERROR_NOT_AVAILABLE. If the requested state is the same as the current state, the resulting PendingOperation will finish successfully.
Otherwise, the channel's local hold state will change to Tp::LocalHoldStatePendingHold or Tp::LocalHoldStatePendingUnhold (as appropriate), then the resulting PendingOperation will finish successfully.
The eventual success or failure of the request is indicated by a subsequent localHoldStateChanged() signal, changing the local hold state to Tp::LocalHoldStateHeld or Tp::LocalHoldStateUnheld.
If the channel has multiple streams, and the connection manager succeeds in changing the hold state of one stream but fails to change the hold state of another, it will attempt to revert all streams to their previous hold states.
If the channel does not support the TP_QT_IFACE_CHANNEL_INTERFACE_HOLD interface, the PendingOperation will fail with error code TP_QT_ERROR_NOT_IMPLEMENTED.
hold | A boolean indicating whether or not the channel should be on hold |
void Tp::CallChannel::callStateChanged | ( | Tp::CallState | state | ) | [signal] |
This signal is emitted when the value of callState() changes.
state | The new state. |
void Tp::CallChannel::callFlagsChanged | ( | Tp::CallFlags | flags | ) | [signal] |
This signal is emitted when the value of callFlags() changes.
flags | The new flags. |
void Tp::CallChannel::remoteMemberFlagsChanged | ( | const QHash< Tp::ContactPtr, Tp::CallMemberFlags > & | remoteMemberFlags, |
const Tp::CallStateReason & | reason | ||
) | [signal] |
This signal is emitted when the flags of members of the call change, or when new members are added in the call.
remoteMemberFlags | A maping of all the call members whose flags were changed to their new flags, and of all the new members of the call to their initial flags. |
reason | The reason for this change. |
void Tp::CallChannel::remoteMembersRemoved | ( | const Tp::Contacts & | remoteMembers, |
const Tp::CallStateReason & | reason | ||
) | [signal] |
This signal is emitted when remote members are removed from the call.
remoteMembers | The members that were removed. |
reason | The reason for this removal. |
void Tp::CallChannel::contentAdded | ( | const Tp::CallContentPtr & | content | ) | [signal] |
This signal is emitted when a media content is added to this channel.
content | The media content that was added. |
void Tp::CallChannel::contentRemoved | ( | const Tp::CallContentPtr & | content, |
const Tp::CallStateReason & | reason | ||
) | [signal] |
This signal is emitted when a media content is removed from this channel.
content | The media content that was removed. |
reason | The reason for this removal. |
void Tp::CallChannel::localHoldStateChanged | ( | Tp::LocalHoldState | state, |
Tp::LocalHoldStateReason | reason | ||
) | [signal] |
This signal is emitted when the local hold state of this channel changes.
state | The new local hold state of this channel. |
reason | The reason why the change occurred. |
const Feature Tp::CallChannel::FeatureCore [static] |
Feature representing the core that needs to become ready to make the CallChannel object usable.
When calling isReady(), becomeReady(), this feature is implicitly added to the requested features.
Reimplemented from Tp::Channel.
const Feature Tp::CallChannel::FeatureCallState [static] |
Feature used in order to access call state specific methods.
See call state specific methods' documentation for more details.
const Feature Tp::CallChannel::FeatureCallMembers [static] |
Feature used in order to access members specific methods.
See local members specific methods' documentation for more details.
const Feature Tp::CallChannel::FeatureContents [static] |
Feature used in order to access content specific methods.
See media content specific methods' documentation for more details.
const Feature Tp::CallChannel::FeatureLocalHoldState [static] |
Feature used in order to access local hold state info.
See local hold state specific methods' documentation for more details.
Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation | Telepathy-Qt 0.9.3 |