Talker Ruby Client

A real-time Talker Ruby client.

Usage

1) Get a Talker account at https://talkerapp.com/signup

2) Get your Talker Token on https://myaccount.talkerapp.com/settings

3) Find the Room ID you want to connect to. This is the last part of the URL:

 https://myaccount.talkerapp.com/rooms/<room_id>

4) Serve hot and enjoy

Talker.connect(:room => ROOM_ID, :token => YOUR_TALKER_TOKEN) do |client|
  client.on_connected do
    client.send_message "hello!"
  end

  client.on_message do |user, message|
    puts user["name"] + ": " + message
  end

  trap("INT") { client.close }
end

Callbacks

All arguments are optional.

on_connected

Called when the user is authenticated and ready to receive events.

on_presence(users)

Called after on_connected with the list of connected users. With users being something like this:

[{"id"=>1, "name"=>"macournoyer", "email"=>"[email protected]"},
 {"id"=>2, "name"=>"gary", "email"=>"[email protected]"}]

on_message(user, message, event)

Called when a new message is received. user is the sender. event contains the full event sent by the server.

on_join(user)

Called when a user joins the room.

on_idle(user)

Called when a user becomes idle (closed connection without leaving).

on_back(user)

Called when a user is back from idle.

on_leave(user)

Called when a user leaves.

on_close

Called when the connection is closed.

on_error(error_message)

Called an error is received from the Talker server.

Methods

Methods of an instance of Talker class.

users

Array of users currently in the room. In the form:

[{"id"=>1, "name"=>"macournoyer", "email"=>"[email protected]"},
 {"id"=>2, "name"=>"gary", "email"=>"[email protected]"}]

leave

Leave the room and close the connection.

close

Close the connection without leaving the room.

send_message(message)

Send a message.

send_private_message(user_name, message)

Send a private message to user_name.

Running the specs

Howdy brave lil' one! To run the specs you'll need courage, hard work and some luck:

1) Install from source my "special" fork of em-spec at http://github.com/macournoyer/em-spec.

2) Edit the file spec/talker.example.yml with your info and rename it to spec/talker.yml.

3) Run rake and everything should be green, birds should start signing and someone will make you a chocolate cake

(results may vary).

Credits & License

Released under the Ruby License, (c) Talker

Thanks to http://github.com/raggi for kicking this off.