华信短信平台通道开发.docx

为了客户少走弯路，华信成立了开源短信社区。华信开源社区以分享专业、优质、高效的短信技术为己任。一套免费的企业短信应用平台源码，供大家下载分享学习使用，版权归华信科技所有。相关技术下载联系今日博主。一套系统售价好几十万，短信平搭建成功。让大家更好的熟悉使用这套免费平台。我分享一下我的搭建经验。 ### 华信短信平台通道开发知识点详解 #### 一、华信开源社区介绍 华信开源社区致力于分享高质量、高效能的短信技术解决方案，旨在帮助企业和个人开发者减少开发过程中的障碍，提供一套免费的企业短信应用平台源码供下载学习使用。通过这种方式，华信科技希望用户能够更好地理解和掌握这套系统的使用方法。 #### 二、开发新通道模板概述 针对华信短信平台的SendGateway模块，为了接入新的第三方短信通道，开发者需要创建一套符合要求的新模板。这个模板需要遵循特定的设计模式和技术栈要求。 #### 三、开发环境与技术栈 - **开发环境**：Visual Studio 2019 - **技术栈**：.NET Framework 4.5 - **编程语言**：C# #### 四、开发流程详解 ##### 4.1 创建类库项目 - 在Visual Studio 2019中创建一个新的类库项目，项目名称自定义，选择.NET Framework 4.5作为开发框架，语言为C#。 ##### 4.2 添加引用 - 添加对`Hx.SmsPlatform.Common.dll`程序集的引用。这个程序集包含了启动模板所需的相关类型与接口。 ##### 4.3 修改类名 - 将默认的`Class1`文件重命名为`SendSms`。 ##### 4.4 定义属性对象 - 新建一个名为`ProptryObject`的类，继承自`Http2Property`。这个类位于`Hx.SmsPlatform.Common.dll`中，用于定义模板运行时所需的各个属性。 - 使用`DefaultValue`、`DisplayName`、`Description`等标记来指定属性的默认值、中文名称及描述。 ##### 4.5 修改`SendSms`类 - 修改`SendSms`类，使其继承自`Http2SendSms<>`，并在泛型参数中传入之前定义的`ProptryObject`类。 - 给`SendSms`类加上`ChannelTemplate`标记，该标记包含三个参数：模板编号、模板名称、模板类型（短信或彩信）。 ##### 4.6 重写`OnInit`方法 - 重写父类`SendSms`的`OnInit`方法，执行父类的初始化操作，并为事件附加相应的方法，用于获取余额、状态和上行信息。 ##### 4.7 实现发送逻辑 - 重写父类`Http2SendSms<>`的`OnSend`方法，编写远程调用逻辑，并解析返回值，生成`SendResult`类返回。 - `sms`参数提供了发送所需的各种数据信息，如手机号码集合(`sms.Msisdns`)、消息内容(`sms.Content()`)、扩展号码(`sms.ExtNumber`)等。 - `SendResult`类表示发送的结果，可通过`Result`方法创建，包含发送状态(`mtStatus`)、发送标识(`messageId`)、返回代码(`resultCode`)和描述(`description`)等信息。 ##### 4.8 获取余额 - 为事件`Elapsed`（每30秒执行一次）附加方法`Balance_Elapsed`，执行余额查询的相关逻辑操作，并使用`SetBalance`方法设置当前通道余额。 ##### 4.9 处理状态报告 - 状态报告为主动获取时，为事件`Elapsed`附加一个方法`Report_Elapsed`，进行状态获取，并使用`NotifyReceiveReport`通知父类进行下一步处理。 - 状态报告为推送时，需要实现`IHttpReceiveReport`接口，重写`OnPost`方法，并返回一个`ReportObject`对象。 ##### 4.10 上行处理 - 上行为主动获取时，为事件`Elapsed`附加一个方法`Mo_Elapsed`，进行上行的相关逻辑处理，并使用`NotifyReceiveMo`通知父类进行下一步处理。 - 上行为推送时，同样需要实现`IHttpReceiveReport`接口，重写`OnPost`方法，并返回一个`MoObject`对象。 #### 五、部署与测试 - 将生成的程序集文件放置于`Hx.SmsPlatform.SendGateway`文件夹下。 - 如果状态或上行有推送需求，还需要在`Hx.SmsPlatform.ReceiveMoReport`网站的`bin`目录下放置该模板的程序集文件。 - 使用`Hx.SmsPlatform.WindowsForms`程序进行测试，确保所有功能正常运行。 通过以上步骤，开发者可以成功地为华信短信平台开发一个新的第三方短信通道模板，进一步拓展平台的功能性和兼容性。