内容发布更新时间 : 2024/12/23 7:52:00星期一 下面是文章的全部内容请认真阅读。
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