Android开发：耳机插入时全局弹窗无法在其他屏幕显示的问题

Hey there! Let's tackle this problem where your headset-triggered popup only shows up when your app is in the foreground. The core issue right now is that your PopUpActivity is a standard activity, which won't display over other apps unless we configure it as a system-level floating window and ensure your headset detection works even when your app is in the background. Here's how to fix it:

1. Understand the Root Causes #

• Standard Activity Limitations: A regular startActivity() call won't launch an activity over other apps when your app isn't in the foreground. We need to mark the popup as a floating overlay.
• Background Broadcast Detection: If you're only listening for headset events within your app's activities, the listener will stop working once you switch to another app. We need a persistent way to detect headset inserts.

2. Required Permissions & Manifest Configurations #

First, add the necessary permissions and configure your PopUpActivity and broadcast service in the AndroidManifest.xml:

<!-- Permission for floating windows (required for Android 6.0+) -->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<!-- Permission for audio settings access -->
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<!-- Permission for foreground service (Android 8.0+) -->
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />

<application ...>
    <!-- Configure your popup activity -->
    <activity
        android:name=".PopUpActivity"
        android:theme="@style/FloatingDialogTheme"
        android:launchMode="singleTask"
        android:excludeFromRecents="true"
        android:taskAffinity=""
        android:exported="false" />

    <!-- Register foreground service for persistent headset monitoring -->
    <service
        android:name=".HeadsetMonitorService"
        android:foregroundServiceType="dataSync" />
</application>

Create a floating theme for your popup in res/values/styles.xml:

<style name="FloatingDialogTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <item name="android:windowIsFloating">true</item>
    <item name="android:windowBackground">@android:color/transparent</item>
    <item name="android:windowNoTitle">true</item>
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowCloseOnTouchOutside">true</item>
    <item name="android:windowAnimationStyle">@android:style/Animation.Dialog</item>
</style>

3. Implement Persistent Headset Detection #

Android 8.0+ restricts static broadcast receivers, so we'll use a foreground service to dynamically listen for headset events. This ensures we detect inserts even when your app is in the background.

Headset Monitor Service #

public class HeadsetMonitorService extends Service {
    private BroadcastReceiver headsetReceiver;

    @Override
    public void onCreate() {
        super.onCreate();
        // Register dynamic broadcast receiver for headset events
        headsetReceiver = new BroadcastReceiver() {
            @Override
            public void onReceive(Context context, Intent intent) {
                if (Intent.ACTION_HEADSET_PLUG.equals(intent.getAction())) {
                    int state = intent.getIntExtra("state", -1);
                    if (state == 1) { // Headset inserted
                        showPopup(context);
                    }
                }
            }
        };
        IntentFilter filter = new IntentFilter(Intent.ACTION_HEADSET_PLUG);
        registerReceiver(headsetReceiver, filter);

        // Start as foreground service (required for Android 8.0+)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel channel = new NotificationChannel(
                "headset_monitor", 
                "Headset Monitor", 
                NotificationManager.IMPORTANCE_LOW
            );
            NotificationManager manager = getSystemService(NotificationManager.class);
            if (manager != null) manager.createNotificationChannel(channel);

            Notification notification = new Notification.Builder(this, "headset_monitor")
                .setContentTitle("Headset Monitor")
                .setContentText("Listening for headset connections")
                .setSmallIcon(R.mipmap.ic_launcher)
                .build();
            startForeground(1, notification);
        }
    }

    private void showPopup(Context context) {
        // Check for floating window permission (Android 6.0+)
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
            if (!Settings.canDrawOverlays(context)) {
                // Redirect user to enable permission
                Intent permissionIntent = new Intent(
                    Settings.ACTION_MANAGE_OVERLAY_PERMISSION,
                    Uri.parse("package:" + context.getPackageName())
                );
                permissionIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
                context.startActivity(permissionIntent);
                return;
            }
        }

        // Launch the popup activity
        Intent popupIntent = new Intent(context, PopUpActivity.class);
        popupIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
        context.startActivity(popupIntent);
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        if (headsetReceiver != null) unregisterReceiver(headsetReceiver);
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

4. Configure the Popup Activity #

Update your PopUpActivity to behave as a system overlay and handle button actions:

public class PopUpActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_pop_up);

        // Set window type to system overlay
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            getWindow().setType(WindowManager.LayoutParams.TYPE_APPLICATION_OVERLAY);
        } else {
            getWindow().setType(WindowManager.LayoutParams.TYPE_SYSTEM_ALERT);
        }

        // Center the popup and set wrap content size
        WindowManager.LayoutParams params = getWindow().getAttributes();
        params.gravity = Gravity.CENTER;
        params.width = WindowManager.LayoutParams.WRAP_CONTENT;
        params.height = WindowManager.LayoutParams.WRAP_CONTENT;
        getWindow().setAttributes(params);

        // Handle "Open My App" button
        findViewById(R.id.btn_open_app).setOnClickListener(v -> {
            Intent mainIntent = new Intent(this, MainActivity.class);
            mainIntent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TOP);
            startActivity(mainIntent);
            finish();
        });

        // Handle "Skip" button
        findViewById(R.id.btn_skip).setOnClickListener(v -> finish());
    }
}

5. Start the Monitor Service #

Launch the foreground service when your app starts (e.g., in MainActivity):

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

    Intent serviceIntent = new Intent(this, HeadsetMonitorService.class);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        startForegroundService(serviceIntent);
    } else {
        startService(serviceIntent);
    }
}

Key Notes #

• Permission Handling: Android 6.0+ requires users to manually enable the "Draw over other apps" permission. Our code redirects users to the settings if this permission is missing.
• Foreground Service: Android 8.0+ limits background services, so we use a foreground service with a low-priority notification to keep our headset listener active.
• Window Types: We use TYPE_APPLICATION_OVERLAY for Android Oreo and above (more secure) and TYPE_SYSTEM_ALERT for older versions.

内容的提问来源于stack exchange，提问作者Sergio Cervilla