struct TpStreamTubeChannel

struct TpStreamTubeChannel;

Data structure representing a TpStreamTubeChannel.

Since 0.13.2

struct TpStreamTubeChannelClass

struct TpStreamTubeChannelClass {
};

The class of a TpStreamTubeChannel.

Since 0.13.2

tp_stream_tube_channel_accept_async ()

void                tp_stream_tube_channel_accept_async (TpStreamTubeChannel *self,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Accept an incoming stream tube. When the tube has been accepted, callback will be called. You can then call tp_stream_tube_channel_accept_finish() to get a TpStreamTubeConnection connected to the tube.

Since 0.13.2

tp_stream_tube_channel_accept_finish ()

TpStreamTubeConnection * tp_stream_tube_channel_accept_finish
                                                        (TpStreamTubeChannel *self,
                                                         GAsyncResult *result,
                                                         GError **error);

Finishes accepting an incoming stream tube. The returned TpStreamTubeConnection can then be used to exchange data through the tube.

Since 0.13.2

tp_stream_tube_channel_get_parameters ()

GHashTable *        tp_stream_tube_channel_get_parameters
                                                        (TpStreamTubeChannel *self);

Return the "parameters" property

Since 0.13.2

tp_stream_tube_channel_dup_parameters_vardict ()

GVariant *          tp_stream_tube_channel_dup_parameters_vardict
                                                        (TpStreamTubeChannel *self);

Return the parameters of the dbus-tube channel in a variant of type G_VARIANT_TYPE_VARDICT whose keys are strings representing parameter names and values are variants representing corresponding parameter values set by the offerer when offering this channel.

The GVariant returned is NULL if this is an outgoing tube that has not yet been offered or the parameters property has not been set.

Use g_variant_lookup(), g_variant_lookup_value(), or tp_vardict_get_uint32() and similar functions for convenient access to the values.

Since 0.19.10

tp_stream_tube_channel_get_service ()

const gchar *       tp_stream_tube_channel_get_service  (TpStreamTubeChannel *self);

Return the "service" property

Since 0.13.2

tp_stream_tube_channel_new ()

TpStreamTubeChannel * tp_stream_tube_channel_new        (TpConnection *conn,
                                                         const gchar *object_path,
                                                         const GHashTable *immutable_properties,
                                                         GError **error);

Creates a new TpStreamTubeChannel proxy object from the provided path and properties. Most developers will not need to use this function; use TpAutomaticProxyFactory to automatically create TpStreamTubeChannel proxy objects.

Since 0.13.2

tp_stream_tube_channel_offer_async ()

void                tp_stream_tube_channel_offer_async  (TpStreamTubeChannel *self,
                                                         GHashTable *params,
                                                         GAsyncReadyCallback callback,
                                                         gpointer user_data);

Offer an outgoing stream tube. When the tube has been offered, callback will be called. You can then call tp_stream_tube_channel_offer_finish() to get the result of the operation.

You have to connect to the "incoming" signal to get a TpStreamTubeConnection each time a contact establishes a connection to the tube.

Since 0.13.2

tp_stream_tube_channel_offer_finish ()

gboolean            tp_stream_tube_channel_offer_finish (TpStreamTubeChannel *self,
                                                         GAsyncResult *result,
                                                         GError **error);

Finishes offering an outgoing stream tube.

Since 0.13.2

The "parameters" property

  "parameters"               GHashTable_gchararray+GValue_*  : Read

A string to GValue GHashTable representing the parameters of the tube.

Will be NULL for outgoing tubes until the tube has been offered.

In high-level language bindings, use "parameters-vardict" or tp_stream_tube_channel_dup_parameters_vardict() to get the same information in a more convenient format.

Since 0.13.2

The "parameters-vardict" property

  "parameters-vardict"       GVariant*             : Read

A G_VARIANT_TYPE_VARDICT representing the parameters of the tube.

Will be NULL for outgoing tubes until the tube has been offered.

Allowed values: GVariant<a{sv}>

Default value: NULL

Since 0.19.10

The "service" property

  "service"                  gchar*                : Read

A string representing the service name that will be used over the tube.

Default value: NULL

Since 0.13.2

The "incoming" signal

void                user_function                      (TpStreamTubeChannel    *self,
                                                        TpStreamTubeConnection *tube_connection,
                                                        gpointer                user_data)            : Run Last

The ::incoming signal is emitted on offered Tubes when a new incoming connection is made from a remote user (one accepting the Tube).

Consumers of this signal must take their own references to tube_connection