tp_media_session_handler_new ()

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

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

tp_media_stream_handler_new ()

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

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

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);

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

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);

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.

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);

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.

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.

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).

tp_cli_media_session_handler_run_ready ()

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

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).

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.

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.

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.

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.

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);

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.

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.

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.

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);

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.

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.

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.

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);

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.

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.

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.

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);

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.

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.

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.

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);

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.

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.

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.

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);

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.

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.

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>

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);

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>

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.

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.

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);

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.

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.

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.

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);

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.

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.

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.

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.

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.

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.

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>

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.

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.

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.

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.

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.

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>.

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.

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>

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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>

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);

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.

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);

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.

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.

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>

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.

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);

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>

tp_cli_media_stream_handler_signal_callback_start_named_telephony_event ()

void
(*tp_cli_media_stream_handler_signal_callback_start_named_telephony_event)
                               (TpMediaStreamHandler *proxy,
                                guchar arg_Event,
                                guint arg_Codec_ID,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal StartNamedTelephonyEvent.

tp_cli_media_stream_handler_connect_to_start_named_telephony_event ()

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

Connect a handler to the signal StartNamedTelephonyEvent.

Request that a telephony event (as defined by RFC 4733) is transmitted over this stream until StopTelephonyEvent is called. This differs from StartTelephonyEvent in that you force the event to be transmitted as a RFC 4733 named event, not as sound. You can also force a specific Codec ID.

tp_cli_media_stream_handler_signal_callback_start_sound_telephony_event ()

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

Represents the signature of a callback for the signal StartSoundTelephonyEvent.

tp_cli_media_stream_handler_connect_to_start_sound_telephony_event ()

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

Connect a handler to the signal StartSoundTelephonyEvent.

Request that a telephony event (as defined by RFC 4733) is transmitted over this stream until StopTelephonyEvent is called. This differs from StartTelephonyEvent in that you force the event to be transmitted as sound instead of as a named event.

tp_cli_media_stream_handler_call_new_active_transport_pair ()

TpProxyPendingCall *
tp_cli_media_stream_handler_call_new_active_transport_pair
                               (TpMediaStreamHandler *proxy,
                                gint timeout_ms,
                                const gchar *in_Native_Candidate_ID,
                                const GValueArray *in_Native_Transport,
                                const gchar *in_Remote_Candidate_ID,
                                const GValueArray *in_Remote_Transport,
                                tp_cli_media_stream_handler_callback_for_new_active_transport_pair callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a NewActiveTransportPair method call.

<p>Informs the connection manager that a valid transport pair has been discovered and streaming is in progress. Component id MUST be the same for both transports and the pair is only valid for that component.</p> <tp:rationale> <p>The connection manager might need to send the details of the active transport pair (e.g. c and o parameters of SDP body need to contain address of selected native RTP transport as stipulated by RFC 5245). However, the candidate ID might not be enough to determine these info if the transport was found after <tp:member-ref>NativeCandidatesPrepared</tp:member-ref> has been called (e.g. peer reflexive ICE candidate). </p> </tp:rationale> <p>This method must be called before <tp:member-ref>NewActiveCandidatePair</tp:member-ref>.</p> <tp:rationale> <p>This way, connection managers supporting this method can safely ignore subsequent <tp:member-ref>NewActiveCandidatePair</tp:member-ref> call.</p> </tp:rationale> <p>Connection managers SHOULD NOT implement this method unless they need to inform the peer about selected transports. As a result, streaming implementations MUST NOT treat errors raised by this method as fatal.</p> <tp:rationale> <p>Usually, connection managers only need to do one answer/offer round-trip. However, some protocols give the possibility to to send an updated offer (e.g. ICE defines such mechanism to avoid some race conditions and to properly set the state of gateway devices).</p> </tp:rationale>

tp_cli_media_stream_handler_callback_for_new_active_transport_pair ()

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

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

tp_cli_media_stream_handler_run_new_active_transport_pair ()

gboolean
tp_cli_media_stream_handler_run_new_active_transport_pair
                               (TpMediaStreamHandler *proxy,
                                gint timeout_ms,
                                const gchar *in_Native_Candidate_ID,
                                const GValueArray *in_Native_Transport,
                                const gchar *in_Remote_Candidate_ID,
                                const GValueArray *in_Remote_Transport,
                                GError **error,
                                GMainLoop **loop);

Call the method NewActiveTransportPair 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.

<p>Informs the connection manager that a valid transport pair has been discovered and streaming is in progress. Component id MUST be the same for both transports and the pair is only valid for that component.</p> <tp:rationale> <p>The connection manager might need to send the details of the active transport pair (e.g. c and o parameters of SDP body need to contain address of selected native RTP transport as stipulated by RFC 5245). However, the candidate ID might not be enough to determine these info if the transport was found after <tp:member-ref>NativeCandidatesPrepared</tp:member-ref> has been called (e.g. peer reflexive ICE candidate). </p> </tp:rationale> <p>This method must be called before <tp:member-ref>NewActiveCandidatePair</tp:member-ref>.</p> <tp:rationale> <p>This way, connection managers supporting this method can safely ignore subsequent <tp:member-ref>NewActiveCandidatePair</tp:member-ref> call.</p> </tp:rationale> <p>Connection managers SHOULD NOT implement this method unless they need to inform the peer about selected transports. As a result, streaming implementations MUST NOT treat errors raised by this method as fatal.</p> <tp:rationale> <p>Usually, connection managers only need to do one answer/offer round-trip. However, some protocols give the possibility to to send an updated offer (e.g. ICE defines such mechanism to avoid some race conditions and to properly set the state of gateway devices).</p> </tp:rationale>

tp_cli_media_stream_handler_call_supported_feedback_messages ()

TpProxyPendingCall *
tp_cli_media_stream_handler_call_supported_feedback_messages
                               (TpMediaStreamHandler *proxy,
                                gint timeout_ms,
                                GHashTable *in_Messages,
                                tp_cli_media_stream_handler_callback_for_supported_feedback_messages callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a SupportedFeedbackMessages method call.

Inform the connection manager of the supported feedback messages for this session. This is called a before calling <tp:member-ref>SupportedCodecs</tp:member-ref>, <tp:member-ref>Ready</tp:member-ref> or <tp:member-ref>CodecsUpdated</tp:member-ref> to indicate the local, or negotiated feedback messages.

tp_cli_media_stream_handler_call_supported_header_extensions ()

TpProxyPendingCall *
tp_cli_media_stream_handler_call_supported_header_extensions
                               (TpMediaStreamHandler *proxy,
                                gint timeout_ms,
                                const GPtrArray *in_Header_Extensions,
                                tp_cli_media_stream_handler_callback_for_supported_header_extensions callback,
                                gpointer user_data,
                                GDestroyNotify destroy,
                                GObject *weak_object);

Start a SupportedHeaderExtensions method call.

Inform the connection manager of the supported RTP header extensions for this session. This is called before calling <tp:member-ref>SupportedCodecs</tp:member-ref>, <tp:member-ref>Ready</tp:member-ref> or <tp:member-ref>CodecsUpdated</tp:member-ref> to indicate the local or negotiated RTP header extensions.

tp_cli_media_stream_handler_callback_for_supported_feedback_messages ()

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

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

tp_cli_media_stream_handler_callback_for_supported_header_extensions ()

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

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

tp_cli_media_stream_handler_connect_to_set_remote_feedback_messages ()

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

Connect a handler to the signal SetRemoteFeedbackMessages.

Signal emitted when the connection manager wishes to inform the client of the feedback messages supported by the remote end. This signal is emitted before <tp:member-ref>SetRemoteCodecs</tp:member-ref>. If the client supports any of these messages, it must call <tp:member-ref>SupportedFeedbackMessages</tp:member-ref> before calling <tp:member-ref>SupportedCodecs</tp:member-ref>.

tp_cli_media_stream_handler_connect_to_set_remote_header_extensions ()

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

Connect a handler to the signal SetRemoteHeaderExtensions.

Signal emitted when the connection manager wishes to inform the client of the RTP header extensions supported by the remote end. This signal is emitted before <tp:member-ref>SetRemoteCodecs</tp:member-ref>. If the client supports any of these messages, it must call <tp:member-ref>SupportedHeaderExtensions</tp:member-ref> before calling <tp:member-ref>SupportedCodecs</tp:member-ref>.

tp_cli_media_stream_handler_run_supported_feedback_messages ()

gboolean
tp_cli_media_stream_handler_run_supported_feedback_messages
                               (TpMediaStreamHandler *proxy,
                                gint timeout_ms,
                                GHashTable *in_Messages,
                                GError **error,
                                GMainLoop **loop);

Call the method SupportedFeedbackMessages 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 feedback messages for this session. This is called a before calling <tp:member-ref>SupportedCodecs</tp:member-ref>, <tp:member-ref>Ready</tp:member-ref> or <tp:member-ref>CodecsUpdated</tp:member-ref> to indicate the local, or negotiated feedback messages.

tp_cli_media_stream_handler_run_supported_header_extensions ()

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

Call the method SupportedHeaderExtensions 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 RTP header extensions for this session. This is called before calling <tp:member-ref>SupportedCodecs</tp:member-ref>, <tp:member-ref>Ready</tp:member-ref> or <tp:member-ref>CodecsUpdated</tp:member-ref> to indicate the local or negotiated RTP header extensions.

tp_cli_media_stream_handler_signal_callback_set_remote_feedback_messages ()

void
(*tp_cli_media_stream_handler_signal_callback_set_remote_feedback_messages)
                               (TpMediaStreamHandler *proxy,
                                GHashTable *arg_Messages,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal SetRemoteFeedbackMessages.

tp_cli_media_stream_handler_signal_callback_set_remote_header_extensions ()

void
(*tp_cli_media_stream_handler_signal_callback_set_remote_header_extensions)
                               (TpMediaStreamHandler *proxy,
                                const GPtrArray *arg_Header_Extensions,
                                gpointer user_data,
                                GObject *weak_object);

Represents the signature of a callback for the signal SetRemoteHeaderExtensions.

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

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