mirror of
https://github.com/jpush/jpush-phonegap-plugin.git
synced 2025-01-19 22:55:02 +08:00
对某些方法添加更加详细的说明
eg.setBasicPushNotificationBuilder, setCustomPushNotificationBuilder
This commit is contained in:
parent
8241b364cc
commit
d1e4f70188
@ -199,14 +199,18 @@
|
|||||||
### API - setBasicPushNotificationBuilder, setCustomPushNotificationBuilder
|
### API - setBasicPushNotificationBuilder, setCustomPushNotificationBuilder
|
||||||
|
|
||||||
当用户需要定制默认的通知栏样式时,则可调用此方法。
|
当用户需要定制默认的通知栏样式时,则可调用此方法。
|
||||||
|
需要用户去自定义 ../JPushPlugin.java 中的同名方法代码,然后再在 js 端 调用该方法。
|
||||||
|
|
||||||
|
具体用法可参考[官方文档](http://docs.jpush.io/client/android_tutorials/#_11)。
|
||||||
|
|
||||||
JPush SDK 提供了 2 个用于定制通知栏样式的构建类:
|
JPush SDK 提供了 2 个用于定制通知栏样式的构建类:
|
||||||
|
|
||||||
- setBasicPushNotificationBuilder
|
- setBasicPushNotificationBuilder:
|
||||||
- Basic 用于定制 Android Notification 里的 defaults / flags / icon 等基础样式(行为)。
|
Basic 用于定制 Android Notification 里的 defaults / flags / icon 等基础样式(行为)。
|
||||||
- setCustomPushNotificationBuilder
|
- setCustomPushNotificationBuilder:
|
||||||
- 继承 Basic 进一步让开发者定制 Notification Layout。
|
继承 Basic 进一步让开发者定制 Notification Layout。
|
||||||
|
|
||||||
如果不调用此方法定制,则极光 Push SDK 默认的通知栏样式是:Android 标准的通知栏提示。
|
如果不调用此方法定制,则极光 Push SDK 默认的通知栏样式是 Android 标准的通知栏。
|
||||||
|
|
||||||
#### 接口定义
|
#### 接口定义
|
||||||
|
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
- [停止与恢复推送服务](#停止与恢复推送服务)
|
- [停止与恢复推送服务](#停止与恢复推送服务)
|
||||||
- [获取 RegistrationID](#获取-registrationid)
|
- [获取 RegistrationID](#获取-registrationid)
|
||||||
- [别名与标签 API](#别名与标签-api)
|
- [设置别名与标签](#设置别名与标签)
|
||||||
- [获取点击通知内容](#获取点击通知内容)
|
- [获取点击通知内容](#获取点击通知内容)
|
||||||
- [获取通知内容](#获取通知内容)
|
- [获取通知内容](#获取通知内容)
|
||||||
- [获取自定义消息推送内容](#获取自定义消息推送内容)
|
- [获取自定义消息推送内容](#获取自定义消息推送内容)
|
||||||
@ -11,12 +11,11 @@
|
|||||||
## 停止与恢复推送服务
|
## 停止与恢复推送服务
|
||||||
### API - init
|
### API - init
|
||||||
|
|
||||||
调用此 API,用来开启
|
调用此 API,用来开启 JPush SDK 提供的推送服务。
|
||||||
JPush SDK 提供的推送服务。
|
|
||||||
|
|
||||||
开发者 App 可以通过调用停止推送服务 API 来停止极光推送服务。当又需要使用极光推送服务时,则必须要调用恢复推送服务 API。
|
开发者 App 可以通过调用停止推送服务 API 来停止极光推送服务。当又需要使用极光推送服务时,则必须要调用恢复推送服务 API。
|
||||||
|
|
||||||
本功能是一个完全本地的状态操作。也就是说:停止推送服务的状态不会保存到服务器上。
|
本功能是一个完全本地的状态操作,也就是说:停止推送服务的状态不会保存到服务器上。
|
||||||
|
|
||||||
如果停止推送服务后,开发者 App 被重新安装,或者被清除数据,
|
如果停止推送服务后,开发者 App 被重新安装,或者被清除数据,
|
||||||
JPush SDK 会恢复正常的默认行为。(因为保存在本地的状态数据被清除掉了)。
|
JPush SDK 会恢复正常的默认行为。(因为保存在本地的状态数据被清除掉了)。
|
||||||
@ -127,7 +126,7 @@ JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
## 别名与标签 API
|
## 设置别名与标签
|
||||||
|
|
||||||
### API - setTagsWithAlias, setTags, setAlias
|
### API - setTagsWithAlias, setTags, setAlias
|
||||||
|
|
||||||
@ -205,8 +204,8 @@ JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。
|
|||||||
|6003|alias 字符串不合法。 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
|
|6003|alias 字符串不合法。 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
|
||||||
|6004|alias超长。 |最多 40个字节,中文 UTF-8 是 3 个字节。|
|
|6004|alias超长。 |最多 40个字节,中文 UTF-8 是 3 个字节。|
|
||||||
|6005|某一个 tag 字符串不合法。 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
|
|6005|某一个 tag 字符串不合法。 |有效的别名、标签组成:字母(区分大小写)、数字、下划线、汉字。|
|
||||||
|6006|某一个 tag 超长。 |一个 tag 最多 40个字节 中文 UTF-8 是 3 个字节。|
|
|6006|某一个 tag 超长。 |一个 tag 最多 40个字节,中文 UTF-8 是 3 个字节。|
|
||||||
|6007|tags 数量超出限制,最多 100 个。 |这是一台设备的限制。一个应用全局的标签数量无限制。|
|
|6007|tags 数量超出限制,最多 100 个。 |这是一台设备的限制,一个应用全局的标签数量无限制。|
|
||||||
|6008|tag / alias 超出总长度限制。 |总长度最多 1K 字节。|
|
|6008|tag / alias 超出总长度限制。 |总长度最多 1K 字节。|
|
||||||
|6011|10s内设置 tag 或 alias 大于 3 次。 |短时间内操作过于频繁。|
|
|6011|10s内设置 tag 或 alias 大于 3 次。 |短时间内操作过于频繁。|
|
||||||
|
|
||||||
@ -269,7 +268,7 @@ ps:点击通知后传递的 json object 保存在 window.plugins.jPushPlugin.o
|
|||||||
|
|
||||||
### event - jpush.receiveNotification
|
### event - jpush.receiveNotification
|
||||||
|
|
||||||
点击通知进入应用程序时会触发该事件。
|
收到通知时会触发该事件。
|
||||||
|
|
||||||
#### 代码示例
|
#### 代码示例
|
||||||
|
|
||||||
@ -324,7 +323,9 @@ ps:点击通知后传递的 json object 保存在 window.plugins.jPushPlugin.r
|
|||||||
|
|
||||||
### event - jpush.receiveMessage
|
### event - jpush.receiveMessage
|
||||||
|
|
||||||
收到应用内消息时触发这个事件,推荐使用事件的方式传递,但同时保留了 receiveMessageIniOSCallback 的回调函数,兼容以前的代码。
|
收到自定义消息时触发这个事件,推荐使用事件的方式传递。
|
||||||
|
|
||||||
|
但同时保留了 receiveMessageIniOSCallback 的回调函数,兼容以前的代码。
|
||||||
|
|
||||||
#### 代码示例
|
#### 代码示例
|
||||||
|
|
||||||
@ -343,7 +344,6 @@ ps:点击通知后传递的 json object 保存在 window.plugins.jPushPlugin.r
|
|||||||
message = event.content;
|
message = event.content;
|
||||||
}
|
}
|
||||||
$("#messageResult").html(message);
|
$("#messageResult").html(message);
|
||||||
|
|
||||||
} catch(exception) {
|
} catch(exception) {
|
||||||
console.log("JPushPlugin:onReceiveMessage-->" + exception);
|
console.log("JPushPlugin:onReceiveMessage-->" + exception);
|
||||||
}
|
}
|
||||||
|
Loading…
Reference in New Issue
Block a user