パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v6.0.1

call_log

通話履歴ログにアクセスおよび照会するためのFlutterプラグイン。iOSは通話履歴にアクセスするAPIを提供しないため、Androidのみ対応しています。

Android
30日間ダウンロード
6340
いいね数
117
Pub ポイント
160

パッケージをインストール

flutter pub add call_log

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

call_log パッケージは、Android アプリがデバイスの通話履歴にアクセスして照会できるようにする Flutter プラグインです。発信者番号、通話タイプ(着信、発信、不在着信)、通話時間などの詳細情報を取得するためのシンプルな 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

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト