Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/championswimmer/lifelog-android-library
An Android Library/API to access Sony Lifelog palatform.
https://github.com/championswimmer/lifelog-android-library
Last synced: 29 days ago
JSON representation
An Android Library/API to access Sony Lifelog palatform.
- Host: GitHub
- URL: https://github.com/championswimmer/lifelog-android-library
- Owner: championswimmer
- License: other
- Created: 2015-04-21T04:57:43.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-06-03T08:12:06.000Z (over 7 years ago)
- Last Synced: 2024-05-02T00:10:49.772Z (7 months ago)
- Language: Java
- Size: 209 KB
- Stars: 16
- Watchers: 5
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# LifeLog Android Library
This is an Android (not pure java) wrapper for the [LifeLog Web API](https://developer.sony.com/develop/services/lifelog-api).
[](https://www.codementor.io/championswimmer?utm_source=github&utm_medium=button&utm_term=championswimmer&utm_campaign=github)
[](https://jitpack.io/#in.championswimmer/Lifelog-Android-Library)
[](https://www.codacy.com/app/dev_19/Lifelog-Android-Library?utm_source=github.com&utm_medium=referral&utm_content=championswimmer/Lifelog-Android-Library&utm_campaign=Badge_Grade)
### How to add to your project
Add it using jitpack maven distribution.
Add the jitpack maven repository
```groovy
repositories {
jcenter()
maven {
url "https://jitpack.io"
}
}
```
Add the dependency
```groovy
dependencies {
compile 'in.championswimmer:Lifelog-Android-Library:1.+'
}
```
###Initialise
In your Application class, inside the _onCreate_ body, add this
```java
LifeLog.initialise("clientid", "secret", "https://callbackurl.com");
```
Replace _clientid_, _secret_ and _callbackurl_ with your respective values of the app that
you have registered on LifeLog.
###Login and authentication
####Login
To log the user in for the first time, use this simple static method
```java
LifeLog.doLogin(MainActivity.this)
```
Note that, after login is completed, we will return back to same activity.
Internally, `doLogin` makes a `startActivityForResult` call with `LifeLog.LOGINACTIVITY_REQUEST_CODE` as request code. Handle the returning user like this
```java
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
if (requestCode == LifeLog.LOGINACTIVITY_REQUEST_CODE) {
if (resultCode == RESULT_OK) {
Toast.makeText(this, "User authenticated", Toast.LENGTH_SHORT).show();
} else {
Toast.makeText(this, "User authentication failed", Toast.LENGTH_SHORT).show();
}
} else {
super.onActivityResult(requestCode, resultCode, data);
}
}
```
#### Checking Authentication state
You would want to check if the user is authenticated or not. Even if he is, we may need to refresh
the auth token. Again, simple code for that.
```java
LifeLog.checkAuthentication(this, new LifeLog.OnAuthenticationChecked() {
@Override
public void onAuthChecked(boolean authenticated) {
if (authenticated) {
//User is authenticated, we can do API requests now
} else {
//User is not authenticated. Make him login (or whatever suits your app's flow)
//LifeLog.doLogin(MainActivity.this);
}
}
});
```
### API Requests
#### `me` Endpoint
Create an object of `MeRequest` using the static `MeRequest.prepareRequest` method.
The data gets actually fetched when you call `get()`
```java
MeRequest meRequest = MeRequest.prepareRequest();
meRequest.get(MainActivity.this, new MeRequest.OnMeFetched() {
@Override
public void onMeFetched(Me meData) {
Log.d(TAG, "onMeFetched: " + meData.getUsername());
}
});
```
#### `locations` endpoint
Create an object of `MeLocationRequest` using one of the two _prepareRequest_ methods.
One allows you to specify start and end time. Other doesn't. You can set either of start or end
time to be `null` as well.
The data fetching actually starts when _get_ is called. After the data is fetched, the `onLocationFetched`
callback is hit.
A List<> of MeLocation objects are at your disposal.
```java
MeLocationRequest llLocation = MeLocationRequest.prepareRequest(500);
llLocation.get(MainActivity.this, new MeLocationRequest.OnLocationFetched() {
@Override
public void onLocationFetched(ArrayList locations) {
for (MeLocation loc : locations) {
String id = loc.getId();
Calendar startTime = loc.getStartTime();
//continue likewise
}
}
});
```
### Developers
- [@championswimmer](http://github.com/championswimmer)
- [@francais-harry](http://github.com/francais-harry)