飞信发送接口调用说明

 

1)此飞信接口核心文件只有FetionObj.dll及FetionSer.dll,其它文件都为飞信客户端文件,只把你的应用程序及上面的两个文件放到与飞信客户端同一目录就可以了，调试时，你要把那此文件都复制一份到你的运行目录，包括Theme目录.

2)开发使用接口时,你只要添加FetionObj.dll文件到引用中,并在源码引用里加“using Fetion;”语句，此引用两个对象：FetionUser结构为好友信息结构，FetionObj类为飞信操作接口类。

3)FetionUser结构说明如下:
    public struct FetionUser
    {
public string FetionNo; // 飞信账号
public string MobileNo; // 飞信手机号
public string UName; // 用户姓名或昵称
public bool EnableIM; // 飞信在线
public bool EnableSMS; // 短信在线
public bool EnableInvite //是否活动(登录或退出)
    }

4)FetionObj类说明
（调用可参考我给的"调用测试"程序源码）

********************************************************
属性说明:
/// <summary>
/// 确定是否已经登录,等于true为已经登录
/// </summary>
public bool isLogin

/// <summary>
/// 返回用于登录的手机号或飞信号
/// </summary>
public string GetMyNo

/// <summary>
/// 返回自己的飞信号
/// </summary>
public string GetMyFetionNo

/// <summary>
/// 返回自己的手机号
/// </summary>
public string GetMyMobileNo

/// <summary>
/// 返回自己的昵称
/// </summary>
public string GetMyName

*****************************************************
函数说明:
/// <summary>
/// 飞信类构造函数
/// </summary>
public FetionObj()

/// <summary>
/// 登录飞信
/// </summary>
/// <param name="myMNo">string,手机号或飞信号</param>
/// <param name="myMPass">string飞信密码</param>
/// <returns>true操作成功(注:发生OnLogin事件后才知道登录是否成功),false操作失败</returns>
public bool LoginFetion(string myMNo, string myMPass)

/// <summary>
/// 注销飞信
/// </summary>
public void LogoutFetion()

/// <summary>
/// 发送短信(注:你可以多次调用,在SendOk事件返回成功结果)
/// </summary>
/// <param name="toMNoArr">发送目标手机号或飞信号数组</param>
/// <param name="SmsMsg">发送的信息内容</param>
/// <param name="isSms">true全部发手机短信,false根据用户在线情况自动处理</param>
public bool SendSms(string[] toMNoArr, string SmsMsg)

/// <summary>
/// 发送定时短信
/// </summary>
/// <param name="toMNoArr">发送目标手机号或飞信号数组</param>
/// <param name="SmsMsg">发送的信息内容</param>
/// <param name="toTime">定时发送时间,注意:要大于10分钟后的时间</param>
public bool SendTimeSms(string[] toMNoArr, string SmsMsg, DateTime toTime)

/// <summary>
/// 添加好友
/// </summary>
/// <param name="addMNo">要添加的目标手机号或飞信号</param>
/// <param name="Msg">给对方的信息,限制不大于10个字符(即5个汉字)</param>
/// <param name="FriendName">自定义的好友姓名或昵称</param>
public bool AddFriend(string addMNo, string Msg, string FriendName)

/// <summary>
/// 删除好友
/// </summary>
/// <param name="addMNo">要删除的目标手机号或飞信号</param>
public bool DelFriend(string delMNo)

/// <summary>
/// 直接获取好友列表
/// </summary>
public FetionUser[] GetMList()

/// <summary>
/// 确定好友列表是否准备好
/// </summary>
public bool isMListOk()

**************************************************************************
事件说明:

/// <summary>
/// 有新短信时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="ReU">发送方用户信息</param>
/// <param name="Msg">收到的信息内容</param>
public delegate void ReFindMsg(FetionObj FObj, FetionUser ReU, string Msg);

/// <summary>
/// 有新短信时触发事件
/// </summary>
public event ReFindMsg OnReFindMsg; //接收到短信

/// <summary>
/// 接收短信出错时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="ErrTxt">错误信息</param>
public delegate void ReErr(FetionObj FObj, string ErrTxt);

/// <summary>
/// 接收短信出错时触发事件
/// </summary>
public event ReErr OnReErr;

/// <summary>
/// 被添加为好友时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="ReU">对方用户信息</param>
/// <returns>true同意,并添加他为好友,false不同意</returns>
public delegate bool ReAdd(FetionObj FObj, FetionUser ReU);

/// <summary>
/// 被添加为好友时触发事件
/// </summary>
public event ReAdd OnReAdd;

/// <summary>
/// 好友状态改变时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="ReU">好友对方信息</param>
public delegate bool PChanged(FetionObj FObj, FetionUser ReU);

/// <summary>
/// 好友状态改变时触发事件
/// </summary>
public event PChanged OnPChanged;

/// <summary>
/// 每发送成功一条短信时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="ToFNo">目标飞信号</param>
/// <param name="Msg">发送的信息内容</param>
public delegate void SendOk(FetionObj FObj, string ToFNo, string Msg);

/// <summary>
/// 每发送成功一条短信时触发事件
/// </summary>
public event SendOk OnSendOk;

/// <summary>
/// 全部发送完成后触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
public delegate void SendAllOk(FetionObj FObj);

/// <summary>
/// 全部发送完成后触发事件
/// </summary>
public event SendAllOk OnSendAllOk; //全部发送完后

/// <summary>
/// 每发送出错时时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="ToFNo">目标飞信号</param>
/// <param name="Msg">发送的信息内容</param>
/// <param name="ErrTxt">错误信息</param>
public delegate void SendErr(FetionObj FObj, string ToFNo, string Msg, string ErrTxt);

/// <summary>
/// 每发送出现错误时时触发事件
/// </summary>
public event SendErr OnSendErr; //发送出错

/// <summary>
/// 飞信登录结束后触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信运用类对象</param>
/// <param name="oklogin">登录是否成功,true为成功</param>
public delegate void Login(FetionObj FObj, bool oklogin);

/// <summary>
/// 飞信登录结束后触发事件
/// </summary>
public event Login OnLogin;

/// <summary>
/// 好友列表完成时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信类对象</param>
/// <param name="uList">好友列表</param>
public delegate void MList(FetionObj FObj, FetionUser[] uList);

/// <summary>
/// 好友列表完成时触发事件
/// </summary>
public event MList OnMList;

/// <summary>
/// 飞信被注销时触发事件代理
/// </summary>
/// <param name="FObj">发生事件的飞信类对象</param>
public delegate void Logout(FetionObj FObj);

/// <summary>
/// 飞信被注销时触发事件
/// </summary>
public event Logout OnLogout;