a Node.JS wrapper library-port for Google Cloud Messaging for Android
node-gcm is a Node.JS library for Google Cloud Messaging for Android, which replaces Cloud 2 Device Messaging (C2DM).
$ npm install node-gcm
An Android device running 2.2 or newer and an API key as per GCM getting started guide.
var gcm = require'node-gcm';// Create a message// ... with default valuesvar message = ;// ... or some given valuesvar message =collapseKey: 'demo'delayWhileIdle: truetimeToLive: 3data:key1: 'message1'key2: 'message2';// Change the message data// ... as key-valuemessageaddData'key1''message1';messageaddData'key2''message2';// ... or as a data object (overwrites previous data object)messageaddDatakey1: 'message1'key2: 'message2';// Change the message variablesmessagecollapseKey = 'demo';messagedelayWhileIdle = true;messagetimeToLive = 3;messagedryRun = true;// Set up the sender with you API keyvar sender = 'insert Google Server API Key here';// Add the registration IDs of the devices you want to send tovar registrationIds = ;registrationIdspush'regId1';registrationIdspush'regId2';// Send the message// ... trying only oncesendersendNoRetrymessage registrationIdsiferr console.errorerr;else console.logresult;;// ... or retryingsendersendmessage registrationIdsiferr console.errorerr;else console.logresult;;// ... or retrying a specific number of times (10)sendersendmessage registrationIds 10iferr console.errorerr;else console.logresult;;
Notice that you can at most send notifications to 1000 registration ids at a time. This is due to a restriction on the side of the GCM API.
To enable debug mode (print requests and responses to and from GCM),
DEBUG environment flag when running your app (assuming you use
node app.js to run your app):
DEBUG=node-gcm node app.js
Do you see an issue in the code that is not represented by the issues, please do create it.
If you want to help solve an issue, please submit a Pull Request (PR). If the PR aims to solve a known issue, please refer this issue in your description. Make sure that your PR explains what problem it solves, and any key decisions made in regards to this. Make the PR early so maintainers and other contributors get a chance to give input on your code and how it fits in the bigger picture.
Any help is much appreciated!
(The MIT License)
Copyright (c) 2013 Marcus Farkas <firstname.lastname@example.org>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Sender#send, so it returns the correct result ordered as expected, even after retrying. The initial backoff time can now be specified, by passing an options object to the function.
Sender#sendNoRetryto allow passing a single Registration ID without wrapping it in an array.
Message#addDatais now multi-purpose (works as either
Sender#sendhave a default of 5 retries (if none provided)
Sender#sendNoRetryare now optional