TpChannelDispatcher

TpChannelDispatcher — proxy object for the Telepathy channel dispatcher

Synopsis

#include <telepathy-glib/telepathy-glib.h>

struct              TpChannelDispatcher;
struct              TpChannelDispatcherClass;
TpChannelDispatcher * tp_channel_dispatcher_new         (TpDBusDaemon *bus_daemon);
void                tp_channel_dispatcher_init_known_interfaces
                                                        (void);

Object Hierarchy

  GObject
   +----TpProxy
         +----TpChannelDispatcher

Description

The TpChannelDispatcher object can be used to communicate with any implementation of the Telepathy ChannelDispatcher service to request new channels.

Details

struct TpChannelDispatcher

struct TpChannelDispatcher;

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 TP_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.

Since 0.7.32


struct TpChannelDispatcherClass

struct TpChannelDispatcherClass {
};

The class of a TpChannelDispatcher.


tp_channel_dispatcher_new ()

TpChannelDispatcher * tp_channel_dispatcher_new         (TpDBusDaemon *bus_daemon);

Convenience function to create a new channel dispatcher proxy.

bus_daemon :

Proxy for the D-Bus daemon

Returns :

a new reference to a channel dispatcher proxy

tp_channel_dispatcher_init_known_interfaces ()

void                tp_channel_dispatcher_init_known_interfaces
                                                        (void);

Ensure that the known interfaces for TpChannelDispatcher 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.

Since 0.7.32

See Also

TpChannelDispatchOperation, TpChannelRequest