简介
findhit-onesignal-cordova-plugin 是一个 Cordova 插件，提供了与 OneSignal 服务器的通信功能，通过插件可以让 Cordova 应用实现推送通知功能。
安装
使用以下命令可以安装 findhit-onesignal-cordova-plugin:
cordova plugin add findhit-onesignal-cordova-plugin --save
配置
安装插件后，需要在项目的 config.xml 文件中添加下面的配置项:
-- -------------------- ---- ------- --------- --------------- ------------ ------------------- -------------------------------- ------- ------------------------------------------------------ ------- ------------------------------------------------------ -------------- ----------- ---------------------------- ---------- -- ----------- ------------------------------- ---------- -- ----------- --------- ----------- ------------ ---------------- ----------- ------ --- --- -------------- ---------------------- --------------------------------------- -------------- ------------ ---------------- --------------- -------------- ---------------------- ------------------------ -------------- ----------- --------------------- ----------- -- ----------- --------------------------------------------- ----------- -- -----------
其中，YOUR_ONESIGNAL_APP_ID 需要替换成自己在 OneSignal 上创建应用后获得的那个唯一的应用标识符。
使用
初始化
在应用启动时，需要调用 OneSignal.setAppId() 方法设置应用的 OneSignal App Id:
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
window.plugins.OneSignal.setAppId("YOUR_ONESIGNAL_APP_ID");
}接收通知
可以通过监听 OneSignal.NotificationReceived 事件来获取收到的通知:
document.addEventListener("OneSignal.NotificationReceived", onNotificationReceived, false);
function onNotificationReceived(notification) {
console.log("Received notification:", notification);
}发送标签
可以使用 OneSignal.sendTag() 方法将标签附加到 OneSignal 设备记录:
window.plugins.OneSignal.sendTag("key", "value");发送通知
可以使用 OneSignal.postNotification() 方法发送推送通知:
-- -------------------- ---- -------
-------------------------------------------
--------- -
--- -------- ---------
--- -------- --------
--
------------------- -------------- --------------
----- - ------- ------ -
--
--------------------------
-------------------------其中，contents 属性是通知内容，include_player_ids 属性是收件人的 OneSignal 设备记录的ID，data 属性是自定义数据，onNotificationSentSuccess 和 onNotificationSentError 是成功和失败的回调函数。
获取用户标识
可以使用 OneSignal.getIds() 方法获取 OneSignal 的用户标识:
window.plugins.OneSignal.getIds(function(ids) {
console.log("Player ID: " + ids.userId);
});总结
findhit-onesignal-cordova-plugin 提供了集成 OneSignal 中间件到 Cordova 应用的功能，借助其，可以轻松实现对 Cordova 应用的推送通知。本文介绍了该插件的安装、配置和使用方法，希望能对读者有所帮助。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600554c481e8991b448d1f8b