kimxyz / calllogs

Android library for accessing device call logs

Call Logs - Android library for accessing device call logs

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:1+@aar'
}

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