I released Empathy 0.23.1, the first release of the unstable 0.23.x branch proposed for inclusion in GNOME desktop 2.24. This release comes with tons of changes.
- Drop libtelepathy and use telepathy-glib instead.
- Beginning of support for MSN-like chats that becomes chatroom when a contact is invited.
- Added user manual support, it’s being written by Milo Casagrande.
- And the most important…… empathy now make easy to use TUBES !!!
What does “Tubes” means?
A tube is a way for applications to communicate. Traditionnally when I want to play a game with a friend I ask him the IP and the PORT on which he is hosting the server and I connect to it… And in most cases that fails because we are both behind a NAT. Tubes is a way for a server to offer a socket to an IM contact, the remote contact accepts the socket and they can begin to write/read data on it. I works even if there is a NAT in both sides.
You can see screencast of ther sender and the receiver of a tube (other screencasts here). The code of that little game can be found on a darcs repository.
Empathy make easy for developpers to make that, what you have to do:
- When the user want to initiate a game (or share a doc in abiword, etc…) the application uses empathy’s contact list widget from libempathy-gtk to let the user select a contact
- The application creates unix, ipv4 or ipv6 socket on localhost and call (from libempathy) empathy_tp_tube_new_stream_tube (selected_contact, TP_SOCKET_ADDRESS_TYPE_IPV4, “127.0.0.1”, PORT, “MyGreatGame”);
- That’s all for the initiator side, the remote contact will see his empathy status icon blink.
- On the receiver side the application must register the DBus service “org.gnome.Empathy.StreamTubeHandler.MyGreatGame” by installing a .service file. When started the application must create a EmpathyTubeHandler object: empathy_tube_handler_new (TP_TUBE_TYPE_STREAM, “MyGreatGame”); and connect to the “new-tube” signal on that object.
- Each time someone offers a tube that “new-tube” signal is emitted and give a EmpathyTpTube object.
- When you get that tube object you can call empathy_tp_tube_accept_stream_tube (tube, TP_SOCKET_ADDRESS_TYPE_IPV4) and get the socket using empathy_tp_tube_get_socket (tube, &hostname, &port).
- Open that socket and both sides can communicate over it.
Now is time for Abiword, Inkscape, gnome-games, and all other network application to stop reimplementing an IM system! Please use libempathy and libempathy-gtk to make your live easier.
Important notes:
– MissionControl 4.65 now stores passwords in gnome-keyring, if you upgrade it don’t forget to retype the password of all accounts you configured with the old MissionControl to make sure the password get removed from gconf and added to gnome-keyring.
– Empathy 0.23.1 do not use MissionControl’s system to dispatch channels, that means that you have to make sure that you don’t keep .chandler and .service files from previous installations. If you are using packaged version of empathy it shouldn’t be a problem for you.