© Skype Technologies S.A
SKYPE API
Skype API 的說明與使用
編撰者：Taavet Hinrikus
版本： 1.2 2005-03-04
© Skype Technologies S.A
2
保密條 款：本文件為
Skype Technologies
S.A.
公司所有，全部內容嚴格保密。本檔僅在保密基礎上提供給被選中並符合條件的潛在
合作夥伴、客戶或供應商，任何其他人一概不得使用。亦不得以任何形式加以複製、保存
、傳播或備份。如收件人接受本檔，即表示他或她同意，在終止與
Skype Technologies
S.A.
合作時，須將此檔退還本公司。
他或她進一步同意，未經許可不得備份、傳真、複製或傳播所收到的、與本公司合作之業
務有關的任何文件。
本檔不構成銷售要約或招攬收購的要約。
© Skype Technologies S.A
3
1 本 文檔編撰目 的
介紹 Skype API 並說明建置透過API與Skype溝通的應用程式和裝置。
2 版 本修訂紀錄
2.1API
修訂版： 1.0.0.94
日期： 2004-10-21
發行說明：API公開釋出
修訂版： 1.1.0.61
日期： 2005-01-12
發行說明：
• 增加內容：協議 3
• 更新內容：API –現僅允許每個用戶同時進行一項搜尋。在收到前一項搜尋
結果之前發出新的搜尋指令將導致錯誤72。
• 更新內容：API現僅允許每個用戶同時進行一項搜尋。
• 更新內容：CHAT和CHATMESSAGE屬性
• 錯誤修正：API 以前會顯示前一位使用者的通話和留言
• 錯誤修正：修正了使用協定 3 時出現的語法混亂
• 錯誤修正：SEARCH MESSAGES 不再回傳 CHATMESSAGES值，
如果使用協議 2 的話
• 錯誤修正：API以前僅顯示訊息的第一個字或全名
• 錯誤修正：訪問控制列表（ACL）只記住一項程式的許可
• 錯誤修正：MC資訊識別碼無法回傳
• 錯誤修正：與原有應用程式的連結問題
• 錯誤修正：修正了在兩個 Windows 帳戶下同時使用 Skype
時出現的應用程式異常
• 錯誤修正：Win98/Me 中顯示有許多動態連結程式庫（dll）檔而不是各自的
應用程式在使用 Skype
• 錯誤修正：API有時不回傳'BUDDYSTATUS 1' 訊息
修訂版： 1.2.0.11
日期： 2005-03-04
發行說明：
• 增加內容：協議 4
• 支持電話會議：召開電話會議、增加會議人數並能夠獲得參加會議者的
名單和有關通知
• 可查看SkypeOut餘額
• 可撥打快速撥號單內的號碼
• 聲頻裝置變更通知
• 刪除即時訊息（IM）記錄的通知
© Skype Technologies S.A
4
• 將語言與國家選項修改為按國際標準國家代碼（ISO）名單而非以國家
名稱回傳（新做法：從協定 4 開始，語言與國家回傳值之前將加上 ISO 代碼
('GET USER echo123 COUNTRY' => 'USER echo123 COUNTRY ee
Estonia'))
• 關閉 Skype 的通知
• 支持 SkypeIn
•為了排除錯誤而將程式暫停一秒鐘的登錄機碼
• 可增加用戶句柄至 OPEN ADDAFRIEND
• CALL FAILUREREASON 1 – 文件檔記錄錯誤，文件檔改用 "Misc error"
（其他類錯誤）顯示
• 更新內容：如找不到 CHATMESSAGE 屬性，'SET CHATMESSAGE id'
指令將發出同一錯誤訊息，而不論資訊識別碼是否存在
• 更新內容：PSTN_STATUS 發出從閘道回傳的錯誤字串
• 更新內容：HASCALLEQUIPMENT 回傳值永遠顯示 TRUE
• 錯誤修正：#11648API："AUDIO IN" 和"AUDIO OUT" 指令不能正確讀取
雙位元組驅動程式命名
• 錯誤修正：#11473API：BTN_PRESSED E 指令失效，出現錯誤號碼 71
無效機碼
• 錯誤修正：#11472API：靜音功能被啟動
• 錯誤修正：#11473API：初始設定參加電話會議人數超過 4 人
• 錯誤修正：#11368API：IMHISTORYCHANGED 指令無效
• 錯誤修正：#11272API：MUTE 指令無效
• 錯誤修正：#11473API：無法使用快速撥號撥給 SkypeOut 聯絡人
• 錯誤修正：#11473API：空白CALL 指令無回應
• 錯誤修正：#11204 SKYPE 存取應用程式介面不能拒絕存取裝置。
• 更新內容：#10567 經由電話應用程式介面上下自動擴展聯絡人名單群組
• 錯誤修正：#11473API：用戶更換聲頻裝置時不發出通知
2.2 文件
修訂版本 日期 修改人 備註/更新內容
1.0 2004-10-22 Taavet Hinrikus API公開釋出
1.1 2005-01-12 Taavet Hinrikus Skype釋出版本
1.2 2005-03-04 Taavet Hinrikus
Skype釋出版本1.2，協議4，
開發工程師常見問題解
答項目等等
3 法 定地位
© Skype Technologies S.A
5
本API文件檔和SkypeAPI均為SkypeTechnologies S.A. 或其關聯公司版權所有。有關
使用限制請查閱Skype 網站上登載的終端用戶許可協議（EULA）：
http: //www.skype.com/go/eula
4 簡介
SkypeAPI可分為兩個不同的部分。Skype電話API和Skype存取API：
• Skype 電話API是Skype用來存取裝置的介面，其中包括但不限於USB
電話。裝置
本身並不一定是硬體，但通常指的是硬體裝置。這一API由Skype控制，而且API
的裝置面可被視作驅動程式。Skype為控制方。該API在抽象事件的層次上操作，
例如，綠色鍵被按下、耳機被拔掉、裝置應響起鈴聲等。
與Skype電話API相容的驅動程式，應在安裝時中自動完成安裝，這樣Skype才會
知道其存在。可以建立一個
USB裝置和相關驅動程式的資料庫，使Skype能夠偵測出新的裝置並提示安裝驅
動程式。
• Skype存取API是Skype發行給第三方協力廠商應用程式以存取Skype功能的
介面，例如，撥電話、發送文字訊息、索取Skype用戶資料等。
第三方協力廠商應用程式在此API中為控制方。Skype可有選擇性地逐一向應用程
式授予Skype存取API存取的權利。
5 一 般API概 述
API是根據在Skype與裝置（或裝置驅動器或在主機上執行的控制器）之間往返傳遞的簡
單文字訊息建立起來的。
6 電 話API
現已建置的電話API指令如下所列。
6.1 從裝置 發至Skype
• NAME deviceName
• PROTOCOL version
• AUDIO_IN deviceName
• AUDIO_OUT deviceName
• HOOK ON|OFF
• MUTE ON|OFF
• BTN_PRESSED (0-9,A-Z,#,*,UP,DOWN,YES,NO,SKYPE)
• BTN_RELEASED ...
6.2 從Skype發至 裝置
• MUTE ON|OFF
