Click here to Skip to main content
Click here to Skip to main content

Controlling Skype with C#

, 29 Oct 2013 CPOL
Rate this:
Please Sign up or sign in to vote.
C# example code for controlling Skype
Sample Image - skypecontrolapicsharp.gif

Read this first - Discontinuation of Skype API

Microsoft plans to switch off the Skype desktop API in December 2013. The explanation is that:

"The Desktop API was created in 2004 and it doesn’t support mobile application development. We have, therefore, decided to retire the Desktop API in December 2013."

However, many developers are using Skype API in their products enhancing Skype functionality. And many Skype users rely on these products in their businesses and everyday life.

There is a petition initiative which requests Skype to reconsider this decision.

Introduction

I have put together an example code in C# for controlling the Skype VoIP application. The Skype Control API documentation is freely available. So why not give it a try with C#?

The downloadable ZIP package contains a Visual Studio 2005 solution with two projects - the Skype Control class library and the Test Application.

Background

The Control API for Windows uses window messages for communication between Skype and client applications. This involves usage of Windows API functions. Working with window messages is not directly supported by the .NET Framework classes. Fortunately there is a mechanism in .NET called platform invoke, which enables calls to unmanaged code in DLLs.

I will not explain the Control API in detail here, however I will provide enough information for everyone to start experimenting with the code and playing with Skype through the Test application.

Communication Initiation

Skype uses window messages to communicate with client applications. Registered window messages are used to initiate communication. The SkypeControlAPIDiscover message is used to find the Skype window handle by broadcasting it to all windows. A client application window handle must be specified when sending this message. Skype, if running, will respond with SkypeControlAPIAttach message sent directly to our client window.

internal class Constants
{
    public const string SkypeControlAPIDiscover = "SkypeControlAPIDiscover";
    public const string SkypeControlAPIAttach = "SkypeControlAPIAttach";
}

The LPARAM of the SkypeControlAPIAttach message contains the attach code. This can be Success in case of a successful connection. When the client application tries to connect for the first time, Skype pops up an authorization dialog and notifies the client by sending SkypeControlAPIAttach message with the PendingAuthorisation code. Depending on the user action, Skype will next send a Success or Refused notification.

public enum SkypeAttachStatus : uint
{
    Success = 0,
    PendingAuthorizaion = 1,
    Refused = 2,
    NotAvailable = 3,
    Available = 0x8001
}

When the Skype application is starting, it broadcasts SkypeControlAPIAttach message with the Available code.

Be aware that Skype assumes that our client application will process messages with result of 1 within one second, otherwise the connection times out and the communication is closed. This is important to know while debugging the client. Fortunately Skype can be set to a special "development mode" (by modifying the registry, see Skype API documentation).

Sending Commands

The WM_COPYDATA window message is used for sending Skype commands and receiving command replies and notifications.

Handling the WM_COPYDATA messages in C# is a little bit tricky. The CopyDataStruct needs to be correctly marshaled to and from the native code. The straightforward solution is to simply pass the CopyDataStruct this way:

[DllImport("user32.dll")]
public static extern IntPtr SendMessageTimeout(IntPtr windowHandle,
    uint Msg,
    IntPtr wParam,
    ref CopyDataStruct lParam,
    SendMessageTimeoutFlags flags,
    uint timeout,
    out IntPtr result
);

Note that when filling CopyDataStruct, the Length member also counts the terminating '0' character.

Code for getting the CopyDataStruct form is also straightforward, the Message class has a handy GetLParam method for this.

Platform.CopyDataStruct aCDS = 
    (Platform.CopyDataStruct)m.GetLParam(typeof(Platform.CopyDataStruct));

string aResponse = aCDS.Data;

The SkypeControl Library

All the code for handling window message level communication can be found in the SkypeClient class (SkypeControl library). Platform specific stuff is in the Platform.cs. All of the above is internal to the Skype control library.

The SkypeProxy class is designed to be used for controlling Skype by a client application. Currently, it is only wrapping calls to the SkypeClient class and contains only methods for low level Skype API communication. It is meant to be expanded with methods that encapsulate Skype API at a higher level, e.g. GetUserStatus, Ping.

To control the Skype, just create an instance of the SkypeProxy class. Communication is initiated by a call to Connect. A successful connection is indicated by firing of the SkypeAttach event with AttachStatus set to Success.

Commands are sent to Skype by calling Command with appropriately formatted text command. Results and notifications from Skype are received through the SkypeResponse event.

For more information on Skype Control API and command syntax, please refer to the Skype documentation which is freely available at Skype developer zones.

Enjoy!

History

  • 15th February, 2006: Initial post.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Gabriel Szabo
Software Developer (Senior)
Slovakia Slovakia
No Biography provided

Comments and Discussions

 
QuestionHelp!!! PinmemberMember 105840735-Aug-14 7:48 
Questionhow can I integrate kype as part of my application. Pinmemberthuandung26-Jun-14 18:34 
QuestionHow to record skype conversation PinmemberTridip Bhattacharjee24-Apr-14 1:58 
SuggestionSkype call divert huwaei 3g modem Pinmembersahufankariapper5-Apr-14 13:17 
Questionsend message Pinmembervladko4141-Mar-14 3:43 
QuestionWin 8 Metro Style Skype app Pinmembermatthias_7923-Dec-13 5:42 
QuestionDesktop API retirement - a lie PinmemberCristian Amarie23-Nov-13 22:08 
NewsFYI : Skype has announced the termination of API Pinmemberpipiscrew31-Oct-13 15:22 
Questionperfectoooo Pinmember Gun Gun Febrianza29-Oct-13 7:23 
Questionupdates Pinmemberkiquenet.com11-Aug-13 21:50 
GeneralMy vote of 5 PinmemberEd Nutting4-Sep-12 5:44 
QuestionThis is fantastic Pinmemberkevroy31426-Mar-12 12:03 
GeneralMy vote of 5 PinmemberMember 31518218-Jun-11 4:24 
Generalhow to get APP2APP command responses PinmemberAkeeq6-May-11 6:06 
GeneralRe: how to get APP2APP command responses PinmemberAkeeq13-May-11 20:40 
GeneralRe: how to get APP2APP command responses PinmemberJason Newland28-Nov-13 12:54 
GeneralThank You! PinmemberZviadi892-May-11 23:56 
GeneralMy vote of 5 PinmemberMastak.ua16-Nov-10 0:09 
GeneralThank for this example PinmemberGexrjd14-Mar-10 1:03 
General[Message Deleted] Pinmemberit.ragester28-Mar-09 6:35 
GeneralSkype login PinmemberKhangBKIT9-Oct-08 11:06 
GeneralNot UTF 8 PinmemberTor-Helge Persett29-Jul-08 22:26 
Generalwow, super examplik diky moc PinmemberMember 301469616-Jun-08 23:35 
GeneralConnect Refused [modified] PinmemberRajan Hans22-Apr-08 18:06 
GeneralRe: Connect Refused PinmemberGabriel Szabo23-Apr-08 4:54 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.141220.1 | Last Updated 29 Oct 2013
Article Copyright 2006 by Gabriel Szabo
Everything else Copyright © CodeProject, 1999-2014
Layout: fixed | fluid