npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

bluetooth-network

v1.0.15

Published

Esta é uma versao adaptada da cordova-plugin-networking-bluetooth

Downloads

4

Readme

cordova-plugin-networking-bluetooth

This plugin provides Bluetooth RFCOMM connectivity for peer to peer networking between Android devices, with an API inspired by Mobile Chrome Apps Bluetooth Socket.

For an explaination of the rationale behind this plugin, see this blog post.

Installation

cordova plugin add bluetooth-network

Supported Platforms

  • Android

Namespace and API

All the functions and events described in this plugin reside in the networking.bluetooth namespace.

All the functions are asynchronous and have 2 callbacks as their last 2 parameters, the first being the success callback, and the second being the error callback.

All the events have the following methods:

Event.addListener(function callback)
Event.removeListener(function callback)
boolean Event.hasListener(function callback)
boolean Event.hasListeners()

Adapter information

To obtain the state of the Bluetooth adapter, use the getAdapterState method:

networking.bluetooth.getAdapterState(function (adapterInfo) {
    // The adapterInfo object has the following properties:
    // address: String --> The address of the adapter, in the format 'XX:XX:XX:XX:XX:XX'.
    // name: String --> The human-readable name of the adapter.
    // enabled: Boolean --> Indicates whether or not the adapter is enabled.
    // discovering: Boolean --> Indicates whether or not the adapter is currently discovering.
    // discoverable: Boolean --> Indicates whether or not the adapter is currently discoverable.
    console.log('Adapter ' + adapterInfo.address + ': ' + adapterInfo.name);
}, function (errorMessage) {
    console.error(errorMessage);
});

The onAdapterStateChanged event is sent whenever the adapter state changes. This can be used, for example, to determine when the adapter is enabled or disabled.

var enabled = false;
networking.bluetooth.getAdapterState(function (adapterInfo) {
    enabled = adapterInfo.enabled;
});

networking.bluetooth.onAdapterStateChanged.addListener(function (adapterInfo) {
    // The adapterInfo object has the same properties as getAdapterState
    if (adapterInfo.enabled !== enabled) {
        enabled = adapterInfo.enabled;
        if (enabled) {
            console.log('Adapter is enabled');
        } else {
            console.log('Adapter is disabled');
        }
    }
});

To enable the adapter, either the requestEnable or the enable functions can be used, the difference being that the requestEnable function is recommended, as it nicely prompts the user before enabling the adapter.

To disable the adapter, use the disable function.

networking.bluetooth.requestEnable(function () {
    // The adapter is now enabled
}, function () {
    // The user has cancelled the operation
});

Device information and discovery

To get a list of the devices known to the Bluetooth adapter, use the getDevices method:

networking.bluetooth.getDevices(function (devices) {
    for (var i = 0; i < devices.length; i++) {
        // The deviceInfo object has the following properties:
        // address: String --> The address of the device, in the format 'XX:XX:XX:XX:XX:XX'.
        // name: String --> The human-readable name of the device.
        // paired: Boolean --> Indicates whether or not the device is paired with the system.
        // uuids: Array of String --> UUIDs of protocols, profiles and services advertised by the device.
        console.log(devices[i].address);
    }
});

To begin discovery of nearby devices, use the startDiscovery method. Discovery can be resource intensive so you should call stopDiscovery when done.

You should call startDiscovery whenever your app needs to discover nearby devices. Do not make the call conditional on the discovering property of the adapterInfo.

Information about each newly discovered device is received using the onDeviceAdded event.

Example:

var device_names = {};
var updateDeviceName = function (device) {
    device_names[device.address] = device.name;
};

// Add listener to receive newly found devices
networking.bluetooth.onDeviceAdded.addListener(updateDeviceName);

// With the listener in place, get the list of known devices
networking.bluetooth.getDevices(function (devices) {
    for (var i = 0; i < devices.length; i++) {
        updateDeviceName(devices[i]);
    }
});

// Now begin the discovery process.
networking.bluetooth.startDiscovery(function () {
    // Stop discovery after 30 seconds.
    setTimeout(function () {
        networking.bluetooth.stopDiscovery();
    }, 30000);
});

To make the device discoverable, use the requestDiscoverable function, that will prompt the user to make the device discoverable for a limited amount of time (120 seconds on Android).

networking.bluetooth.requestDiscoverable(function () {
    // The device is now discoverable
}, function () {
    // The user has cancelled the operation
});

Connecting to a socket

In order to make a connection to a device you need two things. The address of the device you wish to connect to, and the UUID of the service itself.

Example:

var uuid = '94f39d29-7d6d-437d-973b-fba39e49d4ee';

networking.bluetooth.connect(device.address, uuid, function (socketId) {
    // Profile implementation here.
}, function (errorMessage) {
    console.log('Connection failed: ' + errorMessage);
});

Keep a handle to the socketId so that you can later send data to this socket.

Receiving from and sending to a socket

Receiving data from and sending to a socket uses ArrayBuffer objects.

To send data you have in arrayBuffer use send:

networking.bluetooth.send(socketId, arrayBuffer, function(bytes_sent) {
    console.log('Sent ' + bytes_sent + ' bytes');
}, function (errorMessage) {
    console.log('Send failed: ' + errorMessage);
});

In contrast to the method to send data, data is received in an event (onReceive).

networking.bluetooth.onReceive.addListener(function (receiveInfo) {
    if (receiveInfo.socketId !== socketId) {
        return;
    }

    // receiveInfo.data is an ArrayBuffer.
});

Receiving socket errors and disconnection

To be notified of socket errors, including disconnection, add a listener to the onReceiveError event.

networking.bluetooth.onReceiveError.addListener(function (errorInfo) {
    if (errorInfo.socketId !== socketId) {
        return;
    }

    // Cause is in errorInfo.errorMessage.
    console.log(errorInfo.errorMessage);
});

Disconnecting from a socket

To hang up the connection and disconnect the socket use close.

networking.bluetooth.close(socketId);

Listening on a socket

var uuid = '94f39d29-7d6d-437d-973b-fba39e49d4ee';
networking.bluetooth.listenUsingRfcomm(uuid, function (serverSocketId) {
    // Keep a handle to the serverSocketId so that you can later accept connections (onAccept) from this socket.
}, function (errorMessage) {
    console.error(errorMessage);
});

Accepting client connections

Client connections are accepted and passed to your application through the onAccept event.

networking.bluetooth.onAccept.addListener(function (acceptInfo) {
    if (acceptInfo.socketId !== serverSocketId) {
        return;
    }

    // Say hello...
    networking.bluetooth.send(acceptInfo.clientSocketId, data, onSendCallback, onSendErrorCallback);

    // Set the onReceive listener
    networking.bluetooth.onReceive.addListener(onReceive);
});

Stop accepting client connections

To stop accepting client connections and unpublish the service use close.

networking.bluetooth.close(serverSocketId);