## EmpathyCallHandler

EmpathyCallHandler

## Synopsis

                        EmpathyCallHandler;
    EmpathyCallHandler * empathy_call_handler_new_for_contact
                                                            (EmpathyContact *contact);
    EmpathyCallHandler * empathy_call_handler_new_for_contact_with_streams
                                                            (EmpathyContact *contact,
                                                             gboolean audio,
                                                             gboolean video);
    EmpathyCallHandler * empathy_call_handler_new_for_channel
                                                            (EmpathyTpCall *call);
    void                empathy_call_handler_start_call     (EmpathyCallHandler *handler);
    void                empathy_call_handler_stop_call      (EmpathyCallHandler *handler);
    gboolean            empathy_call_handler_has_initial_video
                                                            (EmpathyCallHandler *handler);
    void                empathy_call_handler_bus_message    (EmpathyCallHandler *handler,
                                                             GstBus *bus,
                                                             GstMessage *message);

## Object Hierarchy

      GObject
       +----EmpathyCallHandler

## Properties

      "contact"                  EmpathyContact*       : Read / Write / Construct Only
      "initial-audio"            gboolean              : Read / Write / Construct Only
      "initial-video"            gboolean              : Read / Write / Construct Only
      "tp-call"                  EmpathyTpCall*        : Read / Write / Construct Only

## Signals

      "closed"                                         : Run Last
      "conference-added"                               : Run Last
      "request-resource"                               : Run Last
      "sink-pad-added"                                 : Run Last
      "src-pad-added"                                  : Run Last
      "stream-closed"                                  : Run Last

## Description

## Details

### EmpathyCallHandler

    typedef struct _EmpathyCallHandler EmpathyCallHandler;

### empathy_call_handler_new_for_contact ()

    EmpathyCallHandler * empathy_call_handler_new_for_contact
                                                            (EmpathyContact *contact);

Creates a new EmpathyCallHandler with contact `contact`.

`contact` : | an EmpathyContact
Returns : | a new EmpathyCallHandler

### empathy_call_handler_new_for_contact_with_streams ()

    EmpathyCallHandler * empathy_call_handler_new_for_contact_with_streams
                                                            (EmpathyContact *contact,
                                                             gboolean audio,
                                                             gboolean video);

Creates a new EmpathyCallHandler with contact `contact`.

`contact` : | an EmpathyContact
`audio` : | if `TRUE` the call will be started with audio
`video` : | if `TRUE` the call will be started with video
Returns : | a new EmpathyCallHandler

### empathy_call_handler_new_for_channel ()

    EmpathyCallHandler * empathy_call_handler_new_for_channel
                                                            (EmpathyTpCall *call);

`call` : |
Returns : |

### empathy_call_handler_start_call ()

    void                empathy_call_handler_start_call     (EmpathyCallHandler *handler);

`handler` : |

### empathy_call_handler_stop_call ()

    void                empathy_call_handler_stop_call      (EmpathyCallHandler *handler);

Closes the EmpathyCallHandler's call and frees its resources.

`handler` : | an EmpathyCallHandler

### empathy_call_handler_has_initial_video ()

    gboolean            empathy_call_handler_has_initial_video
                                                            (EmpathyCallHandler *handler);

Return `TRUE` if the call managed by this EmpathyCallHandler was created with video enabled

`handler` : | an EmpathyCallHandler
Returns : | `TRUE` if the call was created as a video conversation.

### empathy_call_handler_bus_message ()

    void                empathy_call_handler_bus_message    (EmpathyCallHandler *handler,
                                                             GstBus *bus,
                                                             GstMessage *message);

`handler` : |
`bus` : |
`message` : |

## Property Details

### The `"contact"` property

      "contact"                  EmpathyContact*       : Read / Write / Construct Only

The remote contact.

### The `"initial-audio"` property

      "initial-audio"            gboolean              : Read / Write / Construct Only

Whether the call should start with audio.

Default value: TRUE

### The `"initial-video"` property

      "initial-video"            gboolean              : Read / Write / Construct Only

Whether the call should start with video.

Default value: FALSE

### The `"tp-call"` property

      "tp-call"                  EmpathyTpCall*        : Read / Write / Construct Only

The calls channel wrapper.

## Signal Details

### The `"closed"` signal

    void                user_function                      (EmpathyCallHandler *empathycallhandler,
                                                            gpointer            user_data)               : Run Last

`empathycallhandler` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The `"conference-added"` signal

    void                user_function                      (EmpathyCallHandler *empathycallhandler,
                                                            FsConference       *arg1,
                                                            gpointer            user_data)               : Run Last

`empathycallhandler` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.

### The `"request-resource"` signal

    gboolean            user_function                      (EmpathyCallHandler *empathycallhandler,
                                                            guint               arg1,
                                                            guint               arg2,
                                                            gpointer            user_data)               : Run Last

`empathycallhandler` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.
Returns : |

### The `"sink-pad-added"` signal

    void                user_function                      (EmpathyCallHandler *empathycallhandler,
                                                            GstPad             *arg1,
                                                            guint               arg2,
                                                            gpointer            user_data)               : Run Last

`empathycallhandler` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"src-pad-added"` signal

    void                user_function                      (EmpathyCallHandler *empathycallhandler,
                                                            GstPad             *arg1,
                                                            guint               arg2,
                                                            gpointer            user_data)               : Run Last

`empathycallhandler` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The `"stream-closed"` signal

    void                user_function                      (EmpathyCallHandler *empathycallhandler,
                                                            TfStream           *arg1,
                                                            gpointer            user_data)               : Run Last

`empathycallhandler` : | the object which received the signal.
`arg1` : |
`user_data` : | user data set when the signal handler was connected.