“飞信机器人/控制指令集”的版本间的差异

来自Blueidea
跳转至： 导航、 搜索
小
小 （→‎命令集）
 
（未显示同一用户的5个中间版本）
第15行： 第15行：
  
 
== 命令集 ==
 
== 命令集 ==
−
{|style="font-size:12px;font-family:宋体;border:0px;width:100%;background:#999;" cellspacing="1" cellpadding="3"
+
{|class="Tablelist"
−
|- span style="background:#333;color:#fff;"
+
|-
 
!功能!!命令格式(命令 对象 内容)!!说明
 
!功能!!命令格式(命令 对象 内容)!!说明
−
|- span valign="top"  style="background:#fff;"
+
|-
−
|短　　信||sms mobile<ref>手机号</ref>/sid<ref>飞信号</ref>/uri<ref>统一定位符，有飞信好友格式和手机好友格式</ref> message<ref>短信内容，特殊字符要替换一下(空格=&amp;nbsp;换行=\n,>=&amp;gt;）</ref>||向用户发送短信
+
|短　　信||sms mobile<ref>手机号</ref>/sid<ref>飞信号</ref>/uri<ref>统一定位符，有飞信好友格式和手机好友格式</ref> message<ref>短信内容，特殊字符要替换一下(空格=&amp;nbsp;换行=\n,>=&amp;gt;）</ref>||向用户发送短信<ref>返回参数：Service Unreachable(对方拒收飞信短信)，bad gateway(URI错)</ref>
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
 
|长 短 信||longsms mobile/sid/uri message||向用户发送长短信<ref>一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示</ref>
 
|长 短 信||longsms mobile/sid/uri message||向用户发送长短信<ref>一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示</ref>
−
|- span valign="top"  style="background:#fff;"
+
|-
 
|智能消息||smartmsg mobile/sid/uri message||如果不在线，则发手机短信
 
|智能消息||smartmsg mobile/sid/uri message||如果不在线，则发手机短信
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
 
|在线消息||chat mobile/sid/uri message||只有当对方激活会话时有效
 
|在线消息||chat mobile/sid/uri message||只有当对方激活会话时有效
−
|- span valign="top"  style="background:#fff;"
+
|-
 
|增加好友||buddy-add mobile desc<ref>加为好友的申请信息</ref> localname||localname<ref>在本地的显示名称，只有本地有效，</ref>仅为对方为手机用户时有效
 
|增加好友||buddy-add mobile desc<ref>加为好友的申请信息</ref> localname||localname<ref>在本地的显示名称，只有本地有效，</ref>仅为对方为手机用户时有效
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
−
|删除好友||buddy-delete mobile/uri/sid||删除机器人好友列表里的好友<ref>尽量使用URI来删除，否则可能失败</ref>
+
|删除好友||buddy-delete userid||删除机器人好友列表里的好友，购买授权后可用 。<ref>尽量使用URI来删除，否则可能失败</ref>
−
|- span valign="top"  style="background:#fff;"
+
|-
 
|邀请好友||mobile-invite mobile desc<ref>邀请短信时显示邀请人的姓名</ref>||发出邀请使用飞信<ref>尽量少用以免帐号被封</ref>
 
|邀请好友||mobile-invite mobile desc<ref>邀请短信时显示邀请人的姓名</ref>||发出邀请使用飞信<ref>尽量少用以免帐号被封</ref>
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
 
|屏蔽好友||buddy-block mobile/uri/sid||
 
|屏蔽好友||buddy-block mobile/uri/sid||
−
|- span valign="top"  style="background:#fff;"
+
|-
 
|解除屏蔽||buddy-unblock mobile/uri/sid||
 
|解除屏蔽||buddy-unblock mobile/uri/sid||
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
−
|接受邀请||accept_contact_request uri||只接受对方加机器人为好友。机器人不加对方
+
|接受邀请||accept_contact_request userid||只接受对方加机器人为好友。机器人不加对方
−
|- span valign="top"  style="background:#fff;"
+
|-
−
|获取信息||contact-info mobile/uri||获取联系人信息
+
|获取信息||contact-info mobile/uri||获取联系人信息，购买授权后可用 。
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
 
|登录状态||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>||修改登录状态
−
|- span valign="top"  style="background:#fff;"
+
|-
 
|修改心情||impresa||显示一段话，可以是链接
 
|修改心情||impresa||显示一段话，可以是链接
−
|- span valign="top" style="background:#EEEAE4;"
+
|-
 
|修改呢称||nickname||显示在对方飞信上的名称
 
|修改呢称||nickname||显示在对方飞信上的名称
−
|- span valign="top"  style="background:#fff;"
+
|-
−
|系统退出||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

注释说明

  1. ↑ 手机号
  2. ↑ 飞信号
  3. ↑ 统一定位符，有飞信好友格式和手机好友格式
  4. ↑ 短信内容，特殊字符要替换一下(空格=&nbsp;换行=\n,>=&gt;）
  5. ↑ 返回参数：Service Unreachable(对方拒收飞信短信)，bad gateway(URI错)
  6. ↑ 一条短信只能容纳140字节，超长的短信就要分成多条来发送，如果按长短信来发送，某些手机可以把多条并成一条显示
  7. ↑ 加为好友的申请信息
  8. ↑ 在本地的显示名称，只有本地有效，
  9. ↑ 尽量使用URI来删除，否则可能失败
  10. ↑ 邀请短信时显示邀请人的姓名
  11. ↑ 尽量少用以免帐号被封
  12. ↑ online/busy/away/hidden
  13. ↑ 个性化信息，如外出就餐等
取自“http://wiki.blueidea.com/index.php?title=飞信机器人/控制指令集&oldid=8328”