/ 
Net-DBus-Skype-0.02
River stage zero No dependents
/ Net::DBus::Skype

NAME

Net::DBus::Skype - Perl access to Skype's DBus API

DESCRIPTION

This module supplies a perl API into Skype via DBus. It was inspired by the discussion at http://forum.skype.com/lofiversion/index.php/t92761.html, and adapted from Philipp Kolmann's code base. Nothing much of Philipps code remains other than his choice of error messagses.

If what your doing isn't specific to Skype, use the non proprietary "callto" protocol in your code! Example, href="callto:8325555555"

SYNOPSIS

use Net::DBus::Skype;

my $s = Net::DBus::Skype->new;
my $s = Net::DBus::Skype->new({ debug => 1 });

$s->action('skype:echo123?call');
# -or-
$s->action('skype:echo123');
# -or-
$s->action('skype://echo123');
# -or-
$s->raw_skype('CALL echo123');

SCRIPTS

This module also installs two scripts, skype-action-handler, and skype-simple-dialer. The first script, skype-action-handler, takes Skype action uris on the command line and simply creates an instance and feeds them to ->action. The second script, skype-simple-dialer, takes a phone number, and simply feeds it to the ->raw_skype CALL. The skype-action-handler script should be fully compatable with the C program by the same name that once was distributed with Skype.

METHODS

->action

Takes a skype pseudo-uri, or pseudo-url, ex. skype://echo123?call. This is parsed into three components: protocol, user, and command. Valid options for protocol are "skype", "callto", and "tel". It is then translated into raw_skype and sent off through the DBus communication link. The default command is call.

->raw_skype

Issuess raw_skype commands exposed through the DBus API. An example of this command would be, "CALL echo123".

AUTHOR

Evan Carroll, <me at evancarroll.com>

BUGS

Please report any bugs or feature requests to bug-net-dbus-skype at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-DBus-Skype. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc Net::DBus::Skype

You can also look for information at:

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2008 Evan Carroll, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.