Cordova TCP Socket Plugin
Follows the Cordova Plugin spec, so that it works with Plugman
This plugin was tested and qualified using Cordova 3.4 adn Cordova 3.5. The demo app contains implementation for Android, iOS and Windows 8. You can check that out at demo app repository
To add the plugin, just run the following command through cordova CLI:
cordova plugin add com.tlantic.plugins.socket
The plugin creates a "Socket" object exposed on window.tlantic.plugins.socket. The following methods can be accessed:
- connect: opens a socket connection;
- disconnect: closes a socket connection;
- disconnectAll: closes ALL opened connections;
- send: send text data using a given connection;
- sendBinary: send binary data using a given connection;
- isConnected: returns a boolean falg representing socket connectivity status;
- receive: callback used by plugin's native code. Can be override by a custom implementation.
Since v0.3 version, the plugin started to return a connection id after calling connect method. This is must be used for all operationg regarding the given connection, like disconnect, send and isConnected.
The current implementation defines the connection id as ":", but is strongly recommended for your app: DO NOT PARSE THIS! Thist conenction id was designes to avoid having your app informing the host and port all the time. So, is not safe assume all versions of this plugin will keep this format. We are free to change it in the future as needed (if finding a better option). Keep that in mind...
Example:
window.tlantic.plugins.socket.connect(
function (connectionId) {
console.log('worked! This is the connection ID: ', connectionId);
},
function () {
console.log('failed!');
},
'192.168.2.5',
18002
);
Disconnects any connection opened for a given connection.
Example:
window.tlantic.plugins.socket.disconnect(
function () {
console.log('worked!');
},
function () {
console.log('failed!');
},
'192.168.2.5:18002'
);
Example:
window.tlantic.plugins.socket.connect(
function () {
console.log('worked!');
},
function () {
console.log('failed!');
}
);
Sends text information and calls success callback if information was sent and does not wait for any response. To check how to receive data, please see the item below.
Example:
window.tlantic.plugins.socket.send(
function () {
console.log('worked!');
},
function () {
console.log('failed!');
},
'192.168.2.5:18002',
'This is the data i want to send!'
);
Sends binary data and calls success callback if information was sent and does not wait for any response. To check how to receive data, please see the item below.
Binary data to be sent is passed in data which is a JSONArray, one integer element per byte.
Example:
window.tlantic.plugins.socket.sendBinary(
function () {
console.log('worked!');
},
function () {
console.log('failed!');
},
'192.168.2.5:18002',
[ 0x00, 0x01, 0x00, 0xFD ]
);
Returns a boolean value representing the connection status. True, if socket streams are opened and false case else. Both values are supposed to be returned through successCallback. The error callback is called only when facing errors due the check process.
Example:
window.tlantic.plugins.socket.isConnected(
'192.168.2.5:18002',
function () {
console.log('worked!');
},
function () {
console.log('failed!');
}
);
This method is a callback invoked by native code through webview capabilities. You can replace this method by your own implementation. Even this way, the default implementation dispatches a JS event which can be catched listening that event. Here it goes a proper implementation regarding default method behavior:
document.addEventListener(window.tlantic.plugins.socket.receiveHookName, function (ev) {
console.log(ev.metadata.connection.host); // host who sent the data
console.log(ev.metadata.connection.port); // sender port
console.log(ev.metadata.connection.id); // connection id
console.log(ev.metadata.data); // received data as a byte array
});
Cordova TCP Socket Plugin
Copyright (C) 2014 Tlantic SI
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>