SKYPE的API接口文档_CN

保密条款：本文件为 Skype TechnologiesS.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 文件

修订版本日期修改人备注/更新内容

-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: ///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)