Android 应用后台来电检测：利用前台服务实现持久监听-js教程-PHP中文网

Android 应用后台来电检测：利用前台服务实现持久监听

在android应用中实现即使应用完全关闭也能检测到来电的功能，核心在于利用android的前台服务（foreground service）机制。前台服务通过在通知栏显示一个持续通知，告知用户应用正在后台运行，从而获得系统更高的优先级，有效避免被系统杀死。结合开机广播接收器，可以确保服务在设备启动后自动运行，实现类似truecaller的持久化来电监听。

一、理解Android后台任务与前台服务

随着Android系统版本的演进，为了优化电池续航和系统性能，对后台任务的执行施加了越来越严格的限制。传统的后台服务（Background Service）在应用被关闭后很容易被系统杀死。对于需要持续运行，且用户感知到的任务（如音乐播放、导航、来电检测等），Android提供了“前台服务”（Foreground Service）机制。

前台服务与普通服务的最大区别在于它会向用户显示一个持续的通知。这个通知告诉用户应用正在后台执行某项任务，因此系统会给予前台服务更高的优先级，使其更不容易被杀死，从而保证任务的持续性。对于像来电检测这样需要在应用完全关闭后依然能工作的场景，前台服务是实现此功能的关键。

二、实现来电检测前台服务

要实现来电检测的前台服务，我们需要一个服务类来监听电话状态，并在应用启动时或开机时启动这个服务。

1. 核心权限声明

在 AndroidManifest.xml 文件中声明必要的权限：

READ_PHONE_STATE: 用于读取电话状态。
FOREGROUND_SERVICE: 声明应用将使用前台服务。
RECEIVE_BOOT_COMPLETED: 用于接收开机完成广播，以便在设备启动后自动启动服务。
POST_NOTIFICATIONS: （Android 13+）用于发布通知，前台服务必须有通知。

<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" /> <!-- For Android 13+ -->

<application
    android:allowBackup="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.MyApp">

    <!-- 声明你的服务 -->
    <service
        android:name=".CallDetectionService"
        android:enabled="true"
        android:exported="false"
        android:foregroundServiceType="phoneCall" /> <!-- Android 10+ 需指定服务类型 -->

    <!-- 声明你的广播接收器 -->
    <receiver
        android:name=".BootReceiver"
        android:enabled="true"
        android:exported="false">
        <intent-filter>
            <action android:name="android.intent.action.BOOT_COMPLETED" />
            <category android:name="android.intent.category.DEFAULT" />
        </intent-filter>
    </receiver>

    <!-- ... 其他组件 ... -->
</application>

登录后复制

注意：

无阶未来模型擂台/AI 应用平台

无阶未来模型擂台/AI 应用平台，一站式模型+应用平台

查看详情

从 Android 10 (API 29) 开始，前台服务需要通过 android:foregroundServiceType 属性声明其类型，例如 phoneCall。
android:exported="false" 是推荐的安全实践，表示该组件不应被其他应用直接调用。

2. 创建来电检测服务 CallDetectionService

这个服务将负责监听电话状态并处理来电事件。

import android.app.Notification;
import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.app.Service;
import android.content.Context;
import android.content.Intent;
import android.os.Build;
import android.os.IBinder;
import android.telephony.PhoneStateListener;
import android.telephony.TelephonyManager;
import android.util.Log;

import androidx.annotation.Nullable;
import androidx.core.app.NotificationCompat;

public class CallDetectionService extends Service {

    private static final String TAG = "CallDetectionService";
    public static final String CHANNEL_ID = "CallDetectionServiceChannel";
    private TelephonyManager telephonyManager;
    private PhoneStateListener phoneStateListener;

    @Override
    public void onCreate() {
        super.onCreate();
        Log.d(TAG, "Service onCreate");
        // 创建通知渠道，Android 8.0 (API 26) 及以上版本需要
        createNotificationChannel();

        telephonyManager = (TelephonyManager) getSystemService(Context.TELEPHONY_SERVICE);
        phoneStateListener = new PhoneStateListener() {
            @Override
            public void onCallStateChanged(int state, String phoneNumber) {
                super.onCallStateChanged(state, phoneNumber);
                switch (state) {
                    case TelephonyManager.CALL_STATE_RINGING:
                        Log.d(TAG, "Incoming call: " + phoneNumber);
                        // 在这里处理来电逻辑，例如显示自定义浮窗、播放提示音等
                        // 注意：在后台显示UI可能需要SYSTEM_ALERT_WINDOW权限
                        break;
                    case TelephonyManager.CALL_STATE_OFFHOOK:
                        Log.d(TAG, "Call answered or dialing: " + phoneNumber);
                        break;
                    case TelephonyManager.CALL_STATE_IDLE:
                        Log.d(TAG, "Call ended or idle.");
                        break;
                }
            }
        };

        // 注册电话状态监听器
        if (telephonyManager != null) {
            telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_CALL_STATE);
        }
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        Log.d(TAG, "Service onStartCommand");
        // 构建前台服务通知
        Notification notification = new NotificationCompat.Builder(this, CHANNEL_ID)
                .setContentTitle("来电检测服务")
                .setContentText("正在后台运行，检测来电...")
                .setSmallIcon(R.drawable.ic_launcher_foreground) // 替换为你的应用图标
                .setPriority(NotificationCompat.PRIORITY_LOW) // 设置较低优先级，减少干扰
                .build();

        // 启动前台服务
        startForeground(1, notification); // 1 是通知的唯一ID

        // 返回 START_STICKY 表示服务被系统杀死后会自动尝试重启
        return START_STICKY;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        Log.d(TAG, "Service onDestroy");
        // 解注册电话状态监听器，防止内存泄漏
        if (telephonyManager != null && phoneStateListener != null) {
            telephonyManager.listen(phoneStateListener, PhoneStateListener.LISTEN_NONE);
        }
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        // 本例中不使用绑定服务，所以返回null
        return null;
    }

    // 为 Android 8.0 (API 26) 及以上版本创建通知渠道
    private void createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel serviceChannel = new NotificationChannel(
                    CHANNEL_ID,
                    "来电检测服务通道",
                    NotificationManager.IMPORTANCE_DEFAULT // 可以根据需求设置重要性
            );
            NotificationManager manager = getSystemService(NotificationManager.class);
            if (manager != null) {
                manager.createNotificationChannel(serviceChannel);
            }
        }
    }
}

登录后复制

3. 创建开机启动广播接收器 BootReceiver

为了确保服务在设备重启后依然能工作，我们需要一个广播接收器来监听 ACTION_BOOT_COMPLETED 广播。

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.os.Build;
import android.util.Log;

public class BootReceiver extends BroadcastReceiver {

    private static final String TAG = "BootReceiver";

    @Override
    public void onReceive(Context context, Intent intent) {
        // 检查是否是开机完成广播
        if (Intent.ACTION_BOOT_COMPLETED.equals(intent.getAction())) {
            Log.d(TAG, "Boot completed, starting CallDetectionService.");
            Intent serviceIntent = new Intent(context, CallDetectionService.class);
            // 对于 Android 8.0 (API 26) 及以上版本，必须使用 startForegroundService() 启动前台服务
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
                context.startForegroundService(serviceIntent);
            } else {
                context.startService(serviceIntent);
            }
        }
    }
}

登录后复制

4. 从 Activity 启动服务

你可以在应用的主 Activity 中，例如 onCreate 方法或用户点击某个按钮时，启动这个服务。

import android.content.Intent;
import android.content.pm.PackageManager;
import android.os.Build;
import android.os.Bundle;
import android.widget.Button;
import android.widget.Toast;

import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

import static android.Manifest.permission.READ_PHONE_STATE;
import static android.Manifest.permission.POST_NOTIFICATIONS; // For Android 13+

public class MainActivity extends AppCompatActivity {

    private static final int PERMISSION_REQUEST_CODE = 1001;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Button startServiceButton = findViewById(R.id.startServiceButton);
        startServiceButton.setOnClickListener(v -> requestPermissionsAndStartService());
    }

    private void requestPermissionsAndStartService() {
        // 检查并请求运行时权限
        if (ContextCompat.checkSelfPermission(this, READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED ||
            (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU &&
             ContextCompat.checkSelfPermission(this, POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED)) {

            String[] permissions;
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
                permissions = new String[]{READ_PHONE_STATE, POST_NOTIFICATIONS};
            } else {
                permissions = new String[]{READ_PHONE_STATE};
            }
            ActivityCompat.requestPermissions(this, permissions, PERMISSION_REQUEST_CODE);
        } else {
            startCallDetectionService();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == PERMISSION_REQUEST_CODE) {
            boolean allPermissionsGranted = true;
            for (int result : grantResults) {
                if (result != PackageManager.PERMISSION_GRANTED) {
                    allPermissionsGranted = false;
                    break;
                }
            }
            if (allPermissionsGranted) {
                startCallDetectionService();
            } else {
                Toast.makeText(this, "权限被拒绝，无法启动服务", Toast.LENGTH_SHORT).show();
            }
        }
    }

    private void startCallDetectionService() {
        Intent serviceIntent = new Intent(this, CallDetectionService.class);
        // 对于 Android 8.0 (API 26) 及以上版本，必须使用 startForegroundService() 启动前台服务
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            startForegroundService(serviceIntent);
        } else {
            startService(serviceIntent);
        }
        Toast.makeText(this, "来电检测服务已启动", Toast.LENGTH_SHORT).show();
    }
}

登录后复制

三、注意事项

运行时权限： READ_PHONE_STATE 和 POST_NOTIFICATIONS (Android 13+) 都是危险权限，必须在运行时向用户动态请求。
通知重要性： 前台服务必须伴随一个用户可见的通知。这个通知不应该被用户随意清除，否则服务可能会降级为普通后台服务并被系统杀死。通知的内容应清晰地告知用户应用正在执行的任务。
用户体验： 尽管前台服务优先级高，但频繁的后台操作仍可能影响电池续航。在实现具体逻辑时，应尽量优化资源消耗。通知的优先级也应合理设置，避免过度打扰用户。
Android 版本差异：
- Android 8.0 (API 26) 及以上： 启动前台服务必须使用 startForegroundService() 方法，并且在服务创建后的5秒内调用 startForeground()，否则系统会抛出 ForegroundServiceStartNotAllowedException。同时需要创建通知渠道。
- Android 10 (API 29) 及以上： 需要在 AndroidManifest.xml 中为前台服务声明 android:foregroundServiceType 属性。
- Android 13 (API 33) 及以上： 需要 POST_NOTIFICATIONS 权限才能发布通知。
用户强制停止： 如果用户通过系统设置（如应用信息界面）强制停止了应用，那么即使是前台服务也会被终止，并且开机启动广播也将失效。在这种情况下，应用需要用户手动重新启动。
替代方案的限制： 某些厂商的定制ROM可能会对后台服务有更严格的限制，即使是前台服务也可能受到影响。