Ayanda
Ayanda Ayanda is an Open Source Android Library that makes it easy to discover nearby devices and share files through a simple API. Ayanda is meant to detect nearby devices using WiFi and Bluetooth technology.
This library relies on interfaces to add custom functionality, the main Bluetooth, Wifi, and LAN functionality is enclosed within the Ayanda class.
Usage
The example app shows how to use Ayanda to discover devices on the local network, through Wifi Direct and through Bluetooth classic. Actions to be taken when nearby devices are discovered by each discovery method are defined by user defined interfaces.
/* Ex: Discovering Devices on Local Network
*peers* is an ArrayList to store Lan peers discovered.
*/
// Define how to respond when nearby devices are discovered on network
private List peers = new ArrayList();
private List peerNames = new ArrayList();
private ArrayAdapter<String> peersAdapter = null;
ILan iLan = new ILan() {
@Override
public void deviceListChanged() {
// Clear the list of discovered peers
peers.clear();
peerNames.clear();
peersAdapter.clear();
// update list with all peers within range
peers.addAll(a.lanGetDeviceList());
for (int i = 0; i < peers.size(); i++) {
Lan.Device d = (Lan.Device) peers.get(i);
peersAdapter.add(d.getName());
}
}
};
a = new Ayanda(this, null, iLan, null);
a.lanDiscover();
// INFO: lanDiscover() automatically makes an HTTP connection to services discoveredTo share a file using NSD (LAN)
/* Share a file to nearby devices through LAN */
String filePath = "sdcard/somepic.jpg";
// NearbyMedia is a helper class to describe a file
NearbyMedia nearbyMedia = new NearbyMedia();
nearbyMedia.setMimeType("image/jpeg");
nearbyMedia.setTitle("pic");
nearbyMedia.setFileMedia(new File(filePath));
//get a JSON representation of any metadata we want to share
Gson gson = new GsonBuilder()
.setDateFormat(DateFormat.FULL, DateFormat.FULL).create();
nearbyMedia.mMetadataJson = gson.toJson("key:value");
// Share the file to devices on LAN registered for current service
try {
// Will store on nearby device's "Download" folder.
a.lanShare(nearbyMedia);
} catch (IOException e) {
e.printStackTrace();
}Discovering nearby devices by WifiDirect
/* Discovering nearby devices by WifiDirect */
private List peers = new ArrayList();
private List peerNames = new ArrayList();
private ArrayAdapter<String> peersAdapter = null;
a = new Ayanda(this, null, null, new IWifiDirect() {
@Override
public void wifiP2pStateChangedAction(Intent intent) {
}
// Decide what to do when the list of nearby devices changes
@Override
public void wifiP2pPeersChangedAction() {
peers.clear();
peers.addAll(a.wdGetDevicesDiscovered() );
peerNames.clear();
for (int i = 0; i < peers.size(); i++) {
WifiP2pDevice device = (WifiP2pDevice) peers.get(i);
peersAdapter.add(device.deviceName);
}
}
@Override
public void wifiP2pConnectionChangedAction(Intent intent) {
}
@Override
public void wifiP2pThisDeviceChangedAction(Intent intent) {
}
});
a.wdDiscover();Sharing a file (bytes) using Bluetooth
private List peers = new ArrayList();
private List peerNames = new ArrayList();
private ArrayAdapter<String> peersAdapter = null;
a = new Ayanda(this, new IBluetooth() {
@Override
public void actionDiscoveryStarted(Intent intent) {}
@Override
public void actionDiscoveryFinished(Intent intent) {}
@Override
public void stateChanged(Intent intent) {}
@Override
public void scanModeChange(Intent intent) {}
@Override
public void actionFound(Intent intent) {
peersAdapter.clear();
peersAdapter.addAll(a.btGetDeviceNamesDiscovered());
devices = a.btGetDevices();
}
@Override
public void dataRead(byte[] bytes, int length) {
String readMessage = new String(bytes, 0, length);
Toast.makeText(BluetoothActivity.this, readMessage, Toast.LENGTH_LONG)
.show();
}
// Send "Hello World" after connecting to a device
@Override
public void connected(BluetoothDevice device) {
String message = "Hello World";
try {
a.btSendData(device, message.getBytes()); // maybe a class for a device that's connected
} catch (IOException e) {
e.printStackTrace();
}
}
}, null, null);
// Discover nearby Bluetooth devices paired or not
a.btDiscover();
// Connect to device from list
@Override
public void onItemClick(AdapterView<?> adapterView, View view, int pos, long l) {
BluetoothDevice device = devices.get(peerNames.get(pos));
a.btConnect(device); // will trigger "connected" event
}See Example App in the app folder for more implementation details.
Contributing
See CONTRIBUTING.md.
License
Copyright [2017] [Sabelo Mhlambi]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.