tp_simple_client_factory_new ()

TpSimpleClientFactory *
tp_simple_client_factory_new (TpDBusDaemon *dbus);

Creates a new TpSimpleClientFactory instance. If dbus is NULL, tp_dbus_daemon_dup() will be used.

Since: 0.15.5

tp_simple_client_factory_get_dbus_daemon ()

TpDBusDaemon *
tp_simple_client_factory_get_dbus_daemon
                               (TpSimpleClientFactory *self);

Since: 0.15.5

tp_simple_client_factory_ensure_account ()

TpAccount *
tp_simple_client_factory_ensure_account
                               (TpSimpleClientFactory *self,
                                const gchar *object_path,
                                const GHashTable *immutable_properties,
                                GError **error);

Returns a TpAccount proxy for the account at object_path . The returned TpAccount is cached; the same TpAccount object will be returned by this function repeatedly, as long as at least one reference exists.

Note that the returned TpAccount is not guaranteed to be ready; the caller is responsible for calling tp_proxy_prepare_async() with the desired features (as given by tp_simple_client_factory_dup_account_features()).

This function is rather low-level. tp_account_manager_dup_valid_accounts() and “validity-changed” are more appropriate for most applications.

Since: 0.15.5

tp_simple_client_factory_dup_account_features ()

GArray *
tp_simple_client_factory_dup_account_features
                               (TpSimpleClientFactory *self,
                                TpAccount *account);

Return a zero-terminated GArray containing the TpAccount features that should be prepared on account .

Since: 0.15.5

tp_simple_client_factory_add_account_features ()

void
tp_simple_client_factory_add_account_features
                               (TpSimpleClientFactory *self,
                                const GQuark *features);

Add features to the desired features to be prepared on TpAccount objects. Those features will be added to the features already returned be tp_simple_client_factory_dup_account_features().

It is not necessary to add TP_ACCOUNT_FEATURE_CORE as it is already included by default.

Note that these features will not be added to existing TpAccount objects; the user must call tp_proxy_prepare_async() themself.

Since: 0.15.5

tp_simple_client_factory_add_account_features_varargs ()

void
tp_simple_client_factory_add_account_features_varargs
                               (TpSimpleClientFactory *self,
                                GQuark feature,
                                ...);

The same as tp_simple_client_factory_add_account_features(), but with a more convenient calling convention from C.

[skip]

Since: 0.15.5

tp_simple_client_factory_ensure_connection ()

TpConnection *
tp_simple_client_factory_ensure_connection
                               (TpSimpleClientFactory *self,
                                const gchar *object_path,
                                const GHashTable *immutable_properties,
                                GError **error);

Returns a TpConnection proxy for the connection at object_path . The returned TpConnection is cached; the same TpConnection object will be returned by this function repeatedly, as long as at least one reference exists.

Note that the returned TpConnection is not guaranteed to be ready; the caller is responsible for calling tp_proxy_prepare_async() with the desired features (as given by tp_simple_client_factory_dup_connection_features()).

This function is rather low-level. “connection” is more appropriate for most applications.

Since: 0.15.5

tp_simple_client_factory_dup_connection_features ()

GArray *
tp_simple_client_factory_dup_connection_features
                               (TpSimpleClientFactory *self,
                                TpConnection *connection);

Return a zero-terminated GArray containing the TpConnection features that should be prepared on connection .

Since: 0.15.5

tp_simple_client_factory_add_connection_features ()

void
tp_simple_client_factory_add_connection_features
                               (TpSimpleClientFactory *self,
                                const GQuark *features);

Add features to the desired features to be prepared on TpConnection objects. Those features will be added to the features already returned be tp_simple_client_factory_dup_connection_features().

It is not necessary to add TP_CONNECTION_FEATURE_CORE as it is already included by default.

Note that these features will not be added to existing TpConnection objects; the user must call tp_proxy_prepare_async() themself.

Since: 0.15.5

tp_simple_client_factory_add_connection_features_varargs ()

void
tp_simple_client_factory_add_connection_features_varargs
                               (TpSimpleClientFactory *self,
                                GQuark feature,
                                ...);

The same as tp_simple_client_factory_add_connection_features(), but with a more convenient calling convention from C.

[skip]

Since: 0.15.5

tp_simple_client_factory_ensure_channel ()

TpChannel *
tp_simple_client_factory_ensure_channel
                               (TpSimpleClientFactory *self,
                                TpConnection *connection,
                                const gchar *object_path,
                                const GHashTable *immutable_properties,
                                GError **error);

Returns a TpChannel proxy for the channel at object_path on connection . The returned TpChannel is cached; the same TpChannel object will be returned by this function repeatedly, as long as at least one reference exists.

Note that the returned TpChannel is not guaranteed to be ready; the caller is responsible for calling tp_proxy_prepare_async() with the desired features (as given by tp_simple_client_factory_dup_channel_features()).

This function is rather low-level. TpAccountChannelRequest and TpBaseClient are more appropriate ways to obtain channels for most applications.

Since: 0.15.5

tp_simple_client_factory_dup_channel_features ()

GArray *
tp_simple_client_factory_dup_channel_features
                               (TpSimpleClientFactory *self,
                                TpChannel *channel);

Return a zero-terminated GArray containing the TpChannel features that should be prepared on channel .

Since: 0.15.5

tp_simple_client_factory_add_channel_features ()

void
tp_simple_client_factory_add_channel_features
                               (TpSimpleClientFactory *self,
                                const GQuark *features);

Add features to the desired features to be prepared on TpChannel objects. Those features will be added to the features already returned be tp_simple_client_factory_dup_channel_features().

It is not necessary to add TP_CHANNEL_FEATURE_CORE as it is already included by default.

Note that these features will not be added to existing TpChannel objects; the user must call tp_proxy_prepare_async() themself.

Since: 0.15.5

tp_simple_client_factory_add_channel_features_varargs ()

void
tp_simple_client_factory_add_channel_features_varargs
                               (TpSimpleClientFactory *self,
                                GQuark feature,
                                ...);

The same as tp_simple_client_factory_add_channel_features(), but with a more convenient calling convention from C.

[skip]

Since: 0.15.5

tp_simple_client_factory_ensure_contact ()

TpContact *
tp_simple_client_factory_ensure_contact
                               (TpSimpleClientFactory *self,
                                TpConnection *connection,
                                TpHandle handle,
                                const gchar *identifier);

Returns a TpContact representing identifier (and handle ) on connection . The returned TpContact is cached; the same TpContact object will be returned by this function repeatedly, as long as at least one reference exists.

Note that the returned TpContact is not guaranteed to be ready; the caller is responsible for calling tp_connection_upgrade_contacts() with the desired features (as given by tp_simple_client_factory_dup_contact_features()).

For this function to work properly, tp_connection_has_immortal_handles() must return TRUE for connection .

Since: 0.15.5

tp_simple_client_factory_upgrade_contacts_async ()

void
tp_simple_client_factory_upgrade_contacts_async
                               (TpSimpleClientFactory *self,
                                TpConnection *connection,
                                guint n_contacts,
                                TpContact * const *contacts,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Same as tp_connection_upgrade_contacts_async(), but prepare contacts with all features previously passed to tp_simple_client_factory_add_contact_features().

Since: 0.19.1

tp_simple_client_factory_upgrade_contacts_finish ()

gboolean
tp_simple_client_factory_upgrade_contacts_finish
                               (TpSimpleClientFactory *self,
                                GAsyncResult *result,
                                GPtrArray **contacts,
                                GError **error);

Finishes tp_simple_client_factory_upgrade_contacts_async()

Since: 0.19.1

tp_simple_client_factory_ensure_contact_by_id_async ()

void
tp_simple_client_factory_ensure_contact_by_id_async
                               (TpSimpleClientFactory *self,
                                TpConnection *connection,
                                const gchar *identifier,
                                GAsyncReadyCallback callback,
                                gpointer user_data);

Same as tp_connection_dup_contact_by_id_async(), but prepare the contact with all features previously passed to tp_simple_client_factory_add_contact_features().

Since: 0.19.1

tp_simple_client_factory_ensure_contact_by_id_finish ()

TpContact *
tp_simple_client_factory_ensure_contact_by_id_finish
                               (TpSimpleClientFactory *self,
                                GAsyncResult *result,
                                GError **error);

Finishes tp_simple_client_factory_ensure_contact_by_id_async()

Since: 0.19.1

tp_simple_client_factory_dup_contact_features ()

GArray *
tp_simple_client_factory_dup_contact_features
                               (TpSimpleClientFactory *self,
                                TpConnection *connection);

Return a GArray containing the TpContactFeature that should be prepared on all contacts of connection .

Since: 0.15.5

tp_simple_client_factory_add_contact_features ()

void
tp_simple_client_factory_add_contact_features
                               (TpSimpleClientFactory *self,
                                guint n_features,
                                const TpContactFeature *features);

Add features to the desired features to be prepared on TpContact objects. Those features will be added to the features already returned be tp_simple_client_factory_dup_contact_features().

Note that these features will not be added to existing TpContact objects; the user must call tp_connection_upgrade_contacts() themself.

Since: 0.15.5

tp_simple_client_factory_add_contact_features_varargs ()

void
tp_simple_client_factory_add_contact_features_varargs
                               (TpSimpleClientFactory *self,
                                TpContactFeature feature,
                                ...);

The same as tp_simple_client_factory_add_contact_features(), but with a more convenient calling convention from C.

[skip]

Since: 0.15.5

TpSimpleClientFactory

typedef struct _TpSimpleClientFactory TpSimpleClientFactory;

Data structure representing a TpSimpleClientFactory

Since: 0.15.5

struct TpSimpleClientFactoryClass

struct TpSimpleClientFactoryClass {
    GObjectClass parent_class;

    /* TpAccount */
    TpAccount * (*create_account) (TpSimpleClientFactory *self,
        const gchar *object_path,
        const GHashTable *immutable_properties,
        GError **error);
    GArray * (*dup_account_features) (TpSimpleClientFactory *self,
        TpAccount *account);

    /* TpConnection */
    TpConnection * (*create_connection) (TpSimpleClientFactory *self,
        const gchar *object_path,
        const GHashTable *immutable_properties,
        GError **error);
    GArray * (*dup_connection_features) (TpSimpleClientFactory *self,
        TpConnection *connection);

    /* TpChannel */
    TpChannel * (*create_channel) (TpSimpleClientFactory *self,
        TpConnection *conn,
        const gchar *object_path,
        const GHashTable *immutable_properties,
        GError **error);
    GArray * (*dup_channel_features) (TpSimpleClientFactory *self,
        TpChannel *channel);

    /* TpContact */
    TpContact * (*create_contact) (TpSimpleClientFactory *self,
        TpConnection *connection,
        TpHandle handle,
        const gchar *identifier);
    GArray * (*dup_contact_features) (TpSimpleClientFactory *self,
        TpConnection *connection);
};

The class structure for TpSimpleClientFactory.

TpSimpleClientFactory maintains a cache of previously-constructed proxy objects, so the implementations of create_account , create_connection , create_channel , and create_contact may assume that a new object should be created when they are called. The default implementations create unadorned instances of the relevant classes; subclasses of the factory may choose to create more interesting proxy subclasses.

The default implementation of dup_channel_features returns TP_CHANNEL_FEATURE_CORE, plus all features passed to tp_simple_client_factory_add_channel_features() by the application. Subclasses may override this method to prepare more interesting features from subclasses of TpChannel, for instance. The default implementations of the other dup_x_features methods behave similarly.

Since: 0.15.5

The “dbus-daemon” property

  “dbus-daemon”              TpDBusDaemon *

The D-Bus daemon for this object.

Owner: TpSimpleClientFactory

Flags: Read / Write / Construct Only