farsight_transmitter_add_remote_candidates ()

void
farsight_transmitter_add_remote_candidates
                               (FarsightTransmitter *self,
                                const GList *remote_candidate_list);

Tells the transmitter what the remote candidates are for transmission.

farsight_transmitter_destroy ()

void
farsight_transmitter_destroy (FarsightTransmitter *self);

Destroy this transmitter and all resources allocated by it. This function should be used instead of g_object_unref in order to destroy the transmitter.

farsight_transmitter_factory_make ()

FarsightTransmitter *
farsight_transmitter_factory_make (const gchar *transmitter_id);

farsight_transmitter_get_gst_sink ()

GstElement *
farsight_transmitter_get_gst_sink (FarsightTransmitter *self);

Asks the transmitter to return the pointer to the gstreamer sink used by this transmitter.

farsight_transmitter_get_gst_src ()

GstElement *
farsight_transmitter_get_gst_src (FarsightTransmitter *self);

Asks the transmitter to return the pointer to the gstreamer source used by this transmitter.

farsight_transmitter_prepare ()

gboolean
farsight_transmitter_prepare (FarsightTransmitter *self);

This tells the transmitter to prepare itself for transmission. Basically it discovers local candidates, opens sockets and other specific operations.

farsight_transmitter_signal_connection_state_changed ()

void
farsight_transmitter_signal_connection_state_changed
                               (FarsightTransmitter *self,
                                FarsightTransmitterState state);

Used by subclasses of FarsightTransmitter to emit an

farsight_transmitter_signal_error ()

void
farsight_transmitter_signal_error (FarsightTransmitter *self,
                                   FarsightTransmitterError type,
                                   gchar *message);

Used by subclasses of FarsightTransmitter to emit an

farsight_transmitter_signal_native_candidates_prepared ()

void
farsight_transmitter_signal_native_candidates_prepared
                               (FarsightTransmitter *self);

farsight_transmitter_signal_new_active_candidate_pair ()

void
farsight_transmitter_signal_new_active_candidate_pair
                               (FarsightTransmitter *self,
                                const gchar *native_candidate_id,
                                const gchar *remote_candidate_id);

Used by subclasses of FarsightTransmitter to emit an

farsight_transmitter_signal_new_native_candidate ()

void
farsight_transmitter_signal_new_native_candidate
                               (FarsightTransmitter *self,
                                const FarsightTransportInfo *candidate);

farsight_transmitter_stop ()

gboolean
farsight_transmitter_stop (FarsightTransmitter *self);

This tells the transmitter to stop transmitting and shutdown any sockets.

struct FarsightTransmitter

struct FarsightTransmitter;

A network transmitter that farsight plugins can use to communicate on the network. These transmitter can contain advanced connectivity features such as STUN, TURN or can be plain UDP / TCP sockets.

struct FarsightTransmitterClass

struct FarsightTransmitterClass {
  GObjectClass parent_class;

  /*virtual methods */
  gboolean (* prepare) (FarsightTransmitter *self);
  gboolean (* stop) (FarsightTransmitter *self);

  void (* add_remote_candidates) (FarsightTransmitter *self, const GList *remote_candidate_list);

  GstElement * (* get_gst_src) (FarsightTransmitter *self);
  GstElement * (* get_gst_sink) (FarsightTransmitter *self);
};

enum FarsightTransmitterError

Enum used to indicate an error condition.

enum FarsightTransmitterState

An enum used to signal the state of a FarsightTransmitter

The “media-type” property

  “media-type”               guint

The media type (audio/video) of the stream.

Flags: Read / Write

Allowed values: <= 1

Default value: 0

The “connection-state-changed” signal

void
user_function (FarsightTransmitter *self,
               gint                 state,
               gpointer             user_data)

This signal is emitted when the connection state changes.

Flags: Run Last

The “error” signal

void
user_function (FarsightTransmitter *self,
               gint                 type,
               gchar               *message,
               gpointer             user_data)

This signal is emitted in any error condition

Flags: Run Last

The “native-candidates-prepared” signal

void
user_function (FarsightTransmitter *self,
               gpointer             user_data)

This signal is emitted when the native candidates have been prepared. This usually means all of the local ports have been opened, local interfaces have been found, and/or external ports have been found, and/or relay server has been setup, or anything else the protocol needs. After emission of this signal, farsight_transmitter_get_native_candidate_list should return meaningful data

Flags: Run Last

The “new-active-candidate-pair” signal

void
user_function (FarsightTransmitter *self,
               gchar               *native_candidate_id,
               gchar               *remote_candidate_id,
               gpointer             user_data)

Emitted when this FarsightTransmitter has chosen a new active candidate pair to use to connect to the remote client.

Flags: Run Last

The “new-native-candidate” signal

void
user_function (FarsightTransmitter *self,
               gpointer             candidate,
               gpointer             user_data)

This signal is emitted when a new native candidate is found.

Flags: Run Last