English | 中文
目录
简介
Golang示例代码对华为推送服务(HUAWEI Push Kit)服务端接口进行封装,包含丰富的示例程序,方便您参考或直接使用。
示例代码主要包括以下组成:
| 包名 | 说明 |
|---|---|
| 示例代码包,每个包都可以独立运行 | |
| 发送网络请求的公共包 | |
| 推送服务的服务端接口封装包 |
安装
使用Golang示例代码前,请确认您已安装Golang开发环境(推荐使用Golang 1.11或以上版本),并解压Golang示例代码包。
将解压包中的org.huawei.com包复制到GOPATH指定的工程vendor目录下。刷新该工程,确保文件出现在对应的目录下。
配置
Golang示例代码以push包中的Client结构体为入口。Client结构体中的每个方法都可以调用推送服务服务端的一个接口。 Client结构体包含以下方法:
| 方法 | 说明 |
|---|---|
| SendMessage | 向设备发送消息 |
如需使用examples中的功能,请在公共包中的pushcommon.go中设置相关参数。
pushcommon.go中配置如下参数:
| 参数 | 说明 |
|---|---|
| appId | 应用ID,从应用消息中获取 |
| appSecret | 应用访问密钥,从应用信息中获取 |
| authUrl | 华为OAuth 2.0获取token的地址。具体请参考基于OAuth 2.0开放鉴权-客户端模式。 |
| pushUrl | 推送服务的访问地址。具体请参考推送服务-下行消息。 |
pushcommon.go中配置如下参数:
| 参数 | 说明 |
|---|---|
| TargetTopic | 订阅、退订或查询的主题名称 |
| TargetCondition | 消息的条件表达式组合 |
| TargetToken | 目标设备token,从目标设备上获取 |
| TargetTokenArray | 所有目标设备tokens,从目标设备上获取 |
示例代码
1). 发送Android透传消息。 通过push/model包中的NewTransparentMsgRequest方法获取初始化的透传消息的MessageRequest实例。
2). 发送Android通知栏消息。 通过push/model包中的NewNotificationMsgRequest方法获取初始化的透传消息的MessageRequest实例。
3). 基于主题发送消息。基于主题发送通知栏消息或透传消息。 获取MessageRequest实例后可定制主题。
4). 基于条件发送消息。 基于条件发送通知栏消息或透传消息。获取MessageRequest实例后可定制条件。
5). 向华为快应用发送消息。 通过设置FastAppTarget属性来实现。
6). 基于APNs代理发送消息。 通过设置消息的Apns属性来实现。
7). 基于WebPush代理发送消息。 通过设置消息的WebPush属性来实现。
8). 发送测试消息。
技术支持
如果您对HMS Core还处于评估阶段,可在Reddit社区获取关于HMS Core的最新讯息,并与其他开发者交流见解。
如果您对使用HMS示例代码有疑问,请尝试:
如果您在尝试示例代码中遇到问题,请向仓库提交issue,也欢迎您提交Pull Request。
授权许可
华为推送服务Golang示例代码经过Apache License, version 2.0授权许可。