/hms-push-serverdemo-csharp

C# sample code encapsulates APIs of the HUAWEI Push Kit server. It provides many sample programs for your reference or usage.

Primary LanguageC#Apache License 2.0Apache-2.0

HMS Core Push Kit Sample Code (C#)

English | 中文

Contents

Introduction

The sample code for C# encapsulates the server-side APIs of Push Kit, for your reference or direct use.

The following table describes folders of C# sample code.

Folder Description
AGConnectAdmin Class library where Push Kit server APIs are encapsulated.
AGConnectAdmin.Examples Class library usage examples.

The following table describes main classes used in the sample code.

Class Name Description
AppOptions App-related configuration.
ApiVersion Push Kit API version.
AGConnectApp App.
AGConnectMessaging Push Kit API calling methods.
Message Message body.

Installation

  1. Decompress the sample code.
  2. Copy AGConnectAdmin to a proper position in your Visual Studio solution and reference the corresponding assembly in your project.
  3. Use the classes in AGConnectAdmin by referring to the sample code.

Configuration

The following table describes the parameters related to the AppOptions class.

Parameter Description
ProjectId Project ID, which is obtained from the project information.
ClientId App ID, which is obtained from the app information.
ClientSecret App secret, which is obtained from the app information.
LoginUri URL for Huawei OAuth 2.0 to obtain a token. For details, please refer to OAuth 2.0-based Authentication.
ApiVersion Push Kit API version. For details, please refer to Sending Downlink Messages.

Environment Requirements

The demo projects need to be opened using Visual Studio 2017 or a later version. The following framework versions are supported:

  • .NET Framework 4.5 or later
  • .NET Standard 2.0 or later

Sample Code

AGConnectAdmin.Examples provides all sample code and corresponding functions.

  1. Send an Android data message. Code location: SendDataMessage.cs

  2. Send an Android notification message. Code location: SendAndroidMessage.cs

  3. Send a message by topic.Code location: SendTopicMessage.cs

  4. Send a message by conditions. Code location: SendConditionMessage.cs

  5. Send a message to a Huawei quick app. Code location: SendInstanceAppMessage.cs

  6. Send a message through the WebPush agent. Code location: SendWebpushMessage.cs

  7. Send a message through the APNs agent. Code location: SendApnsMessage.cs

  8. Send a test message. Code location: SendTestMessage.cs

Technical Support

You can visit the Reddit community to obtain the latest information about HMS Core and communicate with other developers.

If you have any questions about the sample code, try the following:

  • Visit Stack Overflow, submit your questions, and tag them with huawei-mobile-services. Huawei experts will answer your questions.
  • Visit the HMS Core section in the HUAWEI Developer Forum and communicate with other developers.

If you encounter any issues when using the sample code, submit your issues or submit a pull request.

License

The sample code is licensed under Apache License 2.0.