初探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的格式，個人覺得在使用上是頗為方便。

相關網頁：

• Skype4Py首頁
• Skype4Py Sourceforge.Net下載首頁
• 安裝說明
• Skype4Py使用說明 (Document)
  
• Skype4Py Example
  

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了。

相關連結：

• Skype Launcher
  
• Skype API – SET CALL DTMF
  
• 範例程式下載連結

[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檔連結：

• 深入淺出MFC 2/e - part1
• 深入淺出MFC 2/e - part2
• 深入淺出MFC 2/e - part3
• 深入淺出MFC 2/e - part4
• 深入淺出MFC 2/e - part5

做中學 - 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指令，都可以在官網找到說明與簡易教學，在這邊列出給大家參考一下：

• Skype API Command列表
• 指令 - Search Friends
• 指令 - Minimize
• 指令 - Open Dialpad
• 指令 - Call

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

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