Android監聽截屏

Android系統沒有提供默認的截屏事件監聽方式，需要開發者自己想辦法實現。查看了網上推薦的實現方式，主要是通過內容觀察者（ContentObserver）監聽媒體數據庫的變化，根據內容名稱（路徑）中是否包含關鍵字，判斷是否為截屏事件。
關鍵字：

    private static final String[] KEYWORDS = {
            "screenshot", "screen_shot", "screen-shot", "screen shot",
            "screencapture", "screen_capture", "screen-capture", "screen capture",
            "screencap", "screen_cap", "screen-cap", "screen cap", "snap", "截屏"
    };

第一步：對ContentResolver添加內、外存儲變化監聽；

mInternalObserver = new MediaContentObserver(MediaStore.Images.Media.INTERNAL_CONTENT_URI, MainHandler.get());
mExternalObserver = new MediaContentObserver(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, MainHandler.get());
mResolver = AppContext.get().getContentResolver();
// 添加監聽
mResolver.registerContentObserver(
        MediaStore.Images.Media.INTERNAL_CONTENT_URI,
        false,
        mInternalObserver
);
mResolver.registerContentObserver(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        false,
        mExternalObserver
);

第二步：當內容觀察者（ContentObserver）監聽到變化時，會調用onChange方法，此時，我們使用ContentResolver去查詢最新的一條數據；
需要注意的是，查詢外部存儲一定要有讀取存儲權限（Manifest.permission.READ_EXTERNAL_STORAGE），否則會在查詢的時候報錯；
第三步：判斷查到到數據是否為截圖文件；在這里有一個很難處理到問題，在華為榮耀手機上，截圖預覽圖生成的同時就會通知存儲內容變化，而小米則是在截圖預覽圖消失后通知變化；
解決方案：

1. 判斷當前文件路徑是否與上次有效路徑相同，相同執行步驟2，不相同則執行步驟3；
2. 當前路徑與上次路徑相同，取消回調請求，重新延遲發送回調請求；
3. 當前路徑與上次路徑不同，判斷內容的生成時間(MediaStore.Images.ImageColumns.DATE_TAKEN)和添加時間(MediaStore.Images.ImageColumns.DATE_ADDED)是否相同，相同執行步驟4，不相同則執行步驟5；
4. 內容的生成時間和添加時間相同，認為此時為生成長截圖，立刻取消回調請求，執行空回調（用於取消彈窗等操作）；
5. 內容的生成時間和添加時間不同，檢查是否含有關鍵字，若判定為截圖，更新上次有效路徑，取消回調請求，重新延遲發送回調請求；

 // 獲取各列的索引
            int dataIndex = cursor.getColumnIndex(MediaStore.Images.ImageColumns.DATA);
            int dateTakenIndex = cursor.getColumnIndex(MediaStore.Images.ImageColumns.DATE_TAKEN);
            int dateAddIndex = cursor.getColumnIndex(MediaStore.Images.ImageColumns.DATE_ADDED);
            // 獲取行數據
            final String data = cursor.getString(dataIndex);
            long dateTaken = cursor.getLong(dateTakenIndex);
            long dateAdded = cursor.getLong(dateAddIndex);
            if (data.length() > 0) {
                if (TextUtils.equals(lastData, data)) {
                    MainHandler.get().removeCallbacks(shotCallBack);
                    MainHandler.get().postDelayed(shotCallBack, 500);
                } else if (dateTaken == 0 || dateTaken == dateAdded * 1000) {
                    MainHandler.get().removeCallbacks(shotCallBack);
                    if (listener != null) {
                        listener.onShot(null);
                    }
                } else if (checkScreenShot(data)) {
                    MainHandler.get().removeCallbacks(shotCallBack);
                    lastData = data;
                    MainHandler.get().postDelayed(shotCallBack, 500);
                }
            }

完整代碼：（其中AppContext為全局Application單例，MainHandler為全局主線程Handler單例）

public class ScreenShotHelper {
    private static final String[] KEYWORDS = {
            "screenshot", "screen_shot", "screen-shot", "screen shot",
            "screencapture", "screen_capture", "screen-capture", "screen capture",
            "screencap", "screen_cap", "screen-cap", "screen cap", "snap", "截屏"
    };

    /**
     * 讀取媒體數據庫時需要讀取的列
     */
    private static final String[] MEDIA_PROJECTIONS = {
            MediaStore.Images.ImageColumns.DATA,
            MediaStore.Images.ImageColumns.DATE_TAKEN,
            MediaStore.Images.ImageColumns.DATE_ADDED,
    };
    /**
     * 內部存儲器內容觀察者
     */
    private ContentObserver mInternalObserver;
    /**
     * 外部存儲器內容觀察者
     */
    private ContentObserver mExternalObserver;
    private ContentResolver mResolver;
    private OnScreenShotListener listener;
    private String lastData;
    private Runnable shotCallBack = new Runnable() {
        @Override
        public void run() {
            if (listener != null) {
                final String path = lastData;
                if (path != null && path.length() > 0) {
                    listener.onShot(path);
                }
            }
        }
    };

    private ScreenShotHelper() {
        // 初始化
        mInternalObserver = new MediaContentObserver(MediaStore.Images.Media.INTERNAL_CONTENT_URI, null);
        mExternalObserver = new MediaContentObserver(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, null);

        mResolver = AppContext.get().getContentResolver();
        // 添加監聽
        mResolver.registerContentObserver(
                MediaStore.Images.Media.INTERNAL_CONTENT_URI,
                false,
                mInternalObserver
        );
        mResolver.registerContentObserver(
                MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                false,
                mExternalObserver
        );
    }

    private static class Instance {
        static ScreenShotHelper mInstance = new ScreenShotHelper();
    }

    public static ScreenShotHelper get() {
        return Instance.mInstance;
    }

    public void setScreenShotListener(OnScreenShotListener listener) {
        this.listener = listener;
    }

    public void removeScreenShotListener(OnScreenShotListener listener) {
        if (this.listener == listener) {
            synchronized (ScreenShotHelper.class) {
                if (this.listener == listener) {
                    this.listener = null;
                }
            }
        }
    }

    public void stopListener() {
        mResolver.unregisterContentObserver(mInternalObserver);
        mResolver.unregisterContentObserver(mExternalObserver);
    }

    private void handleMediaContentChange(Uri contentUri) {
        Cursor cursor = null;
        try {
            // 數據改變時查詢數據庫中最后加入的一條數據
            cursor = mResolver.query(
                    contentUri,
                    MEDIA_PROJECTIONS,
                    null,
                    null,
                    MediaStore.Images.ImageColumns.DATE_ADDED + " desc limit 1"
            );
            if (cursor == null) {
                return;
            }
            if (!cursor.moveToFirst()) {
                return;
            }
            // 獲取各列的索引
            int dataIndex = cursor.getColumnIndex(MediaStore.Images.ImageColumns.DATA);
            int dateTakenIndex = cursor.getColumnIndex(MediaStore.Images.ImageColumns.DATE_TAKEN);
            int dateAddIndex = cursor.getColumnIndex(MediaStore.Images.ImageColumns.DATE_ADDED);
            // 獲取行數據
            final String data = cursor.getString(dataIndex);
            long dateTaken = cursor.getLong(dateTakenIndex);
            long dateAdded = cursor.getLong(dateAddIndex);
            if (data.length() > 0) {
                if (TextUtils.equals(lastData, data)) {
                    //更改資源文件名也會觸發，並且傳遞過來的是之前的截屏文件，所以只對分鍾以內的有效
                    if (System.currentTimeMillis() - dateTaken < 3 * 3600) {
                        MainHandler.get().removeCallbacks(shotCallBack);
                        MainHandler.get().postDelayed(shotCallBack, 500);
                    }
                } else if (dateTaken == 0 || dateTaken == dateAdded * 1000) {
                    MainHandler.get().removeCallbacks(shotCallBack);
                    if (listener != null) {
                        listener.onShot(null);
                    }
                } else if (checkScreenShot(data)) {
                    MainHandler.get().removeCallbacks(shotCallBack);
                    lastData = data;
                    MainHandler.get().postDelayed(shotCallBack, 500);
                }
            }
        } catch (Exception e) {
            //
        } finally {
            if (cursor != null && !cursor.isClosed()) {
                cursor.close();
            }
        }
    }

    /**
     * 根據包含關鍵字判斷是否是截屏
     */
    private boolean checkScreenShot(String data) {
        if (data == null || data.length() < 2) {
            return false;
        }
        data = data.toLowerCase();
        for (String keyWork : KEYWORDS) {
            if (data.contains(keyWork)) {
                return true;
            }
        }
        return false;
    }

    private class MediaContentObserver extends ContentObserver {
        private Uri mContentUri;

        MediaContentObserver(Uri contentUri, Handler handler) {
            super(handler);
            mContentUri = contentUri;
        }

        @Override
        public void onChange(boolean selfChange) {
            super.onChange(selfChange);
            if (listener != null) {
                handleMediaContentChange(mContentUri);
            }
        }
    }

    public interface OnScreenShotListener {
        void onShot(@Nullable String data);
    }

}

總結：
1.必須要有讀取內存的權限；
2.內容生成時間為毫秒，內容添加時間為秒，比較時需要注意換算；
3.當內容生成時間等於內容添加時間時，應當取消之前的截屏監聽操作（尤其是會遮擋頁面視圖的部分）；

2020-04-14