eu.hgross.blaubot.android

Class BlaubotAndroidFactory

java.lang.Object

eu.hgross.blaubot.core.BlaubotFactory

eu.hgross.blaubot.android.BlaubotAndroidFactory

public class BlaubotAndroidFactory
extends BlaubotFactory

Factory to create Blaubot instances for Android.

Constructor Summary

Constructors

Constructor and Description
BlaubotAndroidFactory()

Method Summary

Modifier and Type	Method and Description
static BlaubotAndroid	createBlaubot(java.util.UUID appUuid, IBlaubotDevice ownDevice, IBlaubotAdapter adapter, IBlaubotBeacon... beacons) Creates a Blaubot instance from a given adapter and multiple beacons.
static BlaubotAndroid	createBluetoothBlaubot(java.util.UUID appUUID) Sets up a default Blaubot instance using only bluetooth for discovery and network connections.
static BlaubotAndroid	createBluetoothBlaubotWithBluetoothAndNFCBeacon(java.util.UUID appUuid) Creates a bluetooth driven blaubot intance using NFC and Bluetooth as beacons.
static BlaubotAndroid	createBluetoothBlaubotWithMulticastBeacon(java.util.UUID appUUID, int beaconPort, int beaconBroadcastPort) Sets up a default Blaubot instance using only the bluetooth adapter.
static BlaubotAndroid	createBluetoothBlaubotWithNFCBeacon(java.util.UUID appUuid) Creates a bluetooth driven blaubot intance using NFC as beacon.
static BlaubotAndroid	createEthernetBlaubotWithBluetoothBeacon(java.util.UUID appUUID, int acceptorPort, java.net.InetAddress ownInetAddress) Creates a blaubot instance using the bluetooth beacon and sockets to communicate.
static BlaubotAndroid	createEthernetBlaubotWithNFCBeacon(java.util.UUID appUUID, int acceptorPort, java.net.InetAddress ownInetAddress) Creates a blaubot instance using ethernet adapter and the NFC beacon.
static GeoLocationBeaconAndroid	createWebSocketGeoLocationBeaconForAndroid(IBlaubotDevice ownDevice, java.lang.String beaconServerHost, int beaconServerPort) Creates an android specific GeoLocationBeacon using WebSockets.
static BlaubotAndroid	createWifiApWithBluetoothBeaconBlaubot(java.util.UUID appUUID, ConnectivityManager connectivityManager, WifiManager wifiManager, int acceptorPort) Sets up a default Blaubot instance using Wifi by creating wifi access points and socket connections.
static BlaubotAndroid	createWifiApWithNfcBeaconBlaubot(java.util.UUID appUUID, ConnectivityManager connectivityManager, WifiManager wifiManager, int acceptorPort) Sets up a default Blaubot instance using Wifi by creating wifi access points and socket connections.
static BlaubotAndroid	createWifiP2PBlaubot(java.util.UUID appUUID, WifiP2pManager p2pWifiManager, WifiManager wifiManager, WifiP2pManager.Channel beaconChannel, WifiP2pManager.Channel acceptorChannel) Sets up a default Blaubot instance using only the WIFIDirect adapter.

Methods inherited from class eu.hgross.blaubot.core.BlaubotFactory

createBlaubot, createBlaubotWebsocketAdapter, createBlaubotWebsocketServer, createBlaubotWebsocketServer, createBlaubotWebsocketServer, createEthernetBlaubot, createEthernetBlaubot, createEthernetBlaubotWithBonjourBeacon, createEthernetBlaubotWithFixedDevicesBeacon, createJsr82Adapter, createJsr82BluetoothBlaubot, createWebSocketBlaubotWithBonjourBeacon, createWebSocketBlaubotWithMulticastBeacon, createWebSocketGeoBeaconServer, createWebSocketGeoLocationBeacon, createWebSocketMetaDataDTO, createWebSocketServerConnector, getLocalIpAddress

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BlaubotAndroidFactory

public BlaubotAndroidFactory()

Method Detail

createWebSocketGeoLocationBeaconForAndroid

public static GeoLocationBeaconAndroid createWebSocketGeoLocationBeaconForAndroid(IBlaubotDevice ownDevice,
                                                                                  java.lang.String beaconServerHost,
                                                                                  int beaconServerPort)
                                                                           throws java.lang.ClassNotFoundException

Creates an android specific GeoLocationBeacon using WebSockets. This will utilize Android's geolocation service for geo data. If you want to provide the geo data yourself, see BlaubotFactory.createWebSocketGeoLocationBeacon(IBlaubotDevice, String, int). In order to use this beacon, you have to host a GeoBeaconServer. Note that you have to put blaubot-websockets as a dependency to your project.

Parameters:

ownDevice - the ownDevice (Blaubot-Instance device)

beaconServerHost - the hostname or ip of the beacon server

beaconServerPort - the port on which the beacon server listens

Returns:

the geolocation beacon for android

Throws:

java.lang.ClassNotFoundException - if blaubot-websockets is not in the classpath

createEthernetBlaubotWithNFCBeacon

public static BlaubotAndroid createEthernetBlaubotWithNFCBeacon(java.util.UUID appUUID,
                                                                int acceptorPort,
                                                                java.net.InetAddress ownInetAddress)

Creates a blaubot instance using ethernet adapter and the NFC beacon. Note that you have to call some lifecycle methods onResume and onPause. See BlaubotAndroid.

Parameters:

appUUID - the app's uuid

acceptorPort - the port of the connector's accepting socket

ownInetAddress - the own InetAddress of the network to act on

Returns:

the blaubot instance

createEthernetBlaubotWithBluetoothBeacon

public static BlaubotAndroid createEthernetBlaubotWithBluetoothBeacon(java.util.UUID appUUID,
                                                                      int acceptorPort,
                                                                      java.net.InetAddress ownInetAddress)

Creates a blaubot instance using the bluetooth beacon and sockets to communicate. Note: requires broadcast capable network

Parameters:

appUUID - the app's uuid

acceptorPort - the port of the connector's accepting socket

ownInetAddress - the own InetAddress of the network to act on

Returns:

the blaubot instance

createBlaubot

public static BlaubotAndroid createBlaubot(java.util.UUID appUuid,
                                           IBlaubotDevice ownDevice,
                                           IBlaubotAdapter adapter,
                                           IBlaubotBeacon... beacons)

Creates a Blaubot instance from a given adapter and multiple beacons.

Parameters:

appUuid - the app's unique uuid

ownDevice - the own device containing this device's unique identifier

adapter - the adapter to be used (Sockets, WebSockets, Bluetooth, ...)

beacons - the becaons to be used (Bluetooth, NFC, Multicast, Bonjour, ...)

Returns:

the blaubot instance

createBluetoothBlaubotWithMulticastBeacon

public static BlaubotAndroid createBluetoothBlaubotWithMulticastBeacon(java.util.UUID appUUID,
                                                                       int beaconPort,
                                                                       int beaconBroadcastPort)

Sets up a default Blaubot instance using only the bluetooth adapter.

Parameters:

appUUID - the app's unique uuid

beaconPort - the port on which the beacon accepts connections via tcp

beaconBroadcastPort - the port on which the beacons broadcasts and receives udp multicasts

Returns:

blaubot instance

createBluetoothBlaubot

public static BlaubotAndroid createBluetoothBlaubot(java.util.UUID appUUID)

Sets up a default Blaubot instance using only bluetooth for discovery and network connections.

Parameters:

appUUID - the app's unique uuid

Returns:

blaubot instance

createBluetoothBlaubotWithNFCBeacon

public static BlaubotAndroid createBluetoothBlaubotWithNFCBeacon(java.util.UUID appUuid)

Creates a bluetooth driven blaubot intance using NFC as beacon. Please ensure, that you delegate the android lifecycle events to the blaubot instance as described in BlaubotAndroid.

Parameters:

appUuid - the app's uuid

Returns:

the android blaubot instance

createBluetoothBlaubotWithBluetoothAndNFCBeacon

public static BlaubotAndroid createBluetoothBlaubotWithBluetoothAndNFCBeacon(java.util.UUID appUuid)

Creates a bluetooth driven blaubot intance using NFC and Bluetooth as beacons. Please ensure, that you delegate the android lifecycle events to the blaubot instance as described in BlaubotAndroid.

Parameters:

appUuid - the app's uuid

Returns:

the android blaubot instance

createWifiP2PBlaubot

public static BlaubotAndroid createWifiP2PBlaubot(java.util.UUID appUUID,
                                                  WifiP2pManager p2pWifiManager,
                                                  WifiManager wifiManager,
                                                  WifiP2pManager.Channel beaconChannel,
                                                  WifiP2pManager.Channel acceptorChannel)

Sets up a default Blaubot instance using only the WIFIDirect adapter. WARNING: This experimental and not recommended in production environments.

Parameters:

appUUID - the app's unique uuid

p2pWifiManager - android's p2p wifi manager service

wifiManager - the android wifi manager service

beaconChannel - the beaconChannel (wifip2p) to be used for beacon transmissions

acceptorChannel - the acceptorChannel (wifip2p) on which connection are going to be accepted

Returns:

blaubot instance

createWifiApWithNfcBeaconBlaubot

public static BlaubotAndroid createWifiApWithNfcBeaconBlaubot(java.util.UUID appUUID,
                                                              ConnectivityManager connectivityManager,
                                                              WifiManager wifiManager,
                                                              int acceptorPort)

Sets up a default Blaubot instance using Wifi by creating wifi access points and socket connections. Discovery is done by the NFC beacon. WARNING: This experimental and not recommended in production environments.

Parameters:

appUUID - the app's unique uuid

connectivityManager - the connectivity system service

wifiManager - the android wifi manager

acceptorPort - the port to accept connections on

Returns:

blaubot instance

createWifiApWithBluetoothBeaconBlaubot

public static BlaubotAndroid createWifiApWithBluetoothBeaconBlaubot(java.util.UUID appUUID,
                                                                    ConnectivityManager connectivityManager,
                                                                    WifiManager wifiManager,
                                                                    int acceptorPort)

Sets up a default Blaubot instance using Wifi by creating wifi access points and socket connections. Discovery is done by the Bluetooth beacon. WARNING: This experimental and not recommended in production environments.

Parameters:

appUUID - the app's unique uuid

connectivityManager - the connectivity system service

wifiManager - the android wifi manager

acceptorPort - the port to accept connections on

Returns:

blaubot instance