“飞信机器人/控制指令集”的版本间的差异
来自Blueidea
< 飞信机器人
小 |
小 （→命令集） |
||
| （未显示同一用户的9个中间版本） | |||
| 第15行： | 第15行： | ||
== 命令集 == | == 命令集 == | ||
| − | {| | + | {|class="Tablelist" |
| − | |- | + | |- |
!功能!!命令格式(命令 对象 内容)!!说明 | !功能!!命令格式(命令 对象 内容)!!说明 | ||
| − | |- | + | |- |
| − | |短 信||sms mobile<ref>手机号</ref>/sid<ref> | + | |短 信||sms mobile<ref>手机号</ref>/sid<ref>飞信号</ref>/uri<ref>统一定位符，有飞信好友格式和手机好友格式</ref> message<ref>短信内容，特殊字符要替换一下(空格=&nbsp;换行=\n,>=&gt;）</ref>||向用户发送短信<ref>返回参数：Service Unreachable(对方拒收飞信短信)，bad gateway(URI错)</ref> |
| − | |- | + | |- |
|长 短 信||longsms mobile/sid/uri message||向用户发送长短信<ref>一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示</ref> | |长 短 信||longsms mobile/sid/uri message||向用户发送长短信<ref>一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示</ref> | ||
| − | |- | + | |- |
|智能消息||smartmsg mobile/sid/uri message||如果不在线，则发手机短信 | |智能消息||smartmsg mobile/sid/uri message||如果不在线，则发手机短信 | ||
| − | |- | + | |- |
|在线消息||chat mobile/sid/uri message||只有当对方激活会话时有效 | |在线消息||chat mobile/sid/uri message||只有当对方激活会话时有效 | ||
| − | |- | + | |- |
| − | |增加好友||buddy-add mobile desc<ref> | + | |增加好友||buddy-add mobile desc<ref>加为好友的申请信息</ref> localname||localname<ref>在本地的显示名称，只有本地有效，</ref>仅为对方为手机用户时有效 |
| − | |- | + | |- |
| − | |删除好友||buddy-delete | + | |删除好友||buddy-delete userid||删除机器人好友列表里的好友，购买授权后可用 。<ref>尽量使用URI来删除，否则可能失败</ref> |
| − | |- | + | |- |
| − | |邀请好友||mobile-invite mobile desc||发出邀请使用飞信<ref>尽量少用以免帐号被封</ref> | + | |邀请好友||mobile-invite mobile desc<ref>邀请短信时显示邀请人的姓名</ref>||发出邀请使用飞信<ref>尽量少用以免帐号被封</ref> |
| − | |- | + | |- |
|屏蔽好友||buddy-block mobile/uri/sid|| | |屏蔽好友||buddy-block mobile/uri/sid|| | ||
| − | |- | + | |- |
|解除屏蔽||buddy-unblock mobile/uri/sid|| | |解除屏蔽||buddy-unblock mobile/uri/sid|| | ||
| − | |- | + | |- |
| − | |接受邀请||accept_contact_request | + | |接受邀请||accept_contact_request userid||只接受对方加机器人为好友。机器人不加对方 |
| − | |- | + | |- |
| − | |获取信息||contact-info mobile|| | + | |获取信息||contact-info mobile/uri||获取联系人信息，购买授权后可用 。 |
| − | |- | + | |- |
|登录状态||status code<br>status-desc code<ref>online/busy/away/hidden</ref> desc<ref>个性化信息，如外出就餐等</ref>||修改登录状态 | |登录状态||status code<br>status-desc code<ref>online/busy/away/hidden</ref> desc<ref>个性化信息，如外出就餐等</ref>||修改登录状态 | ||
| − | |- | + | |- |
|修改心情||impresa||显示一段话，可以是链接 | |修改心情||impresa||显示一段话，可以是链接 | ||
| − | |- | + | |- |
|修改呢称||nickname||显示在对方飞信上的名称 | |修改呢称||nickname||显示在对方飞信上的名称 | ||
| − | |- | + | |- |
| − | |系统退出||exit|| | + | |系统退出||exit mobile|| |
|} | |} | ||
'''注释说明''' | '''注释说明''' | ||
<references/> | <references/> | ||
2011-04-18T16:32:11的最后版本
机器人控制指令
概述
通过向 commands 目录放置命令文件(UTF-8编码)，就能控制飞信机器人动作。飞信机器人在执行完指令后，会删除命令文件。
命令文件命名标准
手机号码_命令ID.cmd 如： 13764490999_000000.cmd
手机号码：因为本系统支持多个飞信号码同时登录，所以该参数指名发往哪个飞信号。
命令id: 随意命名，该id 用来反馈执行结果。有些指令，该参数可能无效。
开发者可以通过此id获取命令执行结果。
命令集
| 功能 | 命令格式(命令 对象 内容) | 说明 |
|---|---|---|
| 短 信 | sms mobile[1]/sid[2]/uri[3] message[4] | 向用户发送短信[5] |
| 长 短 信 | longsms mobile/sid/uri message | 向用户发送长短信[6] |
| 智能消息 | smartmsg mobile/sid/uri message | 如果不在线，则发手机短信 |
| 在线消息 | chat mobile/sid/uri message | 只有当对方激活会话时有效 |
| 增加好友 | buddy-add mobile desc[7] localname | localname[8]仅为对方为手机用户时有效 |
| 删除好友 | buddy-delete userid | 删除机器人好友列表里的好友，购买授权后可用 。[9] |
| 邀请好友 | mobile-invite mobile desc[10] | 发出邀请使用飞信[11] |
| 屏蔽好友 | buddy-block mobile/uri/sid | |
| 解除屏蔽 | buddy-unblock mobile/uri/sid | |
| 接受邀请 | accept_contact_request userid | 只接受对方加机器人为好友。机器人不加对方 |
| 获取信息 | contact-info mobile/uri | 获取联系人信息，购买授权后可用 。 |
| 登录状态 | status code status-desc code[12] desc[13] |
修改登录状态 |
| 修改心情 | impresa | 显示一段话，可以是链接 |
| 修改呢称 | nickname | 显示在对方飞信上的名称 |
| 系统退出 | exit mobile |
注释说明
- ↑ 手机号
- ↑ 飞信号
- ↑ 统一定位符，有飞信好友格式和手机好友格式
- ↑ 短信内容，特殊字符要替换一下(空格= 换行=\n,>=>）
- ↑ 返回参数：Service Unreachable(对方拒收飞信短信)，bad gateway(URI错)
- ↑ 一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示
- ↑ 加为好友的申请信息
- ↑ 在本地的显示名称，只有本地有效，
- ↑ 尽量使用URI来删除，否则可能失败
- ↑ 邀请短信时显示邀请人的姓名
- ↑ 尽量少用以免帐号被封
- ↑ online/busy/away/hidden
- ↑ 个性化信息，如外出就餐等
