Telepathy Recipes
Simple overviews of how to accomplish various tasks with the Telepathy API.
Register an account
- Protocols which have accounts that can be registered automatically have a boolean "register" parameter.
Call RequestConnection with register=True.
If Connect() succeeds, registration has succeeded.
- Don't rely on the connection being usable after registretion is finished.
Send a text message
- TODO
Make an audio call
RequestHandle
RequestChannel
(no longer necessary since spec 0.17.6: AddMember)
RequestStreams
handle MembersChanged
handle StreamError
See also: Streamed Media
Block a contact
- TODO
Look for installed connection managers
Call ListNames() and ListActivatableNames() on the D-Bus daemon
Search in the results for names beginning with org.freedesktop.Telepathy.ConnectionManager.
- The rest of the bus name is the connection manager name
tp_list_connection_managers() in telepathy-glib >= 0.7.1 implements this correctly
Reuse an existing connection
Search for names on the bus beginning with org.freedesktop.Telepathy.Connection.
tp_list_connection_names() in telepathy-glib >= 0.7.1 implements this correctly
If you want presence information, you can call GetPresence on the subscribe contact list to get cached presence information