AnyEvent::XMPP::IM::Account - Instant messaging account
Contents
Copyright & License
Copyright 2007, 2008 Robin Redeker, all rights reserved.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl
itself.
perl v5.38.2 2024-08-03 AnyEvent::XMPP::IM::Account(3pm)
Description
This module represents a class for IM accounts. It is used by AnyEvent::XMPP::Client.
You can get an instance of this class only by calling the "get_account" method on a
AnyEvent::XMPP::Client object.
Events
For these events callbacks can be registered (with the Object::Event interface):
tracked_message_destination => $bare_jid, $full_jid
This event is emitted whenever the message tracking mechanism changes (or sets) it's destination
resource for the $bare_jid to $full_jid.
removed
Whenever the account is removed from the AnyEvent::XMPP::Client (eg. when disconnected) this event is
emitted before it is destroyed.
Methods
connection()
Returns the AnyEvent::XMPP::IM::Connection object if this account already has one (undef otherwise).
is_connected()
Returns true if this accunt is connected.
jid()
Returns either the full JID if the account is connected or returns the bare jid if not.
bare_jid()
Returns always the bare JID of this account after stringprep has been applied, so you can compare the
JIDs returned from this function.
nickname()
Your nickname for this account.
nickname_for_jid($jid)
This method transforms the $jid to a nickname. It looks the $jid up in the roster and looks for a
nickname. If no nickname could be found in the roster it returns the node part for the $jid.
send_tracked_message($msg)
This method sends the AnyEvent::XMPP::IM::Message object in $msg. The "to" attribute of the message
is adjusted by the conversation tracking mechanism.
Name
AnyEvent::XMPP::IM::Account - Instant messaging account
Synopsis
my $cl = AnyEvent::XMPP::IM::Client->new;
...
my $acc = $cl->get_account ($jid);
