搜索插件、代码仓与 APP 分类

插件详情v6.0.1

call_log

一个 Flutter 插件,用于访问和查询通话记录日志。仅支持 Android,因为 iOS 不提供访问通话记录的 API。

Android
近 30 天下载
6340
喜欢数
117
Pub 分数
160

安装插件

flutter pub add call_log

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

call_log 包是一个 Flutter 插件,可让 Android 应用访问和查询设备的通话记录。它提供了一个简单的 API,用于获取来电号码、通话类型(来电、去电、未接)和通话时长等详细信息。由于 iOS 不提供通话记录 API,因此该插件仅限于 Android 平台使用。对于需要集成通话记录的应用程序(如联系人管理器或通信工具)非常有用。该包由 4q.eu 维护,并可通过 pub.dev 获取。

适合场景

  • 在 Android 应用中访问通话记录
  • 构建联系人或通话管理工具
  • 将通话记录集成到通讯应用中
  • 创建呼叫分析仪表板
  • 开发拨号器或语音邮件应用

主要特点

  • 仅限 Android 支持
  • 用于查询通话记录的简单 API
  • 获取通话详情,如号码和类型
  • 支持通话时长和时间戳
  • GitHub 上的开源代码

适合对象

  • Android应用开发者
  • 通话记录管理功能
  • 通信和生产力应用
  • 需要用户通话记录数据的应用程序

使用建议

  • 与 iOS 不兼容
  • 需要 Android 运行时权限
  • 仅限系统调用日志数据
  • 可能因设备制造商而异
  • 隐私敏感数据访问

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

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

所属分类

源码仓库

使用此插件的项目