Skype中文开发API文档
SkypeOut 联络人，\ONLINESTATUS\指令时将回传\。 7.5 怎样检测 Skype
如需检测是否已安装Skype，请查看以下登录机码：
HKCU\\Software\\Skype\\Phone '?SkypePath' 。该机码将指出skype.exe的位置。 如找不到该机码，还应查一下程序是否有
HKLM\\Software\\Skype\\Phone '?SkypePath' 此一机码（如找不到HKCU，但可找到 HKLM，则说明skype已经由管理员账号安装，但尚未被目前用户所使用）。 7.6 版本信息
每次释出API的新版本时，协议版本号码都会增加。客户端要使用该API时，必须让Skyp eAPI知道它所支持的最新版本。Skype将报出自己的最新版本号作为回答，并将以Skyp e所报号码版本做为使用的协议版本。Skype报出的协议版本永远不会比客户端程序支持 的版本更高。Skype的默认版本是协议版本1。 Skype支持的版本可以PROTOCOL 99999查询。
例如：客户端采用版本3，并向Skype报出 \3\，Skype支持版本2并报出\
2\作为回答。版本2则为此例中使用的协议版本。
关于SkypeAPI版本更新和出现客户端支持低于Skype版本时的说明： ? Skype不但不会删除新版本发来的讯息，而且会执行讯息要求的指令 ? 客户端应会忽略未知指令和属性（可能来自新版本的API，如新状态属性等） 7.7 Skype API协议版本 目前有协议版本1、2和3。 7.7.1 协议2新增功能
? 新增 onlinestatus SKYPEME。 5 Skype Technologies S.A 8
? 如通话处于暂候状态， API会分别向所有客户端发出\LOCALHOLD / REMOTEHOLD\的通知。协定1仅回传ONHOLD。 ? 新增 call status CANCELLED 7.7.2 协议3新增功能 ? 多人聊天指令
? 旧版即时消息（IM）的相容层 7.7.3 协议4新增功能
?在语言和国家值前面补加ISO代码 协议1、2的兼容性
如要求的协议版本低于3，则所有导入指令均以下列方式被转换： ? SEARCH MESSAGES -> SEARCH CHATMESSAGES
? SEARCH MISSEDMESSAGES -> SEARCH MISSEDCHATMESSAGES ? GET MESSAGE -> GET CHATMESSAGE ? SET MESSAGE -> SET CHATMESSAGE
5
Skype中文开发API文档
GET MESSAGE属性也被转换： ? PARTNER_HANDLE -> FROM_HANDLE ? PARTNER_DISPNAME -> FROM_DISPNAME
所有对API发出的通知的回答 (包括 GET/SET MESSAGE) 均被转换： ? CHATMESSAGE * FROM_HANDLE x -> MESSAGE * PARTNER_HANDLE x
? CHATMESSAGE * FROM_DISPNAME x -> MESSAGE * FROM_DISPNAME x
? CHATMESSAGE * FROM_DISPNAME x -> MESSAGE * 如协议版本低于3，SEARCH MESSAGES 和 SEARCH MISSEDMESSAGES指令将回传字符串 MESSAGES 1、2、3。 7.8 从Skype发至装置 7.8.1 状态指令
所有这些指令均由Skype在初次建立连结或在出现参数更变时进行广播。可用GET 指令随时对它们进行查询。 用户状态
语法：USERSTATUS status status - 用户状态值。适用值： ? UNKNOWN.
? ONLINE - 目前用户处于上线状态。 ? OFFLINE -目前用户处于脱机状态。
? SKYPEME - 目前用户正在使用\模式 (协议2)。 6 Skype Technologies S.A 9
? AWAY - 目前用户处于暂时离开状态。 ? NA - 目前用户离开。
? DND - 目前用户处于“请勿打扰”模式。
? INVISIBLE - 目前用户处于隐藏状态，其他用户看不见。 ? LOGGEDOUT - 目前用户已注销。用户已断线。 例如：USERSTATUS INVISIBLE 连结状态
语法：CONNSTATUS status status – 连结状态值。适用值： ? OFFLINE ? CONNECTING ? PAUSING ? ONLINE
? LOGGEDOUT - 目前用户已注销。 例如：CONNSTATUS ONLINE 目前用户句柄
6
Skype中文开发API文档
CURRENTUSERHANDLE userhandle 例如：CURRENTUSERHANDLE banana 7.8.2 搜寻结果
这些是对SEARCH指令的响应。 将来会把搜索结果数目限制在N个
(N值可以被设定)，但现在没有限制。今后可能支持传呼或自定范围查询。 用户搜寻 找到的用户名单。
语法：USERS user1 [,user2] [,user3] 例如：USERS abc, -abc-, abc10 朋友搜寻 找到的朋友名单。
语法：USERS user1 [,user2] [,user3] 例如：USERS tim, joe, mike 通话搜寻
找到的通话标识符名单。 7 Skype Technologies S.A 10 语法：CALLS id1 [,id2] [,id3] 例如：CALLS 15, 16, 39 未接来电的搜寻
找到的未接来电标识符名单。 语法：CALLS id1 [,id2] [,id3] 例如：CALLS 15, 16, 39 留言搜寻
找到的留言标识符名单。
语法：MESSAGES id1 [,id2] [,id3] 例如：MESSAGES 15, 16, 39 错过的留言搜寻
找到的错过留言标识符名单。 语法：MESSAGES id1 [,id2] [,id3] 例如：MESSAGES 15, 16, 39 聊天搜寻
找到的聊天标识符名单。 语法：CHATS id1 [,id2] [,id3]
例如：CHATS #test_2/$testtest20;54389d65f7d6f2c4, #test_b/$testtest20;867c47704bcc71fb 进行中的聊天搜寻
找到的UI上开放的聊天标识符名单。 语法：CHATS id1 [,id2] [,id3]
7
Skype中文开发API文档
CHATS #test_2/$testtest20;54389d65f7d6f2c4, #test_b/$testtest20;867c47704bcc71fb 错过的聊天搜寻
找到的含未读讯息的聊天标识符名单。 语法：CHATS id1 [,id2] [,id3]
例如：CHATS #test_2/$testtest20;54389d65f7d6f2c4, #test_b/$testtest20;867c47704bcc71fb 最近的聊天搜寻
找到的最近聊天标识符名单。 语法：CHATS id1 [,id2] [,id3]
例如：CHATS #test_2/$testtest20;54389d65f7d6f2c4, #test_b/$testtest20;867c47704bcc71fb 8 Skype Technologies S.A 11 标注的聊天搜寻
找到的标注聊天标识符名单。 语法：CHATS id1 [,id2] [,id3]
例如：CHATS #test_2/$testtest20;54389d65f7d6f2c4, #test_b/$testtest20;867c47704bcc71fb 7.8.3 通知
如相应对象发生变化或以GET指令请求属性值，Skype则会发出通知。另外，如果属性值 被SET指令所更改，会发出通知，确认更改。
涉及相关对象时会发出通知，如好友名单（buddylist）内的用户、正在进行的通话和即 时讯息等。
\是对应对象的属性。 用户对象
就用户对象的属性发出通知。 语法：USER USERNAME PROP VALUE USERNAME – 用户名。 PROP - 属性名。适用属性：
? HANDLE – 用户名。例如：USER pamela HANDLE pamela。 ? FULLNAME – 用户全名。例如：USER pamela FULLNAME Jane Doe.
? BIRTHDAY – 以YYYYMMDD格式表示用户生日。例如：USER bitman BIRTHDAY 19780329.
? SEX – 例如：USER pamela SEX UNKNOWN.值： ? UNKNOWN – 用户在个人资料内未注明性别。 ? MALE ? FEMALE
? LANGUAGE – 语言名称。例如：USER mike LANGUAGE
8