31 1月 2009

初探Skype4Py

  在Skype API裡,除了之前介紹的Windows Message、Skype4Com的方法之外,還有一個Skype4Py可以使用。

  Skype4Py是用Python的語法,將Skype API包裝起來,提供一層high-level的介面供使用者使用,用法跟Skype4Com很類似,而且它還有一個特點,就是跨平台!寫出一個Skype4Py的Python程式,可以在Wiindows、Linux和Mac等不同的OS上執行。而這也是Python的特點之一。

  在我看過Skype4Py的source code後,原來它只是將不同平台上的Skype API底層的做法包裝起來,所以實際上它執行的方法,在Windows上,還是透過Windows Message傳遞的。有興趣的人可以參考看看。

安裝方法:
  1. 安裝Python 2.4以上的版本
  2. 安裝Skype
  3. 安裝Skype4Py

  就是這麼簡單,在安裝Skype4Py上,也提供了多種選則,在Windows上可以安裝exe執行檔,或是下載source code自行下指令安裝。

  在安裝完成後,就可以寫個小小的簡單測試程式:
import Skype4Py

# Create Skype instance
skype = Skype4Py.Skype()

# Connect Skype object to Skype client
skype.Attach()

print 'Your full name:', skype.CurrentUser.FullName
print 'Your contacts:'
for user in skype.Friends:
print ' ', user.FullName
  寫法相當的簡潔,這樣子就可以取得好友清單了。Skype4Py的另一項特點,就是它的線上Document格式長得很像JavaDoc的格式,個人覺得在使用上是頗為方便。

相關網頁:

29 1月 2009

Skype API - DTMF介紹

  在一般的電話對談中,如果我們不小心按到了電話上的按鍵(0~9, #, *),此時會響起一個嗶嗶聲,這個聲響就是以DTMF的方式編碼傳送,每個按鍵都有各自獨有的頻率,所以照理來說,只要對方可以解析傳來的DTMF頻率,即可知道傳來的按鍵為何,可以讓對方做進一步的處理…(如,撥打分機號碼)

  而在Skype的AP中,也有著類似的介面供使用者在通話中,按下畫面上虛擬的按鍵,即會發出DTMF Tone了。而 Skype API 也有提供解析DTMF code的方法,很是方便。

  Skype API 提供了一個Command供使用者送出/接收DTMF code,「SET CALL DTMF」,在Skype4Com裡,也提供了一個Event,當收到DTMF code時,就會觸發「CallDtmfReceived」Event,不過在使用上還是有些限制…
  1. 使用者只能接收到對方送來的DTMF code。當自己送出DTMF code時,並不會觸發CallDtmfReceived Event。
  2. 在Skype4Com的Document中提到,「This event can be received with P2P calls」,所以似乎只限定在P2P的通話上( Skype AP<->Skype AP ),不支援手機<->Skype AP

範例程式:
範例程式下載連結

#include <vcl.h>
#include <iostream>
#pragma hdrstop

#include "Unit1.h"
//---------------------------------------------------------------------------
#pragma package(smart_init)
#pragma link "SKYPE4COMLib_OCX"
#pragma resource "*.dfm"
TForm1 *Form1;
using namespace std;

// 這個程式是用來測試Skype4Com的一些功能
// (1) 要執行這個程式 首先要將$(BCB)/Imports/加入 Include Path
// #include "SKYPE4COMLib_OCX.h"
// (2) 需要新增以下的元件:
// TListBox *ListBox1;
// TMemo *Memo1;
// (3) 需要額外宣告變數:
// TSkype * mSkype;

//---------------------------------------------------------------------------
__fastcall TForm1::TForm1(TComponent* Owner)
: TForm(Owner)
{
mSkype = new TSkype(Owner);
mSkype->Attach(5,false);

// test if Skype is running, if not, start it;
if( !mSkype->Client->IsRunning )
mSkype->Client->Start(false,false);
// 1st parameter - start Skype in minimized state
// 2nd parameter - show splash screen

// Get the count of Friends
int count = mSkype->Friends->get_Count();

// Add Friend list to Memo
for( int i=1 ; i<count ; i++ )// start index from 1 !!!
this->ListBox1->Items->Add( mSkype->Friends->get_Item(i)->get_Handle() );

// bind the Skype Event.
mSkype->OnCallDtmfReceived = OnCallDtmfReceived;
}

// Skype4Com的Event
// 在Skype4Com.chm中定義的 Class : _SkypeEvents 裡面
// HRESULT CallDtmfReceived ([in] ICall *pCall,[in] BSTR Code)
// This event is caused by a call DTMF event.
// 經由BCB處理過後的header檔,定義在 $(BCB)/Imports/SKYPE4COMLib_OCX.h 100行
//
// @target : when receive the DTMF code, print on Memo.
void __fastcall TForm1::OnCallDtmfReceived( TObject *Sender, ICall* pCall/*[in]*/, BSTR code/*[in]*/)
{
this->Memo1->Lines->Add( "OnCallDtmfReceived" );
if( pCall!=NULL ){
this->Memo1->Lines->Add( AnsiString("DTMF Code : ")+WideString(code) );
}
}

補充:
在coding時的測試要透過兩個不同的Skype AP,一般的情況下都得在兩台安裝Skype AP的電腦上測試,建議可以用官網提供的Skype Launcher這個小程式,就能在一台電腦上執行多個Skype AP了。

相關連結:

17 1月 2009

[Python] 實作出 class中的 virtual function

  在Python的世界裡,Class並沒有pure virtual function的概念,所以也沒有所謂的virtual class,但是實際上Python提供了一套機制去模擬virtual function的概念,雖然不像C++嚴謹到無法使用virtual class去宣告出一個實體物件,但是至少在使用此function時,可以丟出一個Error Message出來。

  Python提供的方法就是,你可以在pure virtual function裡,丟一個Error message NotImplementedError出來,夠簡單了吧… 其實自己隨便丟一個也可以達到相同的目的=_=,只是Python提供了個error type,讓我們用起來更有感覺。不過,沒魚蝦也好啦~

以下是範例程式碼…

class virtualClass:
def __init__(self):
pass
def virtualMethod(self): #virtual function.
raise NotImplementedError( "virtualMethod is virutal! Must be overwrited." )

class subClass( virtualClass ):
def __init__(self):
virtualClass.__init__(self)
pass
def virtualMethod(self): #overwrite the virtual function.
print 'subClass! have overwirted the virtualMethod() success.'

v = virtualClass()
v.virtualMethod()

s = subClass()
s.virtualMethod()

侯捷大師 - 深入淺出MFC 2/e 電子書下載

最近想看看MFC的書,也不知道什麼書寫得比較好,就搜尋一下別人推薦的,結果就找到這個免費的電子書,而且是全書的章節都有,侯捷大師真是佛心來著的(大心)。真的是太屌了,我只能這麼說,一個作者可以完全開放電子書供人下載,胸襟之大,可以見得。

有興趣的人也可以下載來看看,是繁體中文版的喔~

直接下載PDF檔連結:

04 1月 2009

做中學 - Skype API Tracer

第一次接觸Skype API的人,看完上一篇介紹Skype API架構的文章後,可能還是霧煞煞的,不太清楚在講什麼東東,沒關係,在這邊我們可以藉由一個Skype官網提供的 Tool - Skype API Tracer 的幫忙,來更加了解Skype API到底在搞什麼 、怎麼搞的!?

首先,必須先到 Skype Download 頁面下載 Skype API Tracer 這個 Tool。

接著,開啟你電腦上的Skype,並啟動 Skype API Tracer,操作介面如下:

操作介面非常的簡潔明瞭,這個Tool就是透過Skype API去操控原本的Skype主程式,比如,在指令輸入欄位輸入「PING」後,就會回傳「PONG」。

也可以輸入指令,取得目前登入Skype帳號的好友清單,輸入「SEARCH FRIENDS」,接著就會回傳「USERS echo123, xxx1, xxx2, xxx3, ....」回傳好友清單中,每個好友的帳號的串列,並以分號「,」為間隔。

當然除了取得帳號相關的資訊外,也可以針對Skype的視窗處理的API,如「MINIMIZE 」,輸入後,Skype主程式的視窗就會自動最小化。輸入「OPEN DIALPAD」後會出現Skype的撥號介面。

當然也可以透過指令,讓Skype撥電話給某位使用者,比如我想打電話給我的朋友SummerDog,就輸入「Call SummerDog」即可,Skype會自動幫你處理接下來撥號的動作。

所以,說穿了,Skype API也不過是個文字遊戲,我們丟給它一些文字指令,它可以選擇吃不吃這些指令,不吃就吐個錯誤訊息給你,吃的下去,就幫你處理一些事情,或是回傳一些有用的訊息給你。
而這些文字訊息都必須透過Windows Message去傳遞,而且必須注意的是,文字訊息的內容,必須用UTF-8的編碼格式才行,不然文字訊息一有中文的內容,而Programmer又不將中文encoding成UTF-8的編碼(在程式裡,預設編碼應該是Big5),Skype會完全看不懂這訊息,就不會理你了。

以上介紹的這些API指令,都可以在官網找到說明與簡易教學,在這邊列出給大家參考一下:

可以用的API指令還滿多的,有興趣的人,可以先使用Skype API Tracer先與Skype溝通一下後,再試著寫入程式裡面,會更有效率~

以上介紹的API指令,都是屬於Windows Message傳遞去控制Skype,其實還有另一個方法,可以用Function的概念去處理Skype API的架構 - Skype4Com,有興趣的人可以參考一下拙作