Um plugin Flutter para acessar e consultar o histórico de chamadas. Suporte apenas para Android, pois o iOS não fornece API para acessar o histórico de chamadas.
Orientação gerada a partir de informações públicas. Apenas para referência.
O pacote call_log é um plugin Flutter que permite aplicativos Android acessar e consultar o histórico de chamadas do dispositivo. Ele fornece uma API simples para recuperar detalhes como número do chamador, tipo de chamada (recebida, realizada, perdida) e duração da chamada. Como o iOS não expõe APIs de histórico de chamadas, este plugin é limitado ao Android apenas. É útil para aplicações que exigem integração com o histórico de chamadas, como gerenciadores de contatos ou ferramentas de comunicação. O pacote é mantido por 4q.eu e está disponível via pub.dev.
Casos de uso
Acessando o histórico de chamadas em aplicativos Android
Construindo ferramentas de gerenciamento de contatos ou chamadas
Integrando registros de chamadas em aplicativos de comunicação
Criando painéis de análise de chamadas
Desenvolvendo aplicativos de discagem ou correio de voz
Principais recursos
Suporte apenas para Android
API simples para consultar registros de chamadas
Recuperação de detalhes da chamada, como número e tipo
Suporte para duração da chamada e marcas de tempo
Código de código aberto no GitHub
Indicado para
desenvolvedores de aplicativos Android
Recursos de gerenciamento de registro de chamadas
Aplicativos de comunicação e produtividade
Aplicativos que precisam de dados da história de chamadas do usuário
Considerações
Não compatível com iOS
Requer permissões em tempo de execução no Android
Limitado a dados de log de chamadas de sistema
Pode variar conforme o fabricante do dispositivo
acesso a dados sensíveis à privacidade
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
call_log
A Flutter plugin to access and query call history log.
Support for Android only as iOS does not provide API for accessing call history
This plugin is able to handle checking and requesting permission automatically.
Currently implemented query params are dateFrom, dateTo, durationFrom, durationTo, name and number.
String params are queried using LIKE and '%' wildcard on both sides.
Migration to 6.0.0+
Since 6.0.0, we also check permission android.permission.READ_PHONE_NUMBERS, which is required for the simDisplayName to work in case of multiSim setups.
You can delete specific call log entries or all call logs:
// Delete a specific call log entryint deletedCount = awaitCallLog.deleteCallLog(entry.id);
// Delete all call logsint deletedCount = awaitCallLog.deleteAllCallLogs();
The methods return the number of entries deleted (1 for single deletion, total count for bulk deletion).
Export Call Logs
You can export all call logs to a JSON file:
// Export call logs to Downloads directory with timestampMap<String, dynamic> result = awaitCallLog.exportCallLog();
The export method saves the file to the Downloads directory with a filename in the format call_log_YYYYMMDD_HHMMSS.json. The method returns a map containing the number of entries exported and the absolute path to the exported file.
Background execution
This plugin may be used in flutter background engine, via plugins like WorkManager. But please note that it is impossible for plugin to request permission while it is executed in background. You have to manually request permissions READ_CALL_LOG and READ_PHONE_STATE
Note on iOS support
Unfortuynately iOS doesn't support queries of call log. More information here: https://stackoverflow.com/questions/33753644/is-there-an-ios-api-for-accessing-call-logs
Example
// IMPORT PACKAGEimport'package:call_log/call_log.dart';
// GET WHOLE CALL LOGIterable<CallLogEntry> entries = awaitCallLog.get();
// QUERY CALL LOG (ALL PARAMS ARE OPTIONAL)var now = DateTime.now();
int from = now.subtract(Duration(days: 60)).millisecondsSinceEpoch;
int to = now.subtract(Duration(days: 30)).millisecondsSinceEpoch;
Iterable<CallLogEntry> entries = awaitCallLog.query(
dateFrom: from,
dateTo: to,
durationFrom: 0,
durationTo: 60,
name: 'John Doe',
number: '901700000',
type: CallType.incoming,
);
Todo
[x] query call log using most common fields, using AND as a logical gate
[ ] query call log with full power of native API
Contribution and Support
Contributions are welcome!
If you want to contribute code please create a PR
If you find a bug or want a feature, please fill an issue