对某些方法添加更加详细的说明

eg.setBasicPushNotificationBuilder, setCustomPushNotificationBuilder
This commit is contained in:
Hevin 2016-04-22 13:16:17 +08:00
parent 8241b364cc
commit d1e4f70188
2 changed files with 28 additions and 24 deletions

View File

@ -199,14 +199,18 @@
### API - setBasicPushNotificationBuilder, setCustomPushNotificationBuilder
当用户需要定制默认的通知栏样式时,则可调用此方法。
需要用户去自定义 ../JPushPlugin.java 中的同名方法代码,然后再在 js 端 调用该方法。
具体用法可参考[官方文档](http://docs.jpush.io/client/android_tutorials/#_11)。
JPush SDK 提供了 2 个用于定制通知栏样式的构建类:
- setBasicPushNotificationBuilder
- Basic 用于定制 Android Notification 里的 defaults / flags / icon 等基础样式(行为)。
- setCustomPushNotificationBuilder
- 继承 Basic 进一步让开发者定制 Notification Layout。
- setBasicPushNotificationBuilder:
Basic 用于定制 Android Notification 里的 defaults / flags / icon 等基础样式(行为)。
- setCustomPushNotificationBuilder:
继承 Basic 进一步让开发者定制 Notification Layout。
如果不调用此方法定制,则极光 Push SDK 默认的通知栏样式是Android 标准的通知栏提示
如果不调用此方法定制,则极光 Push SDK 默认的通知栏样式是 Android 标准的通知栏
#### 接口定义

View File

@ -2,7 +2,7 @@
- [停止与恢复推送服务](#停止与恢复推送服务)
- [获取 RegistrationID](#获取-registrationid)
- [别名与标签 API](#别名与标签-api)
- [设置别名与标签](#设置别名与标签)
- [获取点击通知内容](#获取点击通知内容)
- [获取通知内容](#获取通知内容)
- [获取自定义消息推送内容](#获取自定义消息推送内容)
@ -11,12 +11,11 @@
## 停止与恢复推送服务
### API - init
调用此 API,用来开启
JPush SDK 提供的推送服务。
调用此 API用来开启 JPush SDK 提供的推送服务。
开发者 App 可以通过调用停止推送服务 API 来停止极光推送服务。当又需要使用极光推送服务时,则必须要调用恢复推送服务 API。
本功能是一个完全本地的状态操作也就是说:停止推送服务的状态不会保存到服务器上。
本功能是一个完全本地的状态操作也就是说:停止推送服务的状态不会保存到服务器上。
如果停止推送服务后,开发者 App 被重新安装,或者被清除数据,
JPush SDK 会恢复正常的默认行为。(因为保存在本地的状态数据被清除掉了)。
@ -127,7 +126,7 @@ JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。
}
}
## 别名与标签 API
## 设置别名与标签
### API - setTagsWithAlias, setTags, setAlias
@ -205,8 +204,8 @@ JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。
|6003|alias 字符串不合法。 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
|6004|alias超长。 |最多 40个字节中文 UTF-8 是 3 个字节。|
|6005|某一个 tag 字符串不合法。 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
|6006|某一个 tag 超长。 |一个 tag 最多 40个字节 中文 UTF-8 是 3 个字节。|
|6007|tags 数量超出限制,最多 100 个。 |这是一台设备的限制一个应用全局的标签数量无限制。|
|6006|某一个 tag 超长。 |一个 tag 最多 40个字节中文 UTF-8 是 3 个字节。|
|6007|tags 数量超出限制,最多 100 个。 |这是一台设备的限制一个应用全局的标签数量无限制。|
|6008|tag / alias 超出总长度限制。 |总长度最多 1K 字节。|
|6011|10s内设置 tag 或 alias 大于 3 次。 |短时间内操作过于频繁。|
@ -269,7 +268,7 @@ ps点击通知后传递的 json object 保存在 window.plugins.jPushPlugin.o
### event - jpush.receiveNotification
点击通知进入应用程序时会触发该事件。
收到通知时会触发该事件。
#### 代码示例
@ -324,7 +323,9 @@ ps点击通知后传递的 json object 保存在 window.plugins.jPushPlugin.r
### event - jpush.receiveMessage
收到应用内消息时触发这个事件,推荐使用事件的方式传递,但同时保留了 receiveMessageIniOSCallback 的回调函数,兼容以前的代码。
收到自定义消息时触发这个事件,推荐使用事件的方式传递。
但同时保留了 receiveMessageIniOSCallback 的回调函数,兼容以前的代码。
#### 代码示例
@ -343,7 +344,6 @@ ps点击通知后传递的 json object 保存在 window.plugins.jPushPlugin.r
message = event.content;
}
$("#messageResult").html(message);
} catch(exception) {
console.log("JPushPlugin:onReceiveMessage-->" + exception);
}