TelepathyGLib.ChannelDispatcher¶

Subclasses:: None

Methods¶

Inherited:: TelepathyGLib.Proxy (11), GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`init_known_interfaces` ()
class	`new` (bus_daemon)
	`present_channel_async` (channel, user_action_time, callback, *user_data)
	`present_channel_finish` (result)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

Inherited:: TelepathyGLib.Proxy (5)

Signals¶

Inherited:: TelepathyGLib.Proxy (2), GObject.Object (1)

Fields¶

Inherited:: TelepathyGLib.Proxy (2), GObject.Object (1)

Name	Type	Access	Description
parent	`TelepathyGLib.Proxy`	r

Class Details¶

class TelepathyGLib.ChannelDispatcher(**kwargs)¶

Bases:: TelepathyGLib.Proxy
Abstract:: No
Structure:: TelepathyGLib.ChannelDispatcherClass

The Channel Dispatcher’s main D-Bus API is used to request channels, which is done by calling tp_cli_channel_dispatcher_call_create_channel() or tp_cli_channel_dispatcher_call_ensure_channel() as appropriate.

The Telepathy Channel Dispatcher is also responsible for responding to new channels and launching client processes to handle them. However, clients that can work with incoming channels do not have to call methods on the channel dispatcher: instead, they must register with the channel dispatcher passively, by taking a bus name starting with TelepathyGLib.CLIENT_BUS_NAME_BASE and implementing the #TpSvcClient interface. See the Telepathy D-Bus Interface Specification for details.

This proxy is usable but incomplete: convenience methods will be added in a later version of telepathy-glib, along with a mechanism similar to tp_connection_call_when_ready().

New in version 0.7.32.

classmethod init_known_interfaces()¶: Ensure that the known interfaces for TelepathyGLib.ChannelDispatcher have been set up. This is done automatically when necessary, but for correct overriding of library interfaces by local extensions, you should call this function before calling tp_proxy_or_subclass_hook_on_interface_add() with first argument %TP_TYPE_CHANNEL_DISPATCHER.

New in version 0.7.32.

classmethod new(bus_daemon)¶

Parameters:: bus_daemon (TelepathyGLib.DBusDaemon) – Proxy for the D-Bus daemon
Returns:: a new reference to a channel dispatcher proxy
Return type:: TelepathyGLib.ChannelDispatcher

Convenience function to create a new channel dispatcher proxy.

present_channel_async(channel, user_action_time, callback, *user_data)¶

Parameters:

channel (TelepathyGLib.Channel) – a TelepathyGLib.Channel
user_action_time (int) – the time at which user action occurred, or TelepathyGLib.USER_ACTION_TIME_NOT_USER_ACTION if this presentation request is for some reason not involving user action.
callback (Gio.AsyncReadyCallback or None) – a callback to call when the request is satisfied
user_data (object or None) – data to pass to callback

Asynchronously calls PresentChannel on the ChannelDispatcher to ask to the handler of channel to re-present it to the user. You can then call TelepathyGLib.ChannelDispatcher.present_channel_finish() to get the result of the operation.

New in version 0.15.0.

present_channel_finish(result)¶

Parameters:: result (Gio.AsyncResult) – a Gio.AsyncResult
Raises:: GLib.Error
Returns:: True if the call succeeded, otherwise False.
Return type:: bool

Finishes an async channel presentation request started using TelepathyGLib.ChannelDispatcher.present_channel_async().

New in version 0.15.0.