Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bertrandmartel/multi-event-library
Android library used to catch a range of event types (volume, screen state, incoming call, SMS, Wifi connection etc...)
https://github.com/bertrandmartel/multi-event-library
android android-library events
Last synced: 4 days ago
JSON representation
Android library used to catch a range of event types (volume, screen state, incoming call, SMS, Wifi connection etc...)
- Host: GitHub
- URL: https://github.com/bertrandmartel/multi-event-library
- Owner: bertrandmartel
- License: mit
- Created: 2015-08-02T22:35:06.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-09-01T16:51:20.000Z (about 7 years ago)
- Last Synced: 2023-05-25T13:06:10.156Z (over 1 year ago)
- Topics: android, android-library, events
- Language: Java
- Homepage:
- Size: 102 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Multi Event library #
[](https://travis-ci.org/bertrandmartel/multi-event-library)
[  ](https://bintray.com/bertrandmartel/maven/multi-event-library/_latestVersion)
[](https://maven-badges.herokuapp.com/maven-central/fr.bmartel/multi-event-library)
[](http://javadoc-badge.appspot.com/fr.bmartel/multi-event-library)
[](LICENSE.md)
Small Android library to catch a range of event type on Android devices via listeners :
* Volume level change event for Media / System / Ring / DTMF / Voice call / Notification
* SMS reception event
* Incoming phone call event
* phone hook-off event
* screen state change event (screen on/off)
* Wifi connection change event
* Ethernet connection change event (for Android box)
You can also access current value for specific properties :
* current value for volume media / System / Ring / DTMF / Voice call / Notification
* mute volume
* current screen state value
* curent wifi state value
* current ethernet state value
## Compatibility
For Android 1.0+ except for the `isScreenOn()` only accessible from Android 2.1+ but notification can be received anyway
## Include in your project
Grab from Bintray maven repository :
```groovy
compile 'akinaru:multi-event-library:0.35'
```
## How to use ?
First initialize `MultiEvent` object with your application context :
```java
import fr.bmartel.android.multievent.MultiEvent;
.......
MultiEvent eventManager = new MultiEvent(context);
```
## Android permissions
According to which event you want to track, you may need some Android permissions :
| Event Type | Permission |
|------------------------------------------------------------------------|----------------------------|
| Incoming phone call | `` |
| SMS reception event | `` |
| phone hook-off | `` |
| Wifi / Ethernet connection change | `` |
| Volume level change event | |
## Volume level event listener
### System volume
```java
eventManager.addSystemVolumeListener(new IVolumeListener() {
@Override
public void onVolume(byte oldVolume, byte newVolume) {
Log.i(TAG, "[VOLUME SYSTEM] old volume : " + oldVolume + " | " + "new volume : " + newVolume);
}
});
```
### Media volume
```java
eventManager.addMediaVolumeListener(new IVolumeListener() {
@Override
public void onVolume(byte oldVolume, byte newVolume) {
Log.i(TAG, "[VOLUME MEDIA] old volume : " + oldVolume + " | " + "new volume : " + newVolume);
}
});
```
### DTMF volume
```java
eventManager.addDtmfVolumeListener(new IVolumeListener() {
@Override
public void onVolume(byte oldVolume, byte newVolume) {
Log.i(TAG, "[VOLUME DTMF] old volume : " + oldVolume + " | " + "new volume : " + newVolume);
}
});
```
### Notification volume
```java
eventManager.addNotificationVolumeListener(new IVolumeListener() {
@Override
public void onVolume(byte oldVolume, byte newVolume) {
Log.i(TAG, "[VOLUME NOTIF] old volume : " + oldVolume + " | " + "new volume : " + newVolume);
}
});
```
### Ring volume
```java
eventManager.addRingVolumeListener(new IVolumeListener() {
@Override
public void onVolume(byte oldVolume, byte newVolume) {
Log.i(TAG, "[VOLUME RING] old volume : " + oldVolume + " | " + "new volume : " + newVolume);
}
});
```
### Voice call volume
```java
eventManager.addVoiceCallVolumeListener(new IVolumeListener() {
@Override
public void onVolume(byte oldVolume, byte newVolume) {
Log.i(TAG, "[VOLUME VOICE CALL] old volume : " + oldVolume + " | " + "new volume : " + newVolume);
}
});
```
With respective import : ``import fr.bmartel.android.multievent.listener.IVolumeListener;``
## SMS reception
```java
import fr.bmartel.android.multievent.listener.ISmsListener;
.......
eventManager.addSmsListener(new ISmsListener() {
@Override
public void onSmsReceived() {
Log.i(TAG, "[SMS RECEIVED]");
}
});
```
## Incoming call/hook-off
```java
import fr.bmartel.android.multievent.listener.IPhoneCallListener;
.......
eventManager.addPhoneCallListener(new IPhoneCallListener() {
@Override
public void onIncomingCall(String phoneNumber) {
Log.i(TAG, "[INCOMING CALL]");
}
@Override
public void onOffHook() {
Log.i(TAG, "[OFF HOOK]");
}
});
```
## Screen state
```java
import fr.bmartel.android.multievent.listener.IScreenStateListener;
.......
eventManager.addScreenStateListener(new IScreenStateListener() {
@Override
public void onScreenOn() {
Log.i(TAG, "[SCREEN ON]");
}
@Override
public void onScreenOff() {
Log.i(TAG, "[SCREEN OFF]");
}
});
```
## Connectivity state
```java
import fr.bmartel.android.multievent.listener.IConnectivityListener;
.......
eventManager.addConnectivityChangeListener(new IConnectivityListener() {
@Override
public void onWifiStateChange(NetworkInfo.State formerState, NetworkInfo.State newState) {
Log.i(TAG,"[WIFI STATE CHANGE] from state " + formerState + " to " + newState);
}
@Override
public void onEthernetStateChange(NetworkInfo.State formerState, NetworkInfo.State newState) {
Log.i(TAG,"[ETHERNET STATE CHANGE] from state " + formerState + " to " + newState);
}
});
```
## Close all listeners / unregister receivers
In your onDestroy() you have to call the close() method
```java
@Override
public void onDestroy() {
super.onDestroy();
eventManager.close();
}
```
You can remove a single listener : ``eventManager.removeListeners(listener)``
Or remove all listener you have created : ``eventManager.removeAllListeners()``
## Access raw value directly
You may want to have raw value at a precise time.
* access all volume value in % :
```java
Log.v(TAG, "Media volume : " + eventManager.getMediaVolume());
Log.v(TAG, "System volume : " + eventManager.getSystemVolume());
Log.v(TAG, "Ring volume : " + eventManager.getRingVolume());
Log.v(TAG, "Notification volume : " + eventManager.getNotificationVolume());
Log.v(TAG, "DTMF volume : " + eventManager.getDtmfVolume());
Log.v(TAG, "Voice call volume : " + eventManager.getVoiceCallVolume());
```
* mute volume :
```java
eventManager.muteMedia(true);
eventManager.muteSystem(true);
eventManager.muteAlarm(true);
eventManager.muteRing(true);
```
* access screen state value :
```java
Log.v(TAG, "Screen state : " + eventManager.getScreenState());
```
* access Wifi connectivity state :
```java
Log.v(TAG, "Wifi state : " + eventManager.getWifiState());
```
* access Ethernet connectivity state :
```java
Log.v(TAG, "Ethernet state : " + eventManager.getEthernetState());
```
## License
The MIT License (MIT) Copyright (c) 2015-2017 Bertrand Martel