Android中的Intent之user_present

一、關於android.intent.action.user_present

當Android設備處於鎖屏狀態並且用戶解鎖時，系統會發送名為android.intent.action.USER_PRESENT的廣播，該廣播被認為是設備啟動後由用戶進行的最後一個廣播之一。此廣播通知應用程序用戶已解鎖設備並準備使用它。

二、android.intent.action.user_present的作用

該廣播主要用於以下兩個方面：

1. 用戶行為跟蹤：應用程序可以使用android.intent.action.USER_PRESENT來掌握用戶何時使用設備，以及設備何時處於鎖定狀態。這對於跟蹤用戶行為模式以及確定最佳時間推送通知或提示非常有用。

2. 應用程序啟動：除了使用android.intent.action.BOOT_COMPLETED來啟動應用程序之外，應用程序還可以使用android.intent.action.USER_PRESENT廣播來啟動服務或活動。 如果應用程序需要在特定的用戶行為（例如用戶解鎖設備）時運行，則可以使用此機制。

三、如何接收user_present廣播

要接收android.intent.action.USER_PRESENT廣播，首先必須在Manifest文件中聲明廣播接收器。

<receiver android:name=".MyReceiver">
    <intent-filter>
        <action android:name="android.intent.action.USER_PRESENT" />
    </intent-filter>
</receiver>

然後，在應用程序中創建廣播接收器：

public class MyReceiver extends BroadcastReceiver {
    
    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent.getAction().equals(Intent.ACTION_USER_PRESENT)) {
            // 處理用戶解鎖設備
        }
    }
    
}

四、如何發送user_present廣播

要發送android.intent.action.USER_PRESENT廣播，只需創建新的Intent對象並設置廣播操作為「android.intent.action.USER_PRESENT」：

Intent intent = new Intent(Intent.ACTION_USER_PRESENT);
sendBroadcast(intent);

五、使用android.intent.action.USER_PRESENT的示例

詳細的代碼示例：

在這個示例中,我們將創建一個基於android.intent.action.USER_PRESENT廣播的應用程序。每當用戶解鎖設備時，該應用程序會顯示一個通知消息。用戶可以打開應用程序以獲取關於他們的解鎖模式的詳細信息。

1. AndroidManifest.xml文件中添加以下代碼：

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>

<receiver
    android:name=".MyReceiver"
    android:enabled="true"
    android:exported="false">
    <intent-filter>
        <action android:name="android.intent.action.USER_PRESENT"/>
    </intent-filter>
</receiver>

2. 在應用程序中創建一個簡單的Notification通知：

private static final int NOTIFICATION_ID = 1;
private static final String CHANNEL_ID = "unlock_notification_channel";

private void showNotification(Context context) {
    NotificationManager notificationManager =
            (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        NotificationChannel channel = new NotificationChannel(CHANNEL_ID,
                context.getString(R.string.unlock_notification_channel_name),
                NotificationManager.IMPORTANCE_DEFAULT);
        notificationManager.createNotificationChannel(channel);
    }

    NotificationCompat.Builder builder = new NotificationCompat.Builder(context, CHANNEL_ID)
            .setSmallIcon(R.drawable.ic_lock)
            .setContentTitle(context.getString(R.string.unlock_notification_title))
            .setContentText(context.getString(R.string.unlock_notification_message))
            .setPriority(NotificationCompat.PRIORITY_DEFAULT)
            .setAutoCancel(true);

    notificationManager.notify(NOTIFICATION_ID, builder.build());
}

3. 創建廣播接收器MyReceiver，並在onReceive()方法中添加showNotification()方法：

public class MyReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        if (intent.getAction().equals(Intent.ACTION_USER_PRESENT)) {
            showNotification(context);
        }
    }

    private void showNotification(Context context) {
        // 在此處添加第2步的代碼
    }

}

4. 最後，在MainActivity.java中添加以下代碼以啟動通知：

public class MainActivity extends AppCompatActivity {

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

        showNotification(this);
    }

}

這樣，每當用戶解鎖設備時，應用程序都會顯示一個通知消息。