搜尋套件、儲存庫與 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

所屬分類

原始碼儲存庫

使用此套件的專案