Popularity
2.3
Stable
Activity
0.0
Stable
57
4
29

Description

An easy way to access call logs from android devices

Programming language: Java
License: BSD 2-clause "Simplified" License
Tags: Logs     Call     Wickerlabs    
Latest version: v1.09

README

Call Logs - Android library for accessing device call logs

Android Arsenal

Image of the library in action

Installation

Step 1. Add the JitPack repository to your root build.gradle file.

allprojects {
    repositories {
        ...
        maven { url "https://jitpack.io" }
    }
}

Step 2. Add the library dependency to your app build.gradle file

dependencies {
        implementation 'com.github.wickerlabs:CallLogs:[email protected]'
}

Step 3. Handle permissions (For API 23+)

For those targeting API 23+, 
you should handle the runtime permissions for READ_CONTACTS and READ_CALL_LOG. 
As a reference, check  out the sample app in the repository. 
Other than that, permissions are automatically added to the manifest file.

Usage

  • Initialization

     LogsManager logsManager = new LogsManager(context);
    
  • Getting a list of call logs

     List<LogObject> callLogs = logsManager.getLogs(type);
    
    • Available list types : >
      > LogsManager.INCOMING_CALLS: for getting the list (LogObject) of all the incoming calls. >
      > LogsManager.OUTGOING_CALLS: for getting the list (LogObject) of all the incoming calls. >
      > LogsManager.MISSED_CALLS: for getting the list (LogObject) of all the incoming calls. >
      > LogsManager.ALL_CALLS: for getting the list (LogObject) of all the calls.
  • Getting call durations

logsManager.getIncomingDuration(): returns the number of seconds for all the incoming calls made.

logsManager.getOutgoingDuration(): returns the number of seconds for all the outgoing calls made.

logsManager.getTotalDuration(): returns the number of seconds for all the calls made.

logsManager.getCoolDuration(type): returns a String in the form of "x hrs xx mins" or "xx mins xx secs"

  • Available duration types : >
    > LogsManager.INCOMING: for getting duration for all the incoming calls. >
    > LogsManager.OUTGOING: for getting duration for all the incoming calls. >
    > LogsManager.TOTAL: for getting duration for all the calls.

Using LogObjects

  • Some useful methods

logObject.getDuration(): returns an int of the seconds used for that particular call.

logObject.getNumber(): returns a String of the number associated with the call made.

logObject.getContactName(): returns a String of the contact name for the number in the log, if not found, it returns the number.

logObject.getType(): returns an int for the type of the call log.

logObject.getCoolDuration(): returns a String in the form of "x hrs xx mins" or "xx mins xx secs" based on the duration.

Examples

  • Retriving a list of all call logs:

    ListView logList = (ListView) findViewById(R.id.LogsList);
    LogsManager logsManager = new LogsManager(this);
    List<LogObject> callLogs = logsManager.getLogs(LogsManager.ALL_CALLS);
    LogsAdapter logsAdapter = new LogsAdapter(this, R.layout.log_layout, callLogs);
    logList.setAdapter(logsAdapter);
    

be sure to check out the sample app in the repository.

Acknowledgements

Icons made by madebyoliver from www.flaticon.com