## TpMediaSessionHandler, TpMediaStreamHandler TpMediaSessionHandler, TpMediaStreamHandler — proxy objects for Telepathy media streaming |

## Synopsis

    #include <telepathy-glib/media-interfaces.h>

    TpMediaSessionHandler * tp_media_session_handler_new    (TpDBusDaemon *dbus,
                                                             const gchar *unique_name,
                                                             const gchar *object_path,
                                                             GError **error);
    void                tp_media_session_handler_init_known_interfaces
                                                            (void);
                        TpMediaSessionHandler;
                        TpMediaSessionHandlerClass;

    TpMediaStreamHandler * tp_media_stream_handler_new      (TpDBusDaemon *dbus,
                                                             const gchar *unique_name,
                                                             const gchar *object_path,
                                                             GError **error);
    void                tp_media_stream_handler_init_known_interfaces
                                                            (void);
                        TpMediaStreamHandler;
                        TpMediaStreamHandlerClass;

    void                (*tp_cli_media_session_handler_callback_for_error)
                                                            (TpMediaSessionHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_session_handler_call_error
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             tp_cli_media_session_handler_callback_for_error callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_session_handler_run_error
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_session_handler_callback_for_ready)
                                                            (TpMediaSessionHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_session_handler_call_ready
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             tp_cli_media_session_handler_callback_for_ready callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_session_handler_run_ready
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_session_handler_signal_callback_new_stream_handler)
                                                            (TpMediaSessionHandler *proxy,
                                                             const gchar *arg_Stream_Handler,
                                                             guint arg_ID,
                                                             guint arg_Media_Type,
                                                             guint arg_Direction,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_session_handler_connect_to_new_stream_handler
                                                            (TpMediaSessionHandler *proxy,
                                                             tp_cli_media_session_handler_signal_callback_new_stream_handler callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

    void                (*tp_cli_media_stream_handler_callback_for_codec_choice)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_codec_choice
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Codec_ID,
                                                             tp_cli_media_stream_handler_callback_for_codec_choice callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_codec_choice
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Codec_ID,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_error)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_error
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             tp_cli_media_stream_handler_callback_for_error callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_error
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_native_candidates_prepared)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_native_candidates_prepared
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             tp_cli_media_stream_handler_callback_for_native_candidates_prepared callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_native_candidates_prepared
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_new_active_candidate_pair)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_new_active_candidate_pair
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Native_Candidate_ID,
                                                             const gchar *in_Remote_Candidate_ID,
                                                             tp_cli_media_stream_handler_callback_for_new_active_candidate_pair callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_new_active_candidate_pair
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Native_Candidate_ID,
                                                             const gchar *in_Remote_Candidate_ID,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_new_native_candidate)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_new_native_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Candidate_ID,
                                                             const GPtrArray *in_Transports,
                                                             tp_cli_media_stream_handler_callback_for_new_native_candidate callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_new_native_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Candidate_ID,
                                                             const GPtrArray *in_Transports,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_ready)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_ready
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_ready callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_ready
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_set_local_codecs)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_set_local_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_set_local_codecs callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_set_local_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_stream_state)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_stream_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_State,
                                                             tp_cli_media_stream_handler_callback_for_stream_state callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_stream_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_State,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_callback_for_supported_codecs)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_supported_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_supported_codecs callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_supported_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_signal_callback_add_remote_candidate)
                                                            (TpMediaStreamHandler *proxy,
                                                             const gchar *arg_Candidate_ID,
                                                             const GPtrArray *arg_Transports,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_add_remote_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_add_remote_candidate callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_close)
                                                            (TpMediaStreamHandler *proxy,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_close
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_close callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_remove_remote_candidate)
                                                            (TpMediaStreamHandler *proxy,
                                                             const gchar *arg_Candidate_ID,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_remove_remote_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_remove_remote_candidate callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_set_active_candidate_pair)
                                                            (TpMediaStreamHandler *proxy,
                                                             const gchar *arg_Native_Candidate_ID,
                                                             const gchar *arg_Remote_Candidate_ID,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_active_candidate_pair
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_active_candidate_pair callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_set_remote_candidate_list)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GPtrArray *arg_Remote_Candidates,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_remote_candidate_list
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_remote_candidate_list callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_set_remote_codecs)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GPtrArray *arg_Codecs,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_remote_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_remote_codecs callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_set_stream_playing)
                                                            (TpMediaStreamHandler *proxy,
                                                             gboolean arg_Playing,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_stream_playing
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_stream_playing callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_set_stream_sending)
                                                            (TpMediaStreamHandler *proxy,
                                                             gboolean arg_Sending,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_stream_sending
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_stream_sending callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_start_telephony_event)
                                                            (TpMediaStreamHandler *proxy,
                                                             guchar arg_Event,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_start_telephony_event
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_start_telephony_event callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    void                (*tp_cli_media_stream_handler_signal_callback_stop_telephony_event)
                                                            (TpMediaStreamHandler *proxy,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_stop_telephony_event
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_stop_telephony_event callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_hold_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             gboolean in_Held,
                                                             tp_cli_media_stream_handler_callback_for_hold_state callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_unhold_failure
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             tp_cli_media_stream_handler_callback_for_unhold_failure callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    void                (*tp_cli_media_stream_handler_callback_for_hold_state)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    void                (*tp_cli_media_stream_handler_callback_for_unhold_failure)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_stream_held
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_stream_held callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);
    gboolean            tp_cli_media_stream_handler_run_hold_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             gboolean in_Held,
                                                             GError **error,
                                                             GMainLoop **loop);
    gboolean            tp_cli_media_stream_handler_run_unhold_failure
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             GError **error,
                                                             GMainLoop **loop);
    void                (*tp_cli_media_stream_handler_signal_callback_set_stream_held)
                                                            (TpMediaStreamHandler *proxy,
                                                             gboolean arg_Held,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    TpProxyPendingCall * tp_cli_media_stream_handler_call_codecs_updated
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_codecs_updated callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);
    void                (*tp_cli_media_stream_handler_callback_for_codecs_updated)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);
    gboolean            tp_cli_media_stream_handler_run_codecs_updated
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);

## Object Hierarchy

      GObject
       +----TpProxy
             +----TpMediaSessionHandler

      GObject
       +----TpProxy
             +----TpMediaStreamHandler

## Description

This module provides access to the auxiliary objects used to implement TpSvcChannelTypeStreamedMedia.

## Details

### tp_media_session_handler_new ()

    TpMediaSessionHandler * tp_media_session_handler_new    (TpDBusDaemon *dbus,
                                                             const gchar *unique_name,
                                                             const gchar *object_path,
                                                             GError **error);

`dbus` : | a D-Bus daemon; may not be `NULL`
`unique_name` : | the unique name of the connection process; may not be `NULL` or a well-known name
`object_path` : | the object path of the media session handler; may not be `NULL`
`error` : | used to indicate the error if `NULL` is returned
Returns : | a new media session handler proxy, or `NULL` on invalid arguments

Since 0.7.1

### tp_media_session_handler_init_known_interfaces ()

    void                tp_media_session_handler_init_known_interfaces
                                                            (void);

Ensure that the known interfaces for TpMediaSessionHandler have been set up. This is done automatically when necessary, but for correct overriding of library interfaces by local extensions, you should call this function before calling `tp_proxy_or_subclass_hook_on_interface_add()` with first argument `TP_TYPE_MEDIA_SESSION_HANDLER`.

Since 0.7.32

### TpMediaSessionHandler

    typedef struct _TpMediaSessionHandler TpMediaSessionHandler;

A proxy object for a Telepathy connection manager.

Since 0.7.1

### TpMediaSessionHandlerClass

    typedef struct _TpMediaSessionHandlerClass TpMediaSessionHandlerClass;

The class of a TpMediaSessionHandler.

Since 0.7.1

### tp_media_stream_handler_new ()

    TpMediaStreamHandler * tp_media_stream_handler_new      (TpDBusDaemon *dbus,
                                                             const gchar *unique_name,
                                                             const gchar *object_path,
                                                             GError **error);

`dbus` : | a D-Bus daemon; may not be `NULL`
`unique_name` : | the unique name of the connection process; may not be `NULL` or a well-known name
`object_path` : | the object path of the media stream handler; may not be `NULL`
`error` : | used to indicate the error if `NULL` is returned
Returns : | a new media stream handler proxy, or `NULL` on invalid arguments

Since 0.7.1

### tp_media_stream_handler_init_known_interfaces ()

    void                tp_media_stream_handler_init_known_interfaces
                                                            (void);

Ensure that the known interfaces for TpMediaStreamHandler have been set up. This is done automatically when necessary, but for correct overriding of library interfaces by local extensions, you should call this function before calling `tp_proxy_or_subclass_hook_on_interface_add()` with first argument `TP_TYPE_MEDIA_STREAM_HANDLER`.

Since 0.7.32

### TpMediaStreamHandler

    typedef struct _TpMediaStreamHandler TpMediaStreamHandler;

A proxy object for a Telepathy connection manager.

Since 0.7.1

### TpMediaStreamHandlerClass

    typedef struct _TpMediaStreamHandlerClass TpMediaStreamHandlerClass;

The class of a TpMediaStreamHandler.

Since 0.7.1

### tp_cli_media_session_handler_callback_for_error ()

    void                (*tp_cli_media_session_handler_callback_for_error)
                                                            (TpMediaSessionHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

### Warning

`tp_cli_media_session_handler_callback_for_error` is deprecated and should not be used in newly-written code. Use StreamHandler.Error on each StreamHandler object instead.

Signature of the callback called when a Error method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_session_handler_call_error ()

    TpProxyPendingCall * tp_cli_media_session_handler_call_error
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             tp_cli_media_session_handler_callback_for_error callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

### Warning

`tp_cli_media_session_handler_call_error` is deprecated and should not be used in newly-written code. Use StreamHandler.Error on each StreamHandler object instead.

Start a Error method call.

Informs the connection manager that an error occured in this session. If used, the connection manager must terminate the session and all of the streams within it, and may also emit a <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">StreamError</tp:dbus-ref> signal on the channel for each stream within the session.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Error_Code` : | Used to pass an 'in' argument: (Undocumented)
`in_Message` : | Used to pass an 'in' argument: (Undocumented)
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_session_handler_run_error ()

    gboolean            tp_cli_media_session_handler_run_error
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_session_handler_run_error` is deprecated and should not be used in newly-written code. Use StreamHandler.Error on each StreamHandler object instead.

Call the method Error and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Informs the connection manager that an error occured in this session. If used, the connection manager must terminate the session and all of the streams within it, and may also emit a <tp:dbus-ref namespace="org.freedesktop.Telepathy.Channel.Type.StreamedMedia">StreamError</tp:dbus-ref> signal on the channel for each stream within the session.

`proxy` : | A TpMediaSessionHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Error_Code` : | Used to pass an 'in' argument: (Undocumented)
`in_Message` : | Used to pass an 'in' argument: (Undocumented)
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_session_handler_callback_for_ready ()

    void                (*tp_cli_media_session_handler_callback_for_ready)
                                                            (TpMediaSessionHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a Ready method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_session_handler_call_ready ()

    TpProxyPendingCall * tp_cli_media_session_handler_call_ready
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             tp_cli_media_session_handler_callback_for_ready callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a Ready method call.

Inform the connection manager that a client is ready to handle this session handler (i.e. that it has connected to the <tp:member-ref>NewStreamHandler</tp:member-ref> signal and done any other necessary setup).

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_session_handler_run_ready ()

    gboolean            tp_cli_media_session_handler_run_ready
                                                            (TpMediaSessionHandler *proxy,
                                                             gint timeout_ms,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_session_handler_run_ready` is deprecated and should not be used in newly-written code.

Call the method Ready and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform the connection manager that a client is ready to handle this session handler (i.e. that it has connected to the <tp:member-ref>NewStreamHandler</tp:member-ref> signal and done any other necessary setup).

`proxy` : | A TpMediaSessionHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_session_handler_signal_callback_new_stream_handler ()

    void                (*tp_cli_media_session_handler_signal_callback_new_stream_handler)
                                                            (TpMediaSessionHandler *proxy,
                                                             const gchar *arg_Stream_Handler,
                                                             guint arg_ID,
                                                             guint arg_Media_Type,
                                                             guint arg_Direction,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal NewStreamHandler.

`proxy` : | The proxy on which `tp_cli_media_session_handler_connect_to_new_stream_handler()` was called
`arg_Stream_Handler` : | The path of a new object implementing the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Media">StreamHandler</tp:dbus-ref> interface.
`arg_ID` : | The unique ID of the new stream
`arg_Media_Type` : | Type of media that this stream should handle
`arg_Direction` : | Direction of this stream
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_session_handler_connect_to_new_stream_handler ()

    TpProxySignalConnection * tp_cli_media_session_handler_connect_to_new_stream_handler
                                                            (TpMediaSessionHandler *proxy,
                                                             tp_cli_media_session_handler_signal_callback_new_stream_handler callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal NewStreamHandler.

Emitted when a new stream handler has been created for this session.

`proxy` : | A TpMediaSessionHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_callback_for_codec_choice ()

    void                (*tp_cli_media_stream_handler_callback_for_codec_choice)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a CodecChoice method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_codec_choice ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_codec_choice
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Codec_ID,
                                                             tp_cli_media_stream_handler_callback_for_codec_choice callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a CodecChoice method call.

Inform the connection manager of codec used to receive data.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Codec_ID` : | Used to pass an 'in' argument: (Undocumented)
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_codec_choice ()

    gboolean            tp_cli_media_stream_handler_run_codec_choice
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Codec_ID,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_codec_choice` is deprecated and should not be used in newly-written code.

Call the method CodecChoice and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform the connection manager of codec used to receive data.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Codec_ID` : | Used to pass an 'in' argument: (Undocumented)
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_error ()

    void                (*tp_cli_media_stream_handler_callback_for_error)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a Error method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_error ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_error
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             tp_cli_media_stream_handler_callback_for_error callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a Error method call.

Inform the connection manager that an error occured in this stream. The connection manager should emit the StreamError signal for the stream on the relevant channel, and remove the stream from the session.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Error_Code` : | Used to pass an 'in' argument: ID of error, from the MediaStreamError enumeration
`in_Message` : | Used to pass an 'in' argument: String describing the error
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_error ()

    gboolean            tp_cli_media_stream_handler_run_error
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_Error_Code,
                                                             const gchar *in_Message,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_error` is deprecated and should not be used in newly-written code.

Call the method Error and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform the connection manager that an error occured in this stream. The connection manager should emit the StreamError signal for the stream on the relevant channel, and remove the stream from the session.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Error_Code` : | Used to pass an 'in' argument: ID of error, from the MediaStreamError enumeration
`in_Message` : | Used to pass an 'in' argument: String describing the error
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_native_candidates_prepared ()

    void                (*tp_cli_media_stream_handler_callback_for_native_candidates_prepared)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a NativeCandidatesPrepared method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_native_candidates_prepared ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_native_candidates_prepared
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             tp_cli_media_stream_handler_callback_for_native_candidates_prepared callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a NativeCandidatesPrepared method call.

Informs the connection manager that all possible native candisates have been discovered for the moment.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_native_candidates_prepared ()

    gboolean            tp_cli_media_stream_handler_run_native_candidates_prepared
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_native_candidates_prepared` is deprecated and should not be used in newly-written code.

Call the method NativeCandidatesPrepared and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Informs the connection manager that all possible native candisates have been discovered for the moment.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_new_active_candidate_pair ()

    void                (*tp_cli_media_stream_handler_callback_for_new_active_candidate_pair)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a NewActiveCandidatePair method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_new_active_candidate_pair ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_new_active_candidate_pair
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Native_Candidate_ID,
                                                             const gchar *in_Remote_Candidate_ID,
                                                             tp_cli_media_stream_handler_callback_for_new_active_candidate_pair callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a NewActiveCandidatePair method call.

Informs the connection manager that a valid candidate pair has been discovered and streaming is in progress.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Native_Candidate_ID` : | Used to pass an 'in' argument: (Undocumented)
`in_Remote_Candidate_ID` : | Used to pass an 'in' argument: (Undocumented)
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_new_active_candidate_pair ()

    gboolean            tp_cli_media_stream_handler_run_new_active_candidate_pair
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Native_Candidate_ID,
                                                             const gchar *in_Remote_Candidate_ID,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_new_active_candidate_pair` is deprecated and should not be used in newly-written code.

Call the method NewActiveCandidatePair and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Informs the connection manager that a valid candidate pair has been discovered and streaming is in progress.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Native_Candidate_ID` : | Used to pass an 'in' argument: (Undocumented)
`in_Remote_Candidate_ID` : | Used to pass an 'in' argument: (Undocumented)
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_new_native_candidate ()

    void                (*tp_cli_media_stream_handler_callback_for_new_native_candidate)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a NewNativeCandidate method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_new_native_candidate ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_new_native_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Candidate_ID,
                                                             const GPtrArray *in_Transports,
                                                             tp_cli_media_stream_handler_callback_for_new_native_candidate callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a NewNativeCandidate method call.

Inform this MediaStreamHandler that a new native transport candidate has been ascertained.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Candidate_ID` : | Used to pass an 'in' argument: String identifier for this candidate
`in_Transports` : | Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Array of transports for this candidate, with fields: <ul> <li>component number</li> <li>IP address (as a string)</li> <li>port</li> <li>base network protocol (one of the values of MediaStreamBaseProto)</li> <li>proto subtype (e.g. RTP)</li> <li>proto profile (e.g. AVP)</li> <li>our preference value of this transport (double in range 0.0-1.0 inclusive); 1 signals the most preferred transport</li> <li>transport type, one of the values of MediaStreamTransportType</li> <li>username if authentication is required</li> <li>password if authentication is required</li> </ul>
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_new_native_candidate ()

    gboolean            tp_cli_media_stream_handler_run_new_native_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const gchar *in_Candidate_ID,
                                                             const GPtrArray *in_Transports,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_new_native_candidate` is deprecated and should not be used in newly-written code.

Call the method NewNativeCandidate and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform this MediaStreamHandler that a new native transport candidate has been ascertained.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Candidate_ID` : | Used to pass an 'in' argument: String identifier for this candidate
`in_Transports` : | Used to pass an 'in' argument: <tp:docstring xmlns="http://www.w3.org/1999/xhtml"> Array of transports for this candidate, with fields: <ul> <li>component number</li> <li>IP address (as a string)</li> <li>port</li> <li>base network protocol (one of the values of MediaStreamBaseProto)</li> <li>proto subtype (e.g. RTP)</li> <li>proto profile (e.g. AVP)</li> <li>our preference value of this transport (double in range 0.0-1.0 inclusive); 1 signals the most preferred transport</li> <li>transport type, one of the values of MediaStreamTransportType</li> <li>username if authentication is required</li> <li>password if authentication is required</li> </ul>
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_ready ()

    void                (*tp_cli_media_stream_handler_callback_for_ready)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a Ready method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_ready ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_ready
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_ready callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a Ready method call.

Inform the connection manager that a client is ready to handle this StreamHandler. Also provide it with info about all supported codecs.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Codecs` : | Used to pass an 'in' argument: Locally-supported codecs.
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_ready ()

    gboolean            tp_cli_media_stream_handler_run_ready
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_ready` is deprecated and should not be used in newly-written code.

Call the method Ready and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform the connection manager that a client is ready to handle this StreamHandler. Also provide it with info about all supported codecs.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Codecs` : | Used to pass an 'in' argument: Locally-supported codecs.
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_set_local_codecs ()

    void                (*tp_cli_media_stream_handler_callback_for_set_local_codecs)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a SetLocalCodecs method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_set_local_codecs ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_set_local_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_set_local_codecs callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a SetLocalCodecs method call.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used to provide codecs after `Ready()`, so the media client can go ready for an incoming call and exchange candidates/codecs before knowing what local codecs are available.</p> <p>This is useful for gatewaying calls between two connection managers. Given an incoming call, you need to call <tp:member-ref>Ready</tp:member-ref> to get the remote codecs before you can use them as the &quot;local&quot; codecs to place the outgoing call, and hence receive the outgoing call's remote codecs to use as the incoming call's &quot;local&quot; codecs.</p> <p>In this situation, you would pass an empty list of codecs to the incoming call's Ready method, then later call SetLocalCodecs on the incoming call in order to respond to the offer.</p>

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Codecs` : | Used to pass an 'in' argument: Locally-supported codecs
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_set_local_codecs ()

    gboolean            tp_cli_media_stream_handler_run_set_local_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_set_local_codecs` is deprecated and should not be used in newly-written code.

Call the method SetLocalCodecs and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Used to provide codecs after `Ready()`, so the media client can go ready for an incoming call and exchange candidates/codecs before knowing what local codecs are available.</p> <p>This is useful for gatewaying calls between two connection managers. Given an incoming call, you need to call <tp:member-ref>Ready</tp:member-ref> to get the remote codecs before you can use them as the &quot;local&quot; codecs to place the outgoing call, and hence receive the outgoing call's remote codecs to use as the incoming call's &quot;local&quot; codecs.</p> <p>In this situation, you would pass an empty list of codecs to the incoming call's Ready method, then later call SetLocalCodecs on the incoming call in order to respond to the offer.</p>

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Codecs` : | Used to pass an 'in' argument: Locally-supported codecs
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_stream_state ()

    void                (*tp_cli_media_stream_handler_callback_for_stream_state)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a StreamState method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_stream_state ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_stream_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_State,
                                                             tp_cli_media_stream_handler_callback_for_stream_state callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a StreamState method call.

Informs the connection manager of the stream's current state, as as specified in Channel.Type.StreamedMedia::ListStreams.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_State` : | Used to pass an 'in' argument: (Undocumented)
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_stream_state ()

    gboolean            tp_cli_media_stream_handler_run_stream_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             guint in_State,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_stream_state` is deprecated and should not be used in newly-written code.

Call the method StreamState and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Informs the connection manager of the stream's current state, as as specified in Channel.Type.StreamedMedia::ListStreams.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_State` : | Used to pass an 'in' argument: (Undocumented)
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_callback_for_supported_codecs ()

    void                (*tp_cli_media_stream_handler_callback_for_supported_codecs)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a SupportedCodecs method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_call_supported_codecs ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_supported_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_supported_codecs callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a SupportedCodecs method call.

Inform the connection manager of the supported codecs for this session. This is called after the connection manager has emitted SetRemoteCodecs to notify what codecs are supported by the peer, and will thus be an intersection of all locally supported codecs (passed to Ready) and those supported by the peer.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Codecs` : | Used to pass an 'in' argument: Locally supported codecs.
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_run_supported_codecs ()

    gboolean            tp_cli_media_stream_handler_run_supported_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_supported_codecs` is deprecated and should not be used in newly-written code.

Call the method SupportedCodecs and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform the connection manager of the supported codecs for this session. This is called after the connection manager has emitted SetRemoteCodecs to notify what codecs are supported by the peer, and will thus be an intersection of all locally supported codecs (passed to Ready) and those supported by the peer.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Codecs` : | Used to pass an 'in' argument: Locally supported codecs.
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_signal_callback_add_remote_candidate ()

    void                (*tp_cli_media_stream_handler_signal_callback_add_remote_candidate)
                                                            (TpMediaStreamHandler *proxy,
                                                             const gchar *arg_Candidate_ID,
                                                             const GPtrArray *arg_Transports,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal AddRemoteCandidate.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_add_remote_candidate()` was called
`arg_Candidate_ID` : | String identifier for this candidate
`arg_Transports` : | Array of transports for this candidate with fields, as defined in NewNativeCandidate
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_add_remote_candidate ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_add_remote_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_add_remote_candidate callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal AddRemoteCandidate.

Signal emitted when the connection manager wishes to inform the client of a new remote candidate.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_close ()

    void                (*tp_cli_media_stream_handler_signal_callback_close)
                                                            (TpMediaStreamHandler *proxy,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal Close.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_close()` was called
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_close ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_close
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_close callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal Close.

Signal emitted when the connection manager wishes the stream to be closed.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_remove_remote_candidate ()

    void                (*tp_cli_media_stream_handler_signal_callback_remove_remote_candidate)
                                                            (TpMediaStreamHandler *proxy,
                                                             const gchar *arg_Candidate_ID,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal RemoveRemoteCandidate.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_remove_remote_candidate()` was called
`arg_Candidate_ID` : | String identifier for remote candidate to drop
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_remove_remote_candidate ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_remove_remote_candidate
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_remove_remote_candidate callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal RemoveRemoteCandidate.

Signal emitted when the connection manager wishes to inform the client that the remote end has removed a previously usable candidate. <tp:rationale> It seemed like a good idea at the time, but wasn't. </tp:rationale>

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_set_active_candidate_pair ()

    void                (*tp_cli_media_stream_handler_signal_callback_set_active_candidate_pair)
                                                            (TpMediaStreamHandler *proxy,
                                                             const gchar *arg_Native_Candidate_ID,
                                                             const gchar *arg_Remote_Candidate_ID,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal SetActiveCandidatePair.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_set_active_candidate_pair()` was called
`arg_Native_Candidate_ID` : | (Undocumented)
`arg_Remote_Candidate_ID` : | (Undocumented)
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_set_active_candidate_pair ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_active_candidate_pair
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_active_candidate_pair callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal SetActiveCandidatePair.

Emitted by the connection manager to inform the client that a valid candidate pair has been discovered by the remote end and streaming is in progress.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_set_remote_candidate_list ()

    void                (*tp_cli_media_stream_handler_signal_callback_set_remote_candidate_list)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GPtrArray *arg_Remote_Candidates,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal SetRemoteCandidateList.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_set_remote_candidate_list()` was called
`arg_Remote_Candidates` : | A list of candidate id and a list of transports as defined in NewNativeCandidate
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_set_remote_candidate_list ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_remote_candidate_list
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_remote_candidate_list callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal SetRemoteCandidateList.

Signal emitted when the connection manager wishes to inform the client of all the available remote candidates at once.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_set_remote_codecs ()

    void                (*tp_cli_media_stream_handler_signal_callback_set_remote_codecs)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GPtrArray *arg_Codecs,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal SetRemoteCodecs.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_set_remote_codecs()` was called
`arg_Codecs` : | Codecs supported by the remote peer.
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_set_remote_codecs ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_remote_codecs
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_remote_codecs callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal SetRemoteCodecs.

Signal emitted when the connection manager wishes to inform the client of the codecs supported by the remote end. If these codecs are compatible with the remote codecs, then the client must call <tp:member-ref>SupportedCodecs</tp:member-ref>, otherwise call <tp:member-ref>Error</tp:member-ref>.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_set_stream_playing ()

    void                (*tp_cli_media_stream_handler_signal_callback_set_stream_playing)
                                                            (TpMediaStreamHandler *proxy,
                                                             gboolean arg_Playing,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal SetStreamPlaying.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_set_stream_playing()` was called
`arg_Playing` : | (Undocumented)
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_set_stream_playing ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_stream_playing
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_stream_playing callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal SetStreamPlaying.

If emitted with argument TRUE, this means that the connection manager wishes to set the stream playing; this means that the streaming implementation should expect to receive data. If emitted with argument FALSE this signal is basically meaningless and should be ignored. <tp:rationale> We're very sorry. </tp:rationale>

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_set_stream_sending ()

    void                (*tp_cli_media_stream_handler_signal_callback_set_stream_sending)
                                                            (TpMediaStreamHandler *proxy,
                                                             gboolean arg_Sending,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal SetStreamSending.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_set_stream_sending()` was called
`arg_Sending` : | (Undocumented)
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_set_stream_sending ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_stream_sending
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_stream_sending callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal SetStreamSending.

Signal emitted when the connection manager wishes to set whether or not the stream sends to the remote end.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_start_telephony_event ()

    void                (*tp_cli_media_stream_handler_signal_callback_start_telephony_event)
                                                            (TpMediaStreamHandler *proxy,
                                                             guchar arg_Event,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal StartTelephonyEvent.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_start_telephony_event()` was called
`arg_Event` : | A telephony event code as defined by RFC 4733.
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_start_telephony_event ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_start_telephony_event
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_start_telephony_event callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal StartTelephonyEvent.

Request that a telephony event (as defined by RFC 4733) is transmitted over this stream until StopTelephonyEvent is called.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_signal_callback_stop_telephony_event ()

    void                (*tp_cli_media_stream_handler_signal_callback_stop_telephony_event)
                                                            (TpMediaStreamHandler *proxy,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal StopTelephonyEvent.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_stop_telephony_event()` was called
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_connect_to_stop_telephony_event ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_stop_telephony_event
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_stop_telephony_event callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal StopTelephonyEvent.

Request that any ongoing telephony events (as defined by RFC 4733) being transmitted over this stream are stopped.

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_call_hold_state ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_hold_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             gboolean in_Held,
                                                             tp_cli_media_stream_handler_callback_for_hold_state callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a HoldState method call.

Notify the connection manager that the stream's hold state has been changed successfully in response to SetStreamHeld.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Held` : | Used to pass an 'in' argument: If true, the stream is now on hold.
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_call_unhold_failure ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_unhold_failure
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             tp_cli_media_stream_handler_callback_for_unhold_failure callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a UnholdFailure method call.

Notify the connection manager that an attempt to reacquire the necessary hardware or software resources to unhold the stream, in response to SetStreamHeld, has failed.

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_callback_for_hold_state ()

    void                (*tp_cli_media_stream_handler_callback_for_hold_state)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a HoldState method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_callback_for_unhold_failure ()

    void                (*tp_cli_media_stream_handler_callback_for_unhold_failure)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a UnholdFailure method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_connect_to_set_stream_held ()

    TpProxySignalConnection * tp_cli_media_stream_handler_connect_to_set_stream_held
                                                            (TpMediaStreamHandler *proxy,
                                                             tp_cli_media_stream_handler_signal_callback_set_stream_held callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object,
                                                             GError **error);

Connect a handler to the signal SetStreamHeld.

<tp:docstring xmlns="http://www.w3.org/1999/xhtml"> <p>Emitted when the connection manager wishes to place the stream on hold (so the streaming client should free hardware or software resources) or take the stream off hold (so the streaming client should reacquire the necessary resources).</p> <p>When placing a channel's streams on hold, the connection manager SHOULD notify the remote contact that this will be done (if appropriate in the protocol) before it emits this signal.</p> <tp:rationale> <p>It is assumed that relinquishing a resource will not fail. If it does, the call is probably doomed anyway.</p> </tp:rationale> <p>When unholding a channel's streams, the connection manager SHOULD emit this signal and wait for success to be indicated via HoldState before it notifies the remote contact that the channel has been taken off hold.</p> <tp:rationale> <p>This means that if a resource is unavailable, the remote contact will never even be told that we tried to acquire it.</p> </tp:rationale>

`proxy` : | A TpMediaStreamHandler or subclass
`callback` : | Callback to be called when the signal is received
`user_data` : | User-supplied data for the callback
`destroy` : | Destructor for the user-supplied data, which will be called when this signal is disconnected, or before this function returns `NULL`
`weak_object` : | A GObject which will be weakly referenced; if it is destroyed, this callback will automatically be disconnected
`error` : | If not `NULL`, used to raise an error if `NULL` is returned
Returns : | a TpProxySignalConnection containing all of the above, which can be used to disconnect the signal; or `NULL` if the proxy does not have the desired interface or has become invalid.

### tp_cli_media_stream_handler_run_hold_state ()

    gboolean            tp_cli_media_stream_handler_run_hold_state
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             gboolean in_Held,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_hold_state` is deprecated and should not be used in newly-written code.

Call the method HoldState and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Notify the connection manager that the stream's hold state has been changed successfully in response to SetStreamHeld.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Held` : | Used to pass an 'in' argument: If true, the stream is now on hold.
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_run_unhold_failure ()

    gboolean            tp_cli_media_stream_handler_run_unhold_failure
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_unhold_failure` is deprecated and should not be used in newly-written code.

Call the method UnholdFailure and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Notify the connection manager that an attempt to reacquire the necessary hardware or software resources to unhold the stream, in response to SetStreamHeld, has failed.

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

### tp_cli_media_stream_handler_signal_callback_set_stream_held ()

    void                (*tp_cli_media_stream_handler_signal_callback_set_stream_held)
                                                            (TpMediaStreamHandler *proxy,
                                                             gboolean arg_Held,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Represents the signature of a callback for the signal SetStreamHeld.

`proxy` : | The proxy on which `tp_cli_media_stream_handler_connect_to_set_stream_held()` was called
`arg_Held` : | If true, the stream is to be placed on hold.
`user_data` : | User-supplied data
`weak_object` : | User-supplied weakly referenced object

### tp_cli_media_stream_handler_call_codecs_updated ()

    TpProxyPendingCall * tp_cli_media_stream_handler_call_codecs_updated
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             tp_cli_media_stream_handler_callback_for_codecs_updated callback,
                                                             gpointer user_data,
                                                             GDestroyNotify destroy,
                                                             GObject *weak_object);

Start a CodecsUpdated method call.

Inform the connection manager that the parameters of the supported codecs for this session have changed. The connection manager should send the new parameters to the remote contact. <tp:rationale> This is required for H.264 and Theora, for example. </tp:rationale>

`proxy` : | the TpProxy
`timeout_ms` : | the timeout in milliseconds, or -1 to use the default
`in_Codecs` : | Used to pass an 'in' argument: Locally supported codecs, which SHOULD be the same as were previously in effect, but possibly with different parameters.
`callback` : | called when the method call succeeds or fails; may be `NULL` to make a "fire and forget" call with no reply tracking
`user_data` : | user-supplied data passed to the callback; must be `NULL` if `callback` is `NULL`
`destroy` : | called with the user_data as argument, after the call has succeeded, failed or been cancelled; must be `NULL` if `callback` is `NULL`
`weak_object` : | If not `NULL`, a GObject which will be weakly referenced; if it is destroyed, this call will automatically be cancelled. Must be `NULL` if `callback` is `NULL`
Returns : | a TpProxyPendingCall representing the call in progress. It is borrowed from the object, and will become invalid when the callback is called, the call is cancelled or the TpProxy becomes invalid.

### tp_cli_media_stream_handler_callback_for_codecs_updated ()

    void                (*tp_cli_media_stream_handler_callback_for_codecs_updated)
                                                            (TpMediaStreamHandler *proxy,
                                                             const GError *error,
                                                             gpointer user_data,
                                                             GObject *weak_object);

Signature of the callback called when a CodecsUpdated method call succeeds or fails.

`proxy` : | the proxy on which the call was made
`error` : | `NULL` on success, or an error on failure
`user_data` : | user-supplied data
`weak_object` : | user-supplied object

### tp_cli_media_stream_handler_run_codecs_updated ()

    gboolean            tp_cli_media_stream_handler_run_codecs_updated
                                                            (TpMediaStreamHandler *proxy,
                                                             gint timeout_ms,
                                                             const GPtrArray *in_Codecs,
                                                             GError **error,
                                                             GMainLoop **loop);

### Warning

`tp_cli_media_stream_handler_run_codecs_updated` is deprecated and should not be used in newly-written code.

Call the method CodecsUpdated and run the main loop until it returns. Before calling this method, you must add a reference to any borrowed objects you need to keep, and generally ensure that everything is in a consistent state.

Inform the connection manager that the parameters of the supported codecs for this session have changed. The connection manager should send the new parameters to the remote contact. <tp:rationale> This is required for H.264 and Theora, for example. </tp:rationale>

`proxy` : | A TpMediaStreamHandler or subclass
`timeout_ms` : | Timeout in milliseconds, or -1 for default
`in_Codecs` : | Used to pass an 'in' argument: Locally supported codecs, which SHOULD be the same as were previously in effect, but possibly with different parameters.
`error` : | If not `NULL`, used to return errors if `FALSE` is returned
`loop` : | If not `NULL`, set before re-entering the main loop, to point to a GMainLoop which can be used to cancel this call with `g_main_loop_quit()`, causing a return of `FALSE` with `error` set to `TP_DBUS_ERROR_CANCELLED`
Returns : | TRUE on success, FALSE and sets `error` on error

## See Also

TpChannel, TpProxy