TpBaseClient

typedef struct _TpBaseClient TpBaseClient;

Data structure representing a generic TpSvcClient implementation.

Since 0.11.UNRELEASED

tp_base_client_add_observer_filter ()

void                tp_base_client_add_observer_filter  (TpBaseClient *self,
                                                         GHashTable *filter);

Register a new channel class as Observer.ObserverChannelFilter. The observe_channels virtual method set up using tp_base_client_implement_observe_channels() will be called whenever a new channel's properties match the ones in filter.

This method may only be called before tp_base_client_register() is called, and may only be called on objects whose class has called tp_base_client_implement_observe_channels().

Since 0.11.UNRELEASED

tp_base_client_take_observer_filter ()

void                tp_base_client_take_observer_filter (TpBaseClient *self,
                                                         GHashTable *filter);

The same as tp_base_client_add_observer_filter(), but ownership of filter is taken by self. This makes it convenient to call using tp_asv_new():

1
2
3
4
5
6
7

tp_base_client_take_observer_filter (client,
   tp_asv_new (
       TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
           TP_IFACE_CHANNEL_TYPE_TEXT,
       TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT,
           TP_HANDLE_TYPE_CONTACT,
       ...));

Since 0.11.UNRELEASED

tp_base_client_set_observer_recover ()

void                tp_base_client_set_observer_recover (TpBaseClient *self,
                                                         gboolean recover);

Set whether the channel dispatcher should attempt to recover this Observer if it crashes. (This is implemented by setting the value of its Recover D-Bus property.)

Normally, Observers are only notified when new channels appear. If an Observer is set to recover, when it registers with tp_base_client_register(), it will also be told about any channels that already existed before it started.

For Observers that are activatable as a D-Bus service, if the Observer exits or crashes while there are any channels that match its filter, it will automatically be restarted by service-activation.

This method may only be called before tp_base_client_register() is called, and may only be called on objects whose class has called tp_base_client_implement_observe_channels().

Since 0.11.UNRELEASED

TpBaseClientClassObserveChannelsImpl ()

void                (*TpBaseClientClassObserveChannelsImpl)
                                                        (TpBaseClient *client,
                                                         TpAccount *account,
                                                         TpConnection *connection,
                                                         GList *channels,
                                                         TpChannelDispatchOperation *dispatch_operation,
                                                         GList *requests,
                                                         TpObserveChannelsContext *context);

Signature of the implementation of the ObserveChannels method.

This function must call either tp_observe_channels_context_accept(), tp_observe_channels_context_delay() or tp_observe_channels_context_fail() on context before it returns.

Since 0.11.UNRELEASED

tp_base_client_implement_observe_channels ()

void                tp_base_client_implement_observe_channels
                                                        (TpBaseClientClass *klass,
                                                         TpBaseClientClassObserveChannelsImpl impl);

Called by subclasses to define the actual implementation of the ObserveChannels() D-Bus method.

Since 0.11.UNRELEASED

tp_base_client_add_approver_filter ()

void                tp_base_client_add_approver_filter  (TpBaseClient *self,
                                                         GHashTable *filter);

Register a new channel class as Approver.ApproverChannelFilter. The add_dispatch_operation virtual method set up using tp_base_client_implement_add_dispatch_operation() will be called whenever a new channel's properties match the ones in filter.

This method may only be called before tp_base_client_register() is called, and may only be called on objects whose class has called tp_base_client_implement_add_dispatch_operation().

Since 0.11.UNRELEASED

tp_base_client_take_approver_filter ()

void                tp_base_client_take_approver_filter (TpBaseClient *self,
                                                         GHashTable *filter);

The same as tp_base_client_add_approver_filter(), but ownership of filter is taken by self. This makes it convenient to call using tp_asv_new():

1
2
3
4
5
6
7

tp_base_client_take_approver_filter (client,
   tp_asv_new (
       TP_PROP_CHANNEL_CHANNEL_TYPE, G_TYPE_STRING,
           TP_IFACE_CHANNEL_TYPE_TEXT,
       TP_PROP_CHANNEL_TARGET_HANDLE_TYPE, G_TYPE_UINT,
           TP_HANDLE_TYPE_CONTACT,
       ...));

Since 0.11.UNRELEASED

TpBaseClientClassAddDispatchOperationImpl ()

void                (*TpBaseClientClassAddDispatchOperationImpl)
                                                        (TpBaseClient *client,
                                                         TpAccount *account,
                                                         TpConnection *connection,
                                                         GList *channels,
                                                         TpChannelDispatchOperation *dispatch_operation,
                                                         TpAddDispatchOperationContext *context);

Signature of the implementation of the AddDispatchOperation method.

This function must call either tp_add_dispatch_operation_context_accept(), tp_add_dispatch_operation_context_delay() or tp_add_dispatch_operation_context_fail() on context before it returns.

The implementation can then use tp_channel_dispatch_operation_handle_with_async() to approve handling of the channels, or tp_channel_dispatch_operation_claim_async() to take responsibility for handling or closing them".

Since 0.11.UNRELEASED

tp_base_client_implement_add_dispatch_operation ()

void                tp_base_client_implement_add_dispatch_operation
                                                        (TpBaseClientClass *klass,
                                                         TpBaseClientClassAddDispatchOperationImpl impl);

Called by subclasses to define the actual implementation of the AddDispatchOperation() D-Bus method.

Since 0.11.UNRELEASED

tp_base_client_register ()

gboolean            tp_base_client_register             (TpBaseClient *self,
                                                         GError **error);

Publish self as an available client. After this method is called, as long as it continues to exist, it will receive and process whatever events were requested via the various filters.

Methods that set the filters and other immutable state, such as tp_base_client_add_observer_filter(), cannot be called after this one.

Since 0.11.UNRELEASED

tp_base_client_get_bus_name ()

const gchar *       tp_base_client_get_bus_name         (TpBaseClient *self);

Return the bus name of self. Note that doesn't mean the client is actually owning this name; for example if tp_base_client_register() has not been called yet or failed.

Since 0.11.UNRELEASED

tp_base_client_get_object_path ()

const gchar *       tp_base_client_get_object_path      (TpBaseClient *self);

Return the object path of self. Note that doesn't mean the client is actually registered on this path; for example if tp_base_client_register() has not been called yet or failed.

Since 0.11.UNRELEASED

The "dbus-daemon" property

  "dbus-daemon"              TpDBusDaemon*         : Read / Write / Construct Only

TpDBusDaemon object encapsulating this object's connection to D-Bus. Read-only except during construction.

This property can't be NULL.

Since 0.11.UNRELEASED

The "name" property

  "name"                     gchar*                : Read / Write / Construct Only

The name of the client. This is used to register the D-Bus service name and object path of the service.

This property can't be NULL.

Default value: NULL

Since 0.11.UNRELEASED

The "uniquify-name" property

  "uniquify-name"            gboolean              : Read / Write / Construct Only

If TRUE, tp_base_client_register() will append an unique token to the service bus name and object path to ensure they are unique.

Default value: FALSE

Since 0.11.UNRELEASED