原文:你也可以玩转Skype
-- 基于Skype API开发外壳程序入门
Skype是目前这个星球上最厉害的IM+VOIP软件,Skype现在已经改变了全球2.8亿人的生活方式。你,值得拥有! :)
Skype中文官网:http://skype.tom.com/
Skype全球官网:http://www.skype.com/
Skype也是世界上最开放,最具创新意识的IM工具,他提供了Skype API, Skype4COM,
Skype4Java几种形式的开发接口给Skype爱好者编写Skype的交互程序或者Skype的插件。你可以使用任何你熟悉的语言,比如C/C++,VB,
C#,Delphi,Java甚至PHP,VBScript。通过你的专业知识,去影响2.8亿的Skype用户。你也可以做到!:)
Skype全球开发者社区:http://developer.skype.com/
下面我们将展示一个最简单的访问Skype API的C++代码:
这里可以下载对应的VC6工程:http://wh.hust.colin.googlepages.com/SkypeInteractiveDemo.rar
//
// Copyright (c) 2004-2006, Skype Limited.
// All rights
reserved.
//
// Redistribution and use in source and binary forms, with
or without
// modification, are permitted provided that the following
conditions
// are met:
//
// * Redistributions of source
code must retain the above copyright
// notice, this
list of conditions and the following disclaimer.
// *
Redistributions in binary form must reproduce the
above
// copyright notice, this list of conditions
and the following
// disclaimer in the documentation
and/or other materials provided
// with the
distribution.
// * Neither the name of the Skype Limited nor the
names of its
// contributors may be used to endorse
or promote products derived
// from this software
without specific prior written permission.
//
// THIS SOFTWARE IS
PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS
// FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE
// COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT,
// INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING,
// BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES;
// LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER
// CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT
// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN
// ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE
// POSSIBILITY OF SUCH DAMAGE.
//
// tab size: 2
#include <windows.h>
#include <conio.h>
#include
<stdio.h>
#include <string.h>
#include
<process.h>
#include <rpcdce.h>
HWND hInit_MainWindowHandle; ///<本程序创建的窗口的句柄
HINSTANCE
hInit_ProcessHandle; ///<本程序的进程句柄
char
acInit_WindowClassName[128]; ///<本程序创建的窗口类名
HANDLE
hGlobal_ThreadShutdownEvent;
bool volatile
fGlobal_ThreadRunning=true;
//Skype定义的消息ID,Skype通过向第三方程序发送这类消息来告知请求连接的结果
UINT
uiGlobal_MsgID_SkypeControlAPIAttach;
//Skype定义的消息ID,当第三方程序想获取Skype的交互时,
//必须通过广播(HWND_BROADCAST)发送这个消息,Skype收到后给用户弹出提示
//当用户允许后,交互关系就建立起来了。
UINT
uiGlobal_MsgID_SkypeControlAPIDiscover;
//Skype的窗口句柄
HWND hGlobal_SkypeAPIWindowHandle=NULL;
//BOOL变量标识是否打印更详细的消息内容
#if defined(_DEBUG)
bool volatile
fGlobal_DumpWindowsMessages=true;
#else
bool volatile
fGlobal_DumpWindowsMessages=false;
#endif
DWORD
ulGlobal_PromptConsoleMode=0;
HANDLE volatile
hGlobal_PromptConsoleHandle=NULL;
enum
{
//第三方程序连接成功,在wParam中可以获取到Skype的API窗口句柄
SKYPECONTROLAPI_ATTACH_SUCCESS=0,
//Skype已经收到连接请求了,并给用户弹出了第三方程序请求访问Skype的提示
//这时候连接并没有成功建立,必须等到SKYPECONTROLAPI_ATTACH_SUCCESS消息才行
SKYPECONTROLAPI_ATTACH_PENDING_AUTHORIZATION=1,
//Skype用户拒绝了第三方程序的访问请求
SKYPECONTROLAPI_ATTACH_REFUSED=2,
//API接口当前不可使用。这种情况有时候发生,比如当前Skype没有任何用户登录进去。
//第三方程序必须等到Skype广播了SKYPECONTROLAPI_ATTACH_API_AVAILABLE消息时再去尝试连接才有效
SKYPECONTROLAPI_ATTACH_NOT_AVAILABLE=3,
SKYPECONTROLAPI_ATTACH_API_AVAILABLE=0x8001
};
//从标准输入窗口中获取一行输入到pacPromptBuffer中
bool Global_Console_ReadRow( char
*pacPromptBuffer, unsigned int uiMaxLength)
{
HANDLE hConsoleHandle,
hDuplicatedConsoleHandle;
DWORD ulCharactersRead,
ulConsoleMode;
unsigned int uiNewLength;
BOOL
fReadConsoleResult;
bool fReturnStatus;
char
cCharacter;
fReturnStatus=false;
//获取标准输入窗口的输入缓冲区句柄
while((hConsoleHandle=GetStdHandle(STD_INPUT_HANDLE))!=INVALID_HANDLE_VALUE)
{
if(
DuplicateHandle( GetCurrentProcess(),
hConsoleHandle,
GetCurrentProcess(),
&hDuplicatedConsoleHandle, 0,
FALSE,
DUPLICATE_SAME_ACCESS)==FALSE
)
break;
GetConsoleMode(
hDuplicatedConsoleHandle, &ulConsoleMode);
SetConsoleMode(
hDuplicatedConsoleHandle,
ENABLE_LINE_INPUT|ENABLE_PROCESSED_INPUT|ENABLE_ECHO_INPUT);
hGlobal_PromptConsoleHandle=hDuplicatedConsoleHandle;
ulGlobal_PromptConsoleMode=ulConsoleMode;
fReadConsoleResult=ReadConsole(
hGlobal_PromptConsoleHandle,
(LPVOID)pacPromptBuffer,
uiMaxLength, &ulCharactersRead, (LPVOID)0);
if(
hGlobal_PromptConsoleHandle==(HANDLE)0
)
break;
hGlobal_PromptConsoleHandle=(HANDLE)0;
SetConsoleMode(
hDuplicatedConsoleHandle,
ulConsoleMode);
CloseHandle(hDuplicatedConsoleHandle);
if(
fReadConsoleResult==FALSE || ulCharactersRead>uiMaxLength
)
break;
pacPromptBuffer[ulCharactersRead]=0;
uiNewLength=ulCharactersRead;
while(uiNewLength!=0)
{
cCharacter=pacPromptBuffer[uiNewLength-1];
if(
cCharacter!=‘/r‘ && cCharacter!=‘/n‘
)
break;
uiNewLength--;
}
pacPromptBuffer[uiNewLength]=0;
fReturnStatus=true;
break;
}
if(
fReturnStatus==false
)
pacPromptBuffer[0]=0;
return(fReturnStatus);
}
//输入控制台的回收清理
void Global_Console_CancelReadRow(void)
{
if(
hGlobal_PromptConsoleHandle!=(HANDLE)0
)
{
SetConsoleMode( hGlobal_PromptConsoleHandle,
ulGlobal_PromptConsoleMode);
CloseHandle(hGlobal_PromptConsoleHandle);
hGlobal_PromptConsoleHandle=(HANDLE)0;
}
}
static LRESULT APIENTRY SkypeAPITest_Windows_WindowProc(
HWND
hWindow, UINT uiMessage, WPARAM uiParam, LPARAM ulParam)
{
LRESULT
lReturnCode;
bool
fIssueDefProc;
lReturnCode=0;
fIssueDefProc=false;
switch(uiMessage)
{
case
WM_DESTROY:
hInit_MainWindowHandle=NULL;
PostQuitMessage(0);
break;
case
WM_COPYDATA:
//Skype与第三方程序的消息传送使用WM_COPYDATA
//当Skype通过WM_COPYDATA向所有已连接的第三方程序发送消息时,会把Skype的窗口句柄放到uiParam中
if(
hGlobal_SkypeAPIWindowHandle==(HWND)uiParam
)
{
PCOPYDATASTRUCT
poCopyData=(PCOPYDATASTRUCT)ulParam;
printf( "Message from
Skype(%u): %.*s/n", poCopyData->dwData, poCopyData->cbData,
poCopyData->lpData);
lReturnCode=1;
}
break;
default:
//如果消息类型是uiGlobal_MsgID_SkypeControlAPIAttach,则表示连接相关的
if(
uiMessage==uiGlobal_MsgID_SkypeControlAPIAttach
)
{
switch(ulParam)
{
case
SKYPECONTROLAPI_ATTACH_SUCCESS:
printf("!!!
Connected; to terminate issue
#disconnect/n");
hGlobal_SkypeAPIWindowHandle=(HWND)uiParam;
break;
case
SKYPECONTROLAPI_ATTACH_PENDING_AUTHORIZATION:
printf("!!!
Pending
authorization/n");
break;
case
SKYPECONTROLAPI_ATTACH_REFUSED:
printf("!!!
Connection
refused/n");
break;
case
SKYPECONTROLAPI_ATTACH_NOT_AVAILABLE:
printf("!!!
Skype API not
available/n");
break;
case
SKYPECONTROLAPI_ATTACH_API_AVAILABLE:
printf("!!! Try
connect now (API available); issue
#connect/n");
break;
}
lReturnCode=1;
break;
}
fIssueDefProc=true;
break;
}
if(
fIssueDefProc )
lReturnCode=DefWindowProc( hWindow, uiMessage,
uiParam, ulParam);
if( fGlobal_DumpWindowsMessages
)
{
printf( "WindowProc: hWindow=0x%08X,
MainWindow=0x%08X, Message=%5u, WParam=0x%08X, LParam=0x%08X;
Return=%ld%s/n",
hWindow, hInit_MainWindowHandle,
uiMessage, uiParam, ulParam, lReturnCode, fIssueDefProc? "
(default)":"");
}
return(lReturnCode);
}
bool Initialize_CreateWindowClass(void)
{
unsigned char
*paucUUIDString;
RPC_STATUS lUUIDResult;
bool
fReturnStatus;
UUID
oUUID;
fReturnStatus=false;
lUUIDResult=UuidCreate(&oUUID);
hInit_ProcessHandle=(HINSTANCE)OpenProcess(
PROCESS_DUP_HANDLE, FALSE, GetCurrentProcessId());
if(
hInit_ProcessHandle!=NULL && (lUUIDResult==RPC_S_OK ||
lUUIDResult==RPC_S_UUID_LOCAL_ONLY) )
{
if(
UuidToString( &oUUID, &paucUUIDString)==RPC_S_OK
)
{
WNDCLASS
oWindowClass;
//生成窗口类名(含UUID)
strcpy(
acInit_WindowClassName, "Skype-API-Test-");
strcat(
acInit_WindowClassName, (char
*)paucUUIDString);
oWindowClass.style=CS_HREDRAW|CS_VREDRAW|CS_DBLCLKS;
//指定窗口的消息回调函数是SkypeAPITest_Windows_WindowProc
oWindowClass.lpfnWndProc=(WNDPROC)&SkypeAPITest_Windows_WindowProc;
oWindowClass.cbClsExtra=0;
oWindowClass.cbWndExtra=0;
oWindowClass.hInstance=hInit_ProcessHandle;
oWindowClass.hIcon=NULL;
oWindowClass.hCursor=NULL;
oWindowClass.hbrBackground=NULL;
oWindowClass.lpszMenuName=NULL;
oWindowClass.lpszClassName=acInit_WindowClassName;
//注册窗口类
if(
RegisterClass(&oWindowClass)!=0
)
fReturnStatus=true;
RpcStringFree(&paucUUIDString);
}
}
if(
fReturnStatus==false
)
CloseHandle(hInit_ProcessHandle),hInit_ProcessHandle=NULL;
return(fReturnStatus);
}
void
DeInitialize_DestroyWindowClass(void)
{
//注销窗口类
UnregisterClass(
acInit_WindowClassName,
hInit_ProcessHandle);
CloseHandle(hInit_ProcessHandle),hInit_ProcessHandle=NULL;
}
bool
Initialize_CreateMainWindow(void)
{
//创建窗口,并把句柄保存到hInit_MainWindowHandle
hInit_MainWindowHandle=CreateWindowEx(
WS_EX_APPWINDOW|WS_EX_WINDOWEDGE,
acInit_WindowClassName, "",
WS_BORDER|WS_SYSMENU|WS_MINIMIZEBOX,
CW_USEDEFAULT,
CW_USEDEFAULT, 128, 128, NULL, 0, hInit_ProcessHandle,
0);
return(hInit_MainWindowHandle!=NULL? true:false);
}
void DeInitialize_DestroyMainWindow(void)
{
//销毁窗口
if(
hInit_MainWindowHandle!=NULL
)
DestroyWindow(hInit_MainWindowHandle),hInit_MainWindowHandle=NULL;
}
void Global_MessageLoop(void)
{
//消息处理循环
MSG
oMessage;
while(GetMessage( &oMessage, 0, 0,
0)!=FALSE)
{
TranslateMessage(&oMessage);
DispatchMessage(&oMessage);
}
}
//这是一个线程函数,主要用于接收用户的输入指令并执行
void __cdecl Global_InputProcessingThread(void
*)
{
static char acInputRow[1024];
bool
fProcessed;
//线程开始执行时默认去连接Skype,发送请求访问Skype
API的消息。由于一开始我们不知道SKype的API窗口句柄值,只能
//通过HWND_BROADCAST广播这个消息给所有系统中在前台的窗口,如果Skype窗口存在,则自然也会收到。
if(
SendMessage( HWND_BROADCAST, uiGlobal_MsgID_SkypeControlAPIDiscover,
(WPARAM)hInit_MainWindowHandle, 0)!=0
)
{
//接受用户输入指令
while(Global_Console_ReadRow(
acInputRow,
sizeof(acInputRow)-1))
{
//退出程序
if(
stricmp( acInputRow, "#quit")==0 ||
stricmp(
acInputRow, "#exit")==0
)
break;
fProcessed=false;
//开启显示消息详细信息
if(
stricmp( acInputRow, "#dbgon")==0
)
{
printf(
"SkypeControlAPIAttach=%u, SkypeControlAPIDiscover=%u,
hInit_MainWindowHandle=0x%08lX/n",
uiGlobal_MsgID_SkypeControlAPIAttach,
uiGlobal_MsgID_SkypeControlAPIDiscover,
hInit_MainWindowHandle);
fGlobal_DumpWindowsMessages=true,fProcessed=true;
}
//关闭显示消息详细信息
if(
stricmp( acInputRow, "#dbgoff")==0
)
fGlobal_DumpWindowsMessages=false,fProcessed=true;
//请求访问Skype
API
if( stricmp( acInputRow, "#connect")==0
)
{
SendMessage( HWND_BROADCAST,
uiGlobal_MsgID_SkypeControlAPIDiscover, (WPARAM)hInit_MainWindowHandle,
0);
fProcessed=true;
}
//停止访问Skype
API。由代码可以看出,这是一个假断开,
//因为只是设置hGlobal_SkypeAPIWindowHandle为空,从而不再处理和打印这个窗口发送的WM_COPYDATA消息
if(
stricmp( acInputRow, "#disconnect")==0
)
{
hGlobal_SkypeAPIWindowHandle=NULL;
printf("!!!
Disconnected/n");
fProcessed=true;
}
//其它用户输入内容,则直接作为Skype
API命令发送给Skype处理
if( fProcessed==false &&
hGlobal_SkypeAPIWindowHandle!=NULL
)
{
COPYDATASTRUCT
oCopyData;
// send
command to
skype
oCopyData.dwData=0;
oCopyData.lpData=acInputRow;
oCopyData.cbData=strlen(acInputRow)+1;
if(
oCopyData.cbData!=1
)
{
if( SendMessage(
hGlobal_SkypeAPIWindowHandle, WM_COPYDATA, (WPARAM)hInit_MainWindowHandle,
(LPARAM)&oCopyData)==FALSE
)
{
hGlobal_SkypeAPIWindowHandle=NULL;
printf("!!!
Disconnected/n");
}
}
}
}
}
PostMessage(
hInit_MainWindowHandle, WM_CLOSE, 0,
0);
SetEvent(hGlobal_ThreadShutdownEvent);
fGlobal_ThreadRunning=false;
}
void
main(void)
{
//获取到Skype注册到系统的两类消息ID
uiGlobal_MsgID_SkypeControlAPIAttach=RegisterWindowMessage("SkypeControlAPIAttach");
uiGlobal_MsgID_SkypeControlAPIDiscover=RegisterWindowMessage("SkypeControlAPIDiscover");
if(
uiGlobal_MsgID_SkypeControlAPIAttach!=0 &&
uiGlobal_MsgID_SkypeControlAPIDiscover!=0
)
{
//注册窗口类并创建窗口
if(
Initialize_CreateWindowClass() )
{
if(
Initialize_CreateMainWindow()
)
{
hGlobal_ThreadShutdownEvent=CreateEvent(
NULL, TRUE, FALSE, NULL);
if(
hGlobal_ThreadShutdownEvent!=NULL
)
{
//单独启动一个进程接收用户输入指令并处理
if(
_beginthread( &Global_InputProcessingThread, 64*1024, NULL)!=(unsigned
long)-1
)
{
//main主线程在此循环处理窗口消息
Global_MessageLoop();
//垃圾回收和清理工作
Global_Console_CancelReadRow();
WaitForSingleObject(
hGlobal_ThreadShutdownEvent,
INFINITE);
}
CloseHandle(hGlobal_ThreadShutdownEvent);
}
DeInitialize_DestroyMainWindow();
}
DeInitialize_DestroyWindowClass();
}
}
}