飞信命令行工具(2009版)使用说明
2010-01-28 16:57:03 阿炯

>> 文件列表<<
fetion    linux下主运行程序
fetion.exe  win32下主运行程序
sample.conf  演示配置文件
readme.txt  本说明文件
plugins 机器人框架程序
fxdemo.sql 机器人框架数据库(请导入到数据库)
cron.sh       机器人监控程序(LINUX)
robots.dat    机器人账号密码(配合cron.sh)

注:本程序需要 libACE的支持,库请到 http://www.it-adv.net/  中下载
linux下需要的四个文件:http://www.it-adv.net/fetion/downng/library_linux.tar.gz
libACE.so.5.6.8
libACE_SSL.so.5.6.8
libcrypto.so.0.9.8
libssl.so.0.9.8

windows下需要的四个文件: http://www.it-adv.net/fetion/downng/library_win32.rar
ACE.dll
ACE_SSL.dll
libeay32.dll
ssleay32.dll

该程序使用 visual studio 2005 开发,如果不能运行,请先安装 2005的支持包
http://www.it-adv.net/fetion/downng/vcredist_x86.rar

请把依赖的库文件和执行程序放到相同的目录,本程序的 linux 版本 基于 UBUNTU 7.10(gutsy) 开发,libc6。
一些老的发行版,如 RH9, RHES4等可能无法正常运行,请参照  http://bbs.it-adv.net/viewthread.php?tid=154 如何在不同版本Linux上运行Binary-Only应用包 解决。

>> 使用说明 <<
以下参数提供登录用的账号密码(三种方式,手机号-密码 飞信号-密码 文件--索引)
--mobile=[手机号]       登录手机号
--sid=[飞信号]        登录飞信号
--pwd=[密码]         登录密码
--config=[文件名]       存储手机号、密码的文件。
--index=[索引号]       索引

以下参数提供接收者
--to=[手机号/飞信号/URI]   接收消息的手机号/飞信号/URI.如果知道对方URI,则只需自己在对方好友列表,无需对方在自己好友列表就能发送。20090203003版本后,支持多个号码,中间用,逗号分隔
--msg-utf8=[信息] 
发送的消息,UTF8编码
--msg-gb=[信息] 
发送的消息,GB编码
--file-utf8=[文件utf8格式]
发送文件内容
--file-gb=[文件gb格式]
发送文件内容
--msg-type=[0/1/2]
发送消息类型:普通消息 长消息 智能短信

小工具  
--query-cmcc-no  查询移动公司手机段

以下为可选项
--debug
显示调试信息
--hide    
隐身登录

--proxy-ip=http代理ip
--proxy-port=http代理端口

>> 举例 <<
以下为 windows 下举例:
fetion --mobile=13711123456 --pwd=mypwd --to=137xxxxxxxx --msg-gb=测试
fetion --sid=6630321 --pwd=mypwd --to=137xxxxxxxx --msg-gb=测试
fetion --config=sample.conf --index=1 --to=137xxxxxxxx --msg-gb=测试

linux下,请使用如下命令:
LD_LIBRARY_PATH=. ./fetion --mobile=13711123456 --pwd=mypwd --to=137xxxxxxxx --msg-utf8=测试
LD_LIBRARY_PATH=. ./fetion --sid=6630321 --pwd=mypwd --to=137xxxxxxxx --msg-utf8=测试
LD_LIBRARY_PATH=. ./fetion --config=sample.conf --index=1 --to=137xxxxxxxx --msg-utf8=测试

发送消息中如果需要换行,请用 \n
// 以下为 sample.conf 内容,文件内容中, #号为注释行

# This config file is for fetion robot tool.
# Usage demo: ./fetion --config=/etc/fetion.conf --index=1
# ID Mobile  Password
1  137xxxx  1234234

机器人支持两种运行模式,一种是命令行模式,一种是服务模式。上面介绍的是命令行模式的操作。如果想使机器人长期在线,可以使用服务模式。只提供账号和密码登录飞信,即进入服务模式。想在服务模式下控制机器人,请参照 http://bbs.it-adv.net/viewthread.php?tid=170&extra=page%3D1  2009指令集
linux: http://www.it-adv.net/fetion/downng/fetion20090406003-linux.tar.gz
win32: http://www.it-adv.net/fetion/downng/fetion20090406003-win32.rar

声明:当运行时,会提示无法找到  php,这是因为本发行包中集成了机器人框架,如果您不需要机器人框架(机器人框架是一套plugin扩展,基于PHP开发,可以非常方便的实现机器人菜单应答)。可以不配置PHP和MYSQL环境。把plugins 目录下的 php 文件直接删掉就可以。然后,根据你自己的应用需要,去修改bat 文件(在 linux 下,修改 sh 文件)。想体验机器人框架,请到本版中查看 机器人框架配置指南。

2009版程序返回值列表
如果执行失败,程序退出时会返回失败原因结果。

在 windows 下:
echo %errorlevel%

linux 下:
echo $?
以上命令必须在执行完程序后立刻执行。 数值含义如下:

1:不能连接到 nav.fetion.com.cn:80
2:不能连接到 nav.fetion.com.cn:443
3:不能连接到 SIPC服务器
4:不能获取 SIPC参数
5:输入的手机号不是中国移动号码
6:返回数据中无法定位到URI
7:用户密码错误
8:服务器发送的认证信息错误
9:服务器发送的认证信息错误
10:发送数据失败
11:读取数据失败
12:读取数据和声明尺寸不一致
13:无法获取程序路径
16:无法获取联系人列表
17:飞信号码不在好友列表中
18:手机号码不在好友列表中