SKYPE的API接口文档 - CN

Skype中文开发API文档

.协议4中采用ISO前置码,例如:USER mike LANGUAGE

en English.

? COUNTRY – 国家名称。例如:USER mike COUNTRY Estonia.在 协议4中采用ISO前置码,例如:USER mike COUNTRY Estonia. ? PROVINCE – 例如:USER mike PROVINCE Harjumaa. ? CITY – 例如:USER mike CITY Tallinn.

? PHONE_HOME – 例如:USER mike PHONE_HOME 3721111111. ? PHONE_OFFICE – 例如:USER mike PHONE_OFFICE 3721111111. ? PHONE_ MOBILE – 例如:USER mike PHONE_MOBILE 3721111111. ? HOMEPAGE – 例如:USER mike HOMEPAGE http: //www.joltid.com. ? ABOUT – 例如:USER mike ABOUT I am a nice person. 9 Skype Technologies S.A 12

? HASCALLEQUIPMENT – 回传值永远显示TRUE。例如:USER pamela HASCALLEQUIPMENT TRUE.

? BUDDYSTATUS – 例如:USER pamela BUDDYSTATUS 2. 可设定的 BUDDYSTATUS 值:

? 0 – 从未列入联络人名单。 ? 1 – 已从联络人名单内删除。 ? 2 – 有待授权。 ? 3 - 已加入联络人名单。

? ISAUTHORIZED – 已得到目前用户的授权。例如:USER pamela ISAUTHORIZED TRUE. 值: ? TRUE ? FALSE

? ISBLOCKED – 已被目前用户封锁。例如:USER spammer ISBLOCKED TRUE. 值: ? TRUE ? FALSE

? DISPLAYNAME – 例如:USER pamela DISPLAYNAME pam. ? ONLINESTATUS 用户上线状态。例如:USER mike ONLINESTATUS ONLINE. 值: ? UNKNOWN –未知用户。

? OFFLINE – 用户处于脱机状态(未联机)。如果目前用户未经其他用 户授权而查看他/她的上线状态,也会回传此值。 ? ONLINE - 用户处于上线状态。

? AWAY – 用户处于暂时离开状态(已有一定时间没活动)。 ? NA - 用户离开。

? DND - 用户处于“请勿打扰”模式。

? SKYPEOUT – 用户在SkypeOut 联络人名单内。

9

Skype中文开发API文档

SKYPEME (协议 2)

? LASTONLINETIMESTAMP - UNIX时间戳,仅供脱机用户查阅。例如: USER mike LASTONLINETIMESTAMP 1078959579. 通话对象

就通话对象的属性发出通知。 语法:CALL ID PROP VALUE ID – 通话标识符。 PROP - 属性名。适用属性:

? TIMESTAMP – 通话的时间(UNIX时间戳)。例如: CALL 17 TIMESTAMP 1078958218

? PARTNER_HANDLE – 例如:CALL 17 PARTNER_HANDLE mike ? PARTNER_DISPNAME – 例如:CALL 17 PARTNER_DISPNAME Mike Mann

10 Skype Technologies S.A 13

? CONF_ID – 如果CONF_ID>0,则为电话会议。例如:CALL 17 CONF_ID 0 ? TYPE – 通话类型。例如:CALL 17 TYPE OUTGOING_PSTN. 可设定的 TYPE值:

? INCOMING_PSTN – 从PSTN接入的来电。 ? OUTGOING_PSTN – 向PSTN拨出的电话。 ? INCOMING_P2P - 从P2P接入的来电。 ? OUTGOING_P2P – 向 P2P拨出的电话。

? STATUS – 通话状态。例如:CALL 17 STATUS FAILED.可设定的 STATUS值:

? UNPLACED – 从未打过的电话。 ? ROUTING – 通话正在转接中。 ? EARLYMEDIA –

采用pstn,则可能在实际建立通话之前,已开始播放媒体。例如可以出现来 电铃声或待接留言(线路繁忙,请稍候)等。 ? FAILED –

电话未接通。试图获得FAILUREREASON,以便了解详细原因。 ? RINGING –电话铃正在响。 ? INPROGRESS – 通话正在进行中。 ? ONHOLD – 通话处于暂候状态。 ? FINISHED – 通话完毕。 ? MISSED – 未接到来电。 ? REFUSED – 来电被拒接。

? BUSY – 对方电话占线,即已按下挂机键。 ? CANCELLED (协议 2)

? FAILUREREASON – 例如:CALL 17 FAILUREREASON 1 (数字表示).

10

Skype中文开发API文档

SUBJECT – 未使用。

? PSTN_NUMBER – 例如:CALL 17 PSTN_NUMBER 372123123. ? DURATION – 例如:CALL 17 DURATION 0.

? PSTN_STATUS –进行PSTN通话时从网关回传的错误字符串。

例如:CALL 26 PSTN_STATUS 6500 PSTN connection creation timeout. ? CONF_PARTICIPANTS_COUNT –

举行电话会议时非会议主持者的人数。可设定值:

? 0 – 通话不属于电话会议。因为会议主持人CONF_PARTICIPANTS_COUNT 永远为 0。

? 1 – 通话是以前的电话会议。 ? 2, 3, 4 – 通话属于电话会议。 ? CONF_PARTICIPANT n –

电话会议第n个参加者的句柄、通话类型与状态、以及参加者的姓名显示(仅限 非主持人)。例如:CALL 59 CONF_PARTICIPANT 1 echo123 INCOMING_P2P INPROGRESS Echo Test Service. 11 Skype Technologies S.A 14 MESSAGE物件

就讯息对象的属性发出通知。 语法:MESSAGE ID PROP VALUE ID – 讯息标识符。 PROP - 属性名。适用属性:

? TIMESTAMP – 讯息送出的时间(UNIX时间戳)。 例如:MESSAGE 21 TIMESTAMP 1078958218

? PARTNER_HANDLE – 例如:MESSAGE 21 PARTNER_HANDLE mike ? PARTNER_DISPNAME – 例如:MESSAGE 21 PARTNER_DISPNAME Mike Mann ? CONF_ID – 未使用。

? TYPE – 讯息类型。例如:MESSAGE 21 TYPE TEXT.可设定的 TYPE值:

? AUTHREQUEST – 请求授权。 ? TEXT – 即时消息或标题组。 ? CONTACTS – 联络人数据。 ? UNKNOWN.—其他。

? STATUS – 讯息状态。例如:MESSAGE 21 STATUS QUEUED. 可设定的STATUS值:

? SENDING – 讯息正被发送。 ? SENT – 讯息已被发送。 ? FAILED –

讯息发送失败。不妨发一个FAILUREREASON指令了解详细原因。

11

Skype中文开发API文档

RECEIVED – 讯息已被接收。 ? READ – 讯息已被读取。 ? IGNORED – 讯息被忽略。 ? QUEUED – 讯息被列入待发队列。

? FAILUREREASON – 例如:MESSAGE 21 FAILUREREASON 1 (数字表示)。

? BODY – 讯息内容主体。例如:MESSAGE 21 BODY Hi, what's up? 聊天讯息CHATMESSAGE对象 就聊天讯息对象的属性发出通知。

语法:CHATMESSAGE ID PROP VALUE ID – 聊天讯息标识符。 PROP - 属性名。适用属性:

? TIMESTAMP – 讯息送出的时间(UNIX时间戳)。 例如:MESSAGE 21 TIMESTAMP 1078958218 ? PARTNER_HANDLE – 例如:CHATMESSAGE 21 PARTNER_HANDLE mike

? PARTNER_DISPNAME – 例如:CHATMESSAGE 21 12 Skype Technologies S.A 15 PARTNER_DISPNAME Mike Mann

? TYPE – 讯息类型。例如:MESSAGE 21 TYPE TEXT.可设定的 TYPE值:

? SETTOPIC – 聊天题目变更。 ? SAID –即时消息。

? ADDEDMEMBERS – 邀请某人加入聊天。 ? SAWMEMBERS – 参加聊天者见过其他成员。 ? CREATEDCHATWITH – 已建立多人聊天。

? LEFT – 有人已退出聊天;如某人不能被加入聊天,也会作通知。 ? UNKNOWN.—其他。

? STATUS – 讯息状态。例如:MESSAGE 21 STATUS QUEUED. 可设定的STATUS值:

? SENDING – 讯息正被发送。 ? SENT – 讯息已被发送。 ? RECEIVED – 讯息已被接收。 ? READ – 讯息已被读取。

? LEAVEREASON – 与LEFT类型讯息同时使用。例如: CHATMESSAGE 21 LEAVEREASON UNSUBSCRIBE.可设定的 LEAVEREASON值:

? USER_NOT_FOUND – 没有找到用户。

? USER_INCAPABLE – 用户使用旧版Skype,因此无法加入多人聊天。 ? ADDER_MUST_BE_FRIEND –

12

联系客服:779662525#qq.com(#替换为@) 苏ICP备20003344号-4