.NET快速对接极光消息推送
什么是消息推送？
很多手机APP会不定时的给用户推送消息，例如一些新闻APP会给用户推送用户可能感兴趣的新闻，或者APP有更新了，会给用户推送是否选择更新的消息等等，这就是所谓的“消息推送”。
常见的一些APP消息推送示例
强营销类：
直接把营销力度，营销模式以一种叫卖式方式展现出来，目的通过优惠，时效性勾起用户贪小便宜的心理，好奇心理，如下所示：
强关联性：
在信息爆炸的时代，大脑会自动筛选对自己有价值的信息和没价值的信息，如果在一条信息中有@你，您之类的言语，大脑会自动识别，使用直接关联的技巧在于巧用“你”相关的字眼。
强话题性：
营销界有这么一句话，没有违和感就创造不了传播，不出位就制造不了话题，那么强话题性的文案自带传播属性，一般都会击中用户内心的某个感触，比如对社会的愤世嫉俗，对高房价的逆反心理，对旅游的文艺心等等。
极光推送介绍
极光推送（JPush）是日均消息量超百亿级规模的 App 消息推送专业服务平台，极光推送支持 Android、iOS、QuickApp、Web 等平台，SDK 接入方便快捷，推送通道高速稳定且支持海外专线，API 开放接口强大、灵活和易用、WEB 端支持创建通知、后效分析、标签别名管理和故障排查等运营功能。 极光推送（JPush）在为开发者提供基础推送服务的同时，还提供了用户精准标签、用户分群、地理围栏、应用内消息、智能发送策略、智能促活等服务能力，可有效提升消息的送达率、展示率和点击率，通过精细化运营触达助力 APP 提升日活和留存。
平台类型支持
消息类型支持
通知样式支持
为什么选择极光作为APP的消息推送平台？
-
首先极光推送支持多平台推送。
-
支持大规模的消息推送。
-
极光推送对接方便，不同后端语言都提供了对应的SDK。
-
对于免费账号支持也非常的友好（不过免费账号高峰期有资源瓶颈，假如需要及时性很强的话可以购买高级版收费服务）。
快速对接Jpush极光推送
-
到极光推送官方网站注册开发者帐号；
-
登录进入管理控制台，创建应用程序，得到 Appkey（SDK 与服务器端通过 Appkey 互相识别）；
-
在推送设置中给 Android 设置包名、给 iOS 上传证书、启用 WinPhone，根据你的需求进行选择；
.NET FX 4.5项目快速接入
该项目是基于C#/.NET(.NET Framework4.5.1的示例)极光推送对接实例，主要是对接极光集成为我们.Neter提供的SKD。在这里我主要封装了单个设备注册ID推送，设备注册ID批量推送和广播推送三种推送三种方式，其他的推送方式大家可以参考文档去进行封装。
-
JPuhs-Sample（封装示例源码）:https://github.com/YSGStudyHards/JPuhs-Sample
1、在项目中引入Jiguang.JPush nuget包
2、极光推送调用
namespace Jpush.Controllers
{
///
/// 极光推送管理
///
public class JPushManageController : Controller
{
private readonly JPushClientUtil _jPushClientUtil;
public JPushManageController(JPushClientUtil jPushClientUtil)
{
this._jPushClientUtil=jPushClientUtil;
}
///
/// 单个设备注册ID推送
///
/// (), true);
return Json(new { result = isOk });
}
///
/// 设备注册ID批量推送（一次推送最多1000个）
///
/// () { "1507bfd3f715abecfa455", "1507bfd3f715abecfa433", "1507bfd3f715abecfa422" };
var isOk = _jPushClientUtil.SendPushByRegistrationIdList("追逐时光者欢迎你！", "2022新年快乐", registrationIds, new Dictionary(), true);
return Json(new { result = isOk });
}
///
/// 广播推送
///
/// (), true);
return Json(new { result = isOk });
}
}
}
3、极光推送工具类（JPushClientUtil）
namespace Jpush.Common
{
///
/// 极光推送工具类
///
public class JPushClientUtil
{
private const string appKey = "youAppKey";
private const string masterSecret = "youMasterSecret";
private static JPushClient client = new JPushClient(appKey, masterSecret);
///
/// 单个设备注册ID推送
///
/// 推送标题（Android才会存在）
/// 通知内容
/// 设备注册ID(registration_id)
/// 拓展参数(传入App接收的一些参数标识)
/// 注意：iOS是否推送生产环境（true是，false否推开发环境）
/// extrasParam = null, bool isApnsProduction = true)
{
//设备标识参数拼接
var pushRegistrationId = new RegistrationIdList();
pushRegistrationId.registration_id.Add(registrationid);
return JPushBaseSendMessage(title, noticeContent, isApnsProduction, pushRegistrationId, extrasParam);
}
///
/// 设备注册ID批量推送（一次推送最多1000个）
///
/// 推送标题（Android才会存在）
/// 通知内容
/// 注册ID(registration_id)列表,一次推送最多1000个
/// 拓展参数(传入App接收的一些参数标识)
/// 注意：iOS是否推送生产环境（true是，false否推开发环境）
/// registrationIds, Dictionary extrasParam = null, bool isApnsProduction = true)
{
//设备标识参数拼接
var pushRegistrationId = new RegistrationIdList();
pushRegistrationId.registration_id.AddRange(registrationIds);
return JPushBaseSendMessage(title, noticeContent, isApnsProduction, pushRegistrationId, extrasParam);
}
///
/// 广播推送
///
/// 推送标题（Android才会存在）
/// 通知内容
/// 拓展参数(传入App接收的一些参数标识)
/// 注意：iOS是否推送生产环境（true是，false否推开发环境）
/// extrasParam = null, bool isApnsProduction = true)
{
return JPushBaseSendMessage(title, noticeContent, isApnsProduction, null, extrasParam, true);
}
///
/// 极光消息推送公共方法
///
/// 推送标题（Android才会存在）
/// 通知内容
/// 设备注册ID(registration_id)
/// iOS是否推送生产环境（true是，false否推开发环境）
/// 拓展参数
/// 是否广播
/// extrasParam, bool isRadioBroadcast = false)
{
try
{
object audience = pushRegistrationId;
if (isRadioBroadcast)
{
audience = "all";
}
var pushPayload = new PushPayload()
{
Platform = new List { "android", "ios" },//推送平台设置
Audience = audience,//推送目标
//notifacation：通知内容体。是被推送到客户端的内容。与 message 一起二者必须有其一，可以二者并存。
Notification = new Notification
{
Alert = noticeContent,//通知内容
Android = new Android
{
Alert = noticeContent,//通知内容
Title = title,//通知标题
URIActivity = "com.king.sysclearning.platform.app.JPushOpenClickActivity",//该字段用于指定开发者想要打开的 activity，值为 activity 节点的 “android:name”属性值;适配华为、小米、vivo厂商通道跳转
URIAction = "com.king.sysclearning.platform.app.JPushOpenClickActivity",//该字段用于指定开发者想要打开的 activity，值为 "activity"-"intent-filter"-"action" 节点的 "android:name" 属性值;适配 oppo、fcm跳转
Extras = extrasParam //这里自定义JSON格式的Key/Value信息，以供业务使用。
},
IOS = new IOS
{
Alert = noticeContent,
Badge = "+1",//此项是指定此推送的badge自动加1
Extras = extrasParam //这里自定义JSON格式的Key/Value信息，以供业务使用。
}
},
Options = new Options//可选参数
{
//iOS 环境不一致问题：API 推送消息给 iOS，需要设置 apns_production 指定推送的环境，false 为开发，true 为生产。
IsApnsProduction = isApnsProduction// 设置 iOS 推送生产环境。不设置默认为开发环境。
}
};
var response = client.SendPush(pushPayload);
//200一定是正确。所有异常都不使用 200 返回码
if (response.StatusCode == HttpStatusCode.OK)
{
return true;
}
else
{
return false;
}
}
catch (Exception ex)
{
return false;
}
}
}
public class RegistrationIdList
{
///
/// 设备注册ID
///
public List registration_id { get; set; } = new List();
}
}
参考文章
-
十分钟带你了解APP消息推送（Push）：https://www.woshipm.com/operate/526224.html
-
极光详细对接文档：https://docs.jiguang.cn/jpush/quickstart/3m_dem