Merge branch 'v2-dev'

Author: Hevin

Jiguang.JPush.dll

@@ -11,7 +11,7 @@
     <Product>JPush</Product>
     <Copyright>MIT</Copyright>
     <PackageLicenseUrl></PackageLicenseUrl>
-    <Version>1.0.10</Version>
+    <Version>1.0.11</Version>
   </PropertyGroup>
 
   <ItemGroup>

Jiguang.JPush/Jiguang.JPush.csproj

@@ -1,5 +1,4 @@
 using Newtonsoft.Json;
-using System.ComponentModel;
 
 namespace Jiguang.JPush.Model
 {
@@ -8,12 +7,24 @@ namespace Jiguang.JPush.Model
     /// </summary>
     public class Options
     {
+        /// <summary>
+        /// 推送序号。
+        /// <para>用来作为 API 调用标识，API 返回时被原样返回，以方便 API 调用方匹配请求与返回。不能为 0。</para>
+        /// </summary>
         [JsonProperty("sendno", NullValueHandling = NullValueHandling.Ignore)]
         public int? SendNo { get; set; }
 
+        /// <summary>
+        /// 离线消息保留时长(秒)。
+        /// <para>推送当前用户不在线时，为该用户保留多长时间的离线消息，以便其上线时再次推送。默认 86400 （1 天），最长 10 天。设置为 0 表示不保留离线消息，只有推送当前在线的用户可以收到。</para>
+        /// </summary>
         [JsonProperty("time_to_live", NullValueHandling = NullValueHandling.Ignore)]
         public int? TimeToLive { get; set; }
 
+        /// <summary>
+        /// 要覆盖的消息 ID。
+        /// <para>如果当前的推送要覆盖之前的一条推送，这里填写前一条推送的 msg_id 就会产生覆盖效果。覆盖功能起作用的时限是：1 天。</para>
+        /// </summary>
         [JsonProperty("override_msg_id", NullValueHandling = NullValueHandling.Ignore)]
         public long? OverrideMessageId { get; set; }
 
@@ -31,6 +42,10 @@ public class Options
         [JsonProperty("apns_collapse_id", NullValueHandling = NullValueHandling.Ignore)]
         public string ApnsCollapseId { get; set; }
 
+        /// <summary>
+        /// 定速推送时长（分钟）。
+        /// 又名缓慢推送。把原本尽可能快的推送速度，降低下来，给定的 n 分钟内，均匀地向这次推送的目标用户推送。最大值为 1400，未设置则不是定速推送。
+        /// </summary>
         [JsonProperty("big_push_duration", NullValueHandling = NullValueHandling.Ignore)]
         public int? BigPushDuration { get; set; }
     }

Jiguang.JPush/Model/Options.cs

@@ -1,6 +1,6 @@
 # JPush Library for .NET
 
-[![NuGet](https://img.shields.io/badge/NuGet-v1.0.10-blue.svg)](https://preview.nuget.org/packages/Jiguang.JPush/)
+[![NuGet](https://img.shields.io/badge/NuGet-v1.0.11-blue.svg)](https://preview.nuget.org/packages/Jiguang.JPush/)
 
 由[极光](https://www.jiguang.cn/)官方支持的 JPush .NET API Client。