RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/jpush/jpush-api-csharp-client/tree/v1 below:

GitHub - jpush/jpush-api-csharp-client at v1

JPush API client library for CSharp

目前推荐使用 Master 分支上的新版本库，支持 .NET Standard。该分支下的库（cn.jpush.api）今后将减少维护，一般只修复 bug。

这是 JPush REST API 的 C# 版本封装开发包，是由极光推送官方提供。

对应的 REST API 文档：http://docs.jiguang.cn/jpush/server/push/server_overview/

支持 Microsoft. NET Framework 4.0 （包括）以上版本。

在 jpush-api-csharp-client 项目根目录可以下载下面的两个文件。

在项目引用中添加依赖包： Newtonsoft.Json.dll
在项目引用中添加： cn.jpush.api.dll

在线方式配置：

在项目->引用->管理 NuGet 程序包中搜索 cn.jpush.api（如果已经安装了 Newtonsoft 需要先卸载一下）。
NuGet 包管理工具会下载 jpush-api-csharp-client 和 Newtonsoft 依赖。

向某单个设备或者某设备列表推送一条通知或者消息：

以下片断来自项目代码里的文件：cn.jpush.api.example 中的 JPushApiExample.cs。

PushPayload payload = PushObject_All_All_Alert();
try
{
    var result = client.SendPush(payload);
    System.Threading.Thread.Sleep(10000);
    var apiResult = client.getReceivedApi(result.msg_id.ToString());
    var apiResultv3 = client.getReceivedApi_v3(result.msg_id.ToString());
    var queryResultWithV2 = client.getReceivedApi("1739302794");
    var querResultWithV3 = client.getReceivedApi_v3("1739302794");
}
catch (APIRequestException e)
{
    Console.WriteLine("Error response from JPush server. Should review and fix it.");
    Console.WriteLine("HTTP Status: " + e.Status);
    Console.WriteLine("Error Code: " + e.ErrorCode);
    Console.WriteLine("Error Message: " + e.ErrorMessage);
}
catch (APIConnectionException e)
{
    Console.WriteLine(e.Message);
}

进行推送的关键在于构建一个 PushPayload 对象，以下展示了一些常见的用法：

快捷地构建推送对象：所有平台，所有设备，内容为 ALERT。

public static PushPayload PushObject_All_All_Alert()
{
    PushPayload pushPayload = new PushPayload();
    pushPayload.platform = Platform.all();
    pushPayload.audience = Audience.all();
    pushPayload.notification = new Notification().setAlert(ALERT);
    return pushPayload;
}

构建推送对象：所有平台，推送目标是别名为 "alias1"，通知内容为 ALERT。

public static PushPayload PushObject_all_alias_alert()
{
    PushPayload pushPayload_alias = new PushPayload();
    pushPayload_alias.platform = Platform.android();
    pushPayload_alias.audience = Audience.s_alias("alias1");
    pushPayload_alias.notification = new Notification().setAlert(ALERT);
    return pushPayload_alias;
}

构建推送对象：平台是 Android，目标是 tag 为 "tag1" 的设备，内容是 Android 通知内容为 ALERT，标题为 TITLE。

public static PushPayload PushObject_Android_Tag_AlertWithTitle()
{
    PushPayload pushPayload = new PushPayload();
    pushPayload.platform = Platform.android();
    pushPayload.audience = Audience.s_tag("tag1");
    pushPayload.notification =  Notification.android(ALERT,TITLE);
    return pushPayload;
}

构建推送对象：平台是 iOS，推送目标是"tag1","tag_all"的并集，推送内容同时包括通知与消息 - 通知信息是 ALERT，角标数字为 5，通知声音为 "happy"，并且附加字段 from = "JPush"；消息内容是 MSG_CONTENT。通知是 APNs 推送通道的，消息是 JPush 应用内消息通道的。APNs 的推送环境是“生产”（如果不显式设置的话，Library 会默认指定为开发）。

public static PushPayload PushObject_ios_tagAnd_alertWithExtrasAndMessage()
{
    PushPayload pushPayload = new PushPayload();
    pushPayload.platform = Platform.android_ios();
    pushPayload.audience = Audience.s_tag_and("tag1", "tag_all");
    var notification = new Notification();
    notification.IosNotification = new IosNotification().setAlert(ALERT)
                                                        .setBadge(5)
                                                        .setSound("happy")
                                                        .AddExtra("from","JPush";
    pushPayload.notification = notification;
    pushPayload.message = Message.content(MSG_CONTENT);
    return pushPayload;
}

构建推送对象：平台是 Android 与 iOS，推送目标是（"tag1"与"tag2"的交集）并（"alias1"与"alias2"的交集），推送内容为 MSG_CONTENT，并且附加字段 from = JPush。

public static PushPayload PushObject_ios_audienceMore_messageWithExtras()
{         
    var pushPayload = new PushPayload();
    pushPayload.platform = Platform.android_ios();
    pushPayload.audience = Audience.s_tag("tag1","tag2");
    pushPayload.message = Message.content(MSG_CONTENT).AddExtras("from", "JPush");
    return pushPayload;
}

构建推送对象：推送内容包含 SMS 信息。

public static PushPayload PushSendSmsMessage()
{
    var pushPayload = new PushPayload();
    pushPayload.platform = Platform.all();
    pushPayload.audience = Audience.all();
    pushPayload.notification = new Notification().setAlert(ALERT);
    SmsMessage sms_message = new SmsMessage();
    sms_message.setContent(SMSMESSAGE);
    sms_message.setDelayTime(DELAY_TIME);
    pushPayload.sms_message = sms_message;
    return pushPayload;
}

JPush Report API V3 提供各类统计数据查询功能。

以下片断来自项目代码里的文件：cn.jpush.api.examples 中的 ReportsExample.cs。

try
{
    var result = jpushClient.getReceivedApi("1942377665");
    Console.WriteLine("Got result - " + result.ToString());
}
catch (APIRequestException e)
{
    Console.WriteLine("Error response from JPush server. Should review and fix it.");
    Console.WriteLine("HTTP Status: " + e.Status);
    Console.WriteLine("Error Code: " + e.ErrorCode);
    Console.WriteLine("Error Message: " + e.ErrorMessage);
}
catch (APIConnectionException e)
{
    Console.WriteLine(e.Message);
}

Device API 用于在服务器端查询、设置、更新、删除设备的 tag, alias 信息，使用时需要注意不要让服务端设置的标签又被客户端给覆盖了。

以下片断来自项目代码里的文件：cn.jpush.api.examples 中的 DeviceApiExample.cs。

try
{
    var result = client.updateDevice(REGISTRATION_ID, ALIAS, MOBILE,
        TAG_HASHSET, TAG_HASHSET_REMOVE);
    System.Threading.Thread.Sleep(10000);
    Console.WriteLine(result);
}
catch (APIRequestException e)
{
    Console.WriteLine("Error response from JPush server. Should review and fix it.");
    Console.WriteLine("HTTP Status: " + e.Status);
    Console.WriteLine("Error Code: " + e.ErrorCode);
    Console.WriteLine("Error Message: " + e.ErrorMessage);
}
catch (APIConnectionException e)
{
    Console.WriteLine(e.Message);
}

API 层面支持定时功能。

以下片断来自项目代码里的文件：cn.jpush.api.examples 中的 ScheduleApiExample.cs。

TriggerPayload triggerConstructor = new TriggerPayload(START, END,
    TIME_PERIODICAL, TIME_UNIT, FREQUENCY, POINT);
SchedulePayload schedulepayloadperiodical = new SchedulePayload(NAME,
    ENABLED, triggerConstructor, pushPayload);
try
{
    var result = scheduleclient.sendSchedule(schedulepayloadperiodical);
    System.Threading.Thread.Sleep(10000);
    Console.WriteLine(result);
    schedule_id = result.schedule_id;
}
catch (APIRequestException e)
{
    Console.WriteLine("Error response from JPush server. Should review and fix it.");
    Console.WriteLine("HTTP Status: " + e.Status);
    Console.WriteLine("Error Code: " + e.ErrorCode);
    Console.WriteLine("Error Message: " + e.ErrorMessage);
}
catch (APIConnectionException e)
{
    Console.WriteLine(e.Message);
}

APIRequestException
- 请求错误，提供 http 错误码等信息。
APIConnectionException
- 诸如超时、无网络等情况。

Please contribute! Look at the issues.

MIT © JiGuang

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4