完善C#实现的短信设备类库API
分享前几篇文章写到完成了一个简单的类库，虽然可以完成可以完成短信设备短信的发送与接收，但是类库还不是很完善，现在奉上较为完善的版本。
完善后类库说明如下：
属性
方法
打开设备（Open）
功能描述： 打开与设备的通讯端口，设备初始化
参数： 无
返回： 无 （打开失败将抛出异常）关闭设备（Close）
功能描述： 关闭与设备的通讯端口，设备关闭
参数： 无
返回： 无（关闭失败将抛出异常）取得机器码（GetMachineNo）
功能描述： 取得机器码
参数： 无
返回： string 机器码字符串（设备厂商）发送AT指令（SendAT）
功能描述： 向端口发送 AT 指令
参数： ATCmd string 您要发送的 AT 指令
返回： string AT指令返回结果 （如为错误，引发异常）设置短信中心号码（SetMsgCenterNo）
功能描述： 设置短信中心号码
参数： sNewValue string 短信中心号码
返回： 无 （失败将抛出异常）取得短信中心号码（GetMsgCenterNo）
功能描述： 取得短信中心号码
参数： 无
返回： string 短信中心号码发送短消息（SendMsg）
功能描述： 发送一条短信息
参数： phone string 对方的手机号码
msg string 短消息内容
msgCenterNo string 短信中心号码（可选）
msgType 枚举MgType 短信类型{AUSC2：USC2编码，A7Bit：7位编码} 可选（不选时USC2编码）
返回： 无 （发送失败将抛出异常）取得未读信息列表（GetUnreadMsg）
功能描述： 取得未读信息
参数： 无
返回： string[] 逗号分隔的未读信息列表字符串（中心号码，手机号码，发送时间，短信内容） （失败将抛出异常）读取设备新收到的短消息（ReadNewMsg）
功能描述： 读取设备新收到的短消息
参数： 无
返回： string 信息字符串，同信息列表中格式（失败将抛出异常）读取短消息（ReadMsgByIndex）
功能描述： 读取 SIM 卡中指定位置的短消息
参数： index int 短信序号
返回： string 信息字符串删除短消息（DelMsgByIndex）
功能描述： 删除 SIM 卡中指定位置的短信
参数： index int 要删除 SIM 卡中短信的位置
返回： 无 （失败将抛出异常）事件
1、 OnReceive 当短信到达时触发这个事件，请在此事件中调用ReadNewMsg方法
程序说明：
加入了7bit的编码，发送英文短信每条可以发送160个字符(原来程序中是按USC2编码发送的英文短信，最多只能发送70个字符)
有关编码的详细信息参考：《短信设备软件的实现(C#)PDU格式短信解析》
7bit的编码详细方案参考：《短信设备软件的实现(C#)7bitPDU的编码》
7bit编码发送短信函数：
public void SendMsg(string phone, string msg, MsgType msgType)
{
if (msgType == MsgType.AUSC2)
{
SendMsg(phone, msg);
}
else
{
PDUEncoding pe = new PDUEncoding();
pe.ServiceCenterAddress = msgCenter; //短信中心号码 服务中心地址
string temp = pe.PDU7BitEncoder(phone, msg);
int len = (temp.Length - Convert.ToInt32(temp.Substring(0, 2), 16) * 2 - 2) / 2; //计算长度
try
{
temp = SendAT("AT+CMGS=" + len.ToString() + "\r" + temp + (char)(26)); //26 Ctrl+Z ascii码
}
catch (Exception)
{
throw new Exception("短信发送失败");
}
if (temp.Substring(temp.Length - 4, 3).Trim() == "OK")
{
return;
}
throw new Exception("短信发送失败");
}
}和原来发送函数类似：仅仅改动的地方是调用的PDUEncoding的7bit编码。
另外，类还改动了GSMModem的字段，属性，方法；增加了有关API，便于短信设备软件的实现。
字段：添加了newMsgIndex和msgCenter，newMsgIndex用于保存一条刚收到的新信息的序号，msgCenter保存设置的短信中心号，发送短信使用
private int newMsgIndex; //新消息序号 private string msgCenter = string.Empty; //短信中心号码
属性：添加AutoDelMsg属性，代表是否需要在读取信息后自动删除SIM卡中存档。
private bool autoDelMsg = false;
/// <summary>
/// 对autoDelMsg访问
/// 设置是否在阅读短信后自动删除 SIM 卡内短信存档
/// 默认为 false
/// </summary>
public bool AutoDelMsg
{
get
{
return autoDelMsg;
}
set
{
autoDelMsg = value;
}
}AutoDelMsg为true时，将在读取短信的方法中调用DelMsgByIdex删除对应SIM卡中内容。
方法：添加 取得机器码（GetMachineNo）、设置短信中心号码（SetMsgCenterNo）、取得短信中心号码（GetMsgCenterNo）、取得未读信息列表（GetUnreadMsg）、读取设备新收到的短消息（ReadNewMsg）
取得机器码（GetMachineNo）：
public string GetMachineNo()
{
string result = SendAT("AT+CGMI");
if (result.Substring(result.Length - 4, 3).Trim() == "OK")
{
result = result.Substring(0, result.Length - 5).Trim();
}
else
{
throw new Exception("获取机器码失败");
}
return result;
}
通过AT指令获取设备厂商名，若需要可以再添加其他内容。
设置短信中心号码（SetMsgCenterNo）：
public void SetMsgCenterNo(string msgCenterNo)
{
msgCenter = msgCenterNo;
}
仅设置msgCenter字段，发送短信时：编码部分代码改为
PDUEncoding pe = new PDUEncoding(); pe.ServiceCenterAddress = msgCenter; //短信中心号码 服务中心地址 string temp = pe.PDUUSC2Encoder(phone, msg);
取得短信中心号码（GetMsgCenterNo）：
public string GetMsgCenterNo()
{
string tmp = string.Empty;
if (msgCenter != null && msgCenter.Length != 0)
{
return msgCenter;
}
else
{
tmp = SendAT("AT+CSCA?");
if (tmp.Substring(tmp.Length-4,3).Trim() == "OK")
{
return tmp.Split(‘"‘)[1].Trim();
}
else
{
throw new Exception("获取短信中心失败");
}
}
}若字段msgCenter有值则直接返回，无则从SIM卡存档中读取。
取得未读信息列表（GetUnreadMsg）：
public string[] GetUnreadMsg()
{
string[] result = new string[255]; //可存储255条 SIM卡不能存这么多
string[] temp = null;
string tmp = string.Empty;
tmp = SendAT("AT+CMGL=0"); //发送AT指令 读取未读信息
if (tmp.Substring(tmp.Length - 4, 3).Trim() == "OK") //读取成功
{
temp = tmp.Split(‘
‘);
}
PDUEncoding pe=new PDUEncoding(); //解码类
int i = 0; //计数
foreach (string str in temp)
{ //此条为PDU串
if (str != null && str.Length != 0 && str.Substring(0, 2).Trim() != "+C" && str.Substring(0, 2) != "OK")
{
result[i] = pe.PDUDecoder(str); //解码
i++;
}
}
return result; // 返回 空则无新信息
}列出所有未读信息，返回string[]类型，无新信息则返回空。
读取设备新收到的短消息（ReadNewMsg）：
public string ReadNewMsg()
{
return ReadMsgByIndex(newMsgIndex);
}新信息序号存在序号为newMsgIndex字段中，调用ReadMsgByIndex即可读取。
其他改动：有些方法的名称有少许改动，ReadMsgByIndex方法返回值类型和参数列表有些改变，算法没有变化，在此不做详细说明；详见附件项目文件
到此，上面所写的就是比较完善的API类库，需要项目文件可以下载：
回帖 ( 0 )