Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev6.0.1

call_log

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.

Android
Downloads em 30 dias
6,3 mil
Curtidas
117
Pontos Pub
160

Instalar pacote

flutter pub add call_log

Visão geral do pacote

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

pub package

A Flutter plugin to access and query call history log.
Support for Android only as iOS does not provide API for accessing call history

Usage

To use this plugin, add call_log as a dependency in your pubspec.yaml file.

You may add the following permission to your Android Manifest:

<uses-permission android:name="android.permission.READ_CALL_LOG" />
<uses-permission android:name="android.permission.WRITE_CALL_LOG" />
<uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />

Ensure that following options are present in your build.gradle:

compileOptions {
......//
coreLibraryDesugaringEnabled true
}

dependencies {
coreLibraryDesugaring 'com.android.tools:desugar_jdk_libs:1.2.2'
}

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.

Add new permission to your manifest:

<uses-permission android:name="android.permission.READ_PHONE_NUMBERS" />

Delete Call Logs

You can delete specific call log entries or all call logs:

// Delete a specific call log entry
int deletedCount = await CallLog.deleteCallLog(entry.id);

// Delete all call logs
int deletedCount = await CallLog.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 timestamp
Map<String, dynamic> result = await CallLog.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 PACKAGE
import 'package:call_log/call_log.dart';

// GET WHOLE CALL LOG
Iterable<CallLogEntry> entries = await CallLog.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 = await CallLog.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

Categorias

Repositório-fonte

Projetos que usam este pacote