SD 卡 (外部存儲) 狀態變化監聽涉及用戶文件讀寫、相機存儲、離線緩存、數據導出等核心業務。Android 提供兩種機制:廣播接收器監聽系統廣播 (推薦) 和 StorageEventListener 回調 (系統級、需系統簽名)。本文詳解標準廣播方案、狀態常量含義、權限演進、生命週期管理與最佳實踐。
| Action 常量 | 觸發時機 | 附加信息 (Intent Extras) |
|---|---|---|
| SD 卡掛載完成、可讀寫 | EXTRA_MEDIA_PATH (文件路徑) | |
| SD 卡卸載、不可用 | EXTRA_MEDIA_PATH | |
| 正在掃描/檢查文件系統 | EXTRA_MEDIA_PATH | |
| 用戶請求彈出 (需用戶確認) | EXTRA_MEDIA_PATH | |
| 物理移除 (無彈出流程) | EXTRA_MEDIA_PATH | |
| 未安全卸載直接移除 | EXTRA_MEDIA_PATH | |
| 作為 USB 大容量存儲共享給電腦 (Android 6.0+ 少見) | EXTRA_MEDIA_PATH | |
| 無文件系統/不支持的文件系統 | EXTRA_MEDIA_PATH | |
| 存在但無法掛載 (文件系統損壞) | EXTRA_MEDIA_PATH |
Environment.MEDIA_MOUNTED // 可讀寫
Environment.MEDIA_MOUNTED_READ_ONLY // 僅讀
Environment.MEDIA_UNMOUNTED // 未掛載
Environment.MEDIA_CHECKING // 檢查中
Environment.MEDIA_NOFS // 無文件系統
Environment.MEDIA_REMOVED // 物理移除
Environment.MEDIA_UNMOUNTABLE // 無法掛載
Environment.MEDIA_BAD_REMOVAL // 非法移除
Environment.MEDIA_SHARED // USB 共享中
public class StorageStateMonitor {
public interface OnStorageStateChangeListener {
void onMounted(String path); // 可讀寫
void onUnmounted(String path); // 不可用
void onChecking(String path); // 掃描中
void onEjectRequested(String path); // 彈出請求
void onRemoved(String path); // 物理移除
void onBadRemoval(String path); // 非法移除
void onShared(String path); // USB共享
void onNoFs(String path); // 無文件系統
void onUnmountable(String path); // 無法掛載
}
private final Context context;
private final OnStorageStateChangeListener listener;
private final BroadcastReceiver receiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
String path = intent.getData() != null ? intent.getData().getPath() : "";
switch (action) {
case Intent.ACTION_MEDIA_MOUNTED:
listener.onMounted(path); break;
case Intent.ACTION_MEDIA_UNMOUNTED:
listener.onUnmounted(path); break;
case Intent.ACTION_MEDIA_CHECKING:
listener.onChecking(path); break;
case Intent.ACTION_MEDIA_EJECT:
listener.onEjectRequested(path); break;
case Intent.ACTION_MEDIA_REMOVED:
listener.onRemoved(path); break;
case Intent.ACTION_MEDIA_BAD_REMOVAL:
listener.onBadRemoval(path); break;
case Intent.ACTION_MEDIA_SHARED:
listener.onShared(path); break;
case Intent.ACTION_MEDIA_NOFS:
listener.onNoFs(path); break;
case Intent.ACTION_MEDIA_UNMOUNTABLE:
listener.onUnmountable(path); break;
}
}
};
public StorageStateMonitor(Context context, OnStorageStateChangeListener listener) {
this.context = context.getApplicationContext(); // 避免洩漏
this.listener = listener;
}
/** 註冊監聽 (在 Activity/Fragment onStart/onResume 調用) */
public void register() {
IntentFilter filter = new IntentFilter();
filter.addAction(Intent.ACTION_MEDIA_MOUNTED);
filter.addAction(Intent.ACTION_MEDIA_UNMOUNTED);
filter.addAction(Intent.ACTION_MEDIA_CHECKING);
filter.addAction(Intent.ACTION_MEDIA_EJECT);
filter.addAction(Intent.ACTION_MEDIA_REMOVED);
filter.addAction(Intent.ACTION_MEDIA_BAD_REMOVAL);
filter.addAction(Intent.ACTION_MEDIA_SHARED);
filter.addAction(Intent.ACTION_MEDIA_NOFS);
filter.addAction(Intent.ACTION_MEDIA_UNMOUNTABLE);
filter.addDataScheme("file"); // 必須添加,否則無法接收
context.registerReceiver(receiver, filter);
}
/** 註銷監聽 (在 onStop/onPause 調用) */
public void unregister() {
try {
context.unregisterReceiver(receiver);
} catch (IllegalArgumentException ignored) {}
}
/** 同步獲取當前狀態 (不依賴廣播) */
public static String getCurrentState(Context context) {
return Environment.getExternalStorageState(context.getExternalFilesDir(null));
}
/** 判斷是否可寫 */
public static boolean isWritable(Context context) {
return Environment.MEDIA_MOUNTED.equals(getCurrentState(context));
}
/** 判斷是否可讀 (含唯讀) */
public static boolean isReadable(Context context) {
String state = getCurrentState(context);
return Environment.MEDIA_MOUNTED.equals(state) || Environment.MEDIA_MOUNTED_READ_ONLY.equals(state);
}
}
public class MainActivity extends AppCompatActivity {
private StorageStateMonitor storageMonitor;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
storageMonitor = new StorageStateMonitor(this, new StorageStateMonitor.OnStorageStateChangeListener() {
@Override public void onMounted(String path) {
runOnUiThread(() -> {
Toast.makeText(MainActivity.this, "SD卡已掛載: " + path, Toast.LENGTH_SHORT).show();
// 恢復文件讀寫、恢復下載任務、刷新媒體庫
});
}
@Override public void onUnmounted(String path) {
runOnUiThread(() -> {
Toast.makeText(MainActivity.this, "SD卡已卸載", Toast.LENGTH_SHORT).show();
// 暫停寫入、關閉文件流、提示用戶
});
}
// 其他回調按需實現...
});
}
@Override
protected void onStart() {
super.onStart();
storageMonitor.register();
}
@Override
protected void onStop() {
super.onStop();
storageMonitor.unregister();
}
}
| Android 版本 | 存儲訪問模型 | 關鍵變化 |
|---|---|---|
| API < 19 (KitKat) | 權限模型 | WRITE_EXTERNAL_STORAGE 即可任意讀寫 |
| API 19-28 | 權限 + 公開目錄 | 應用專屬目錄 (getExternalFilesDir) 無需權限;公開目錄需權限 |
| API 29 (Q) | 分區存儲 | 默認沙箱,僅訪問自有文件;MediaStore 訪問媒體;SAF 訪問其他 |
| API 30 (R) | 分區存儲強制 | MANAGE_EXTERNAL_STORAGE 權限極難獲取;MediaStore + SAF 為主流 |
| API 33+ (Tiramisu) | 細粒度媒體權限 | READ_MEDIA_IMAGES/VIDEO/AUDIO 替代 READ_EXTERNAL_STORAGE |
context.getExternalFilesDir(null) (無需權限、卸載自動清理)MediaStore.Images.Media.insertImage()、ContentResolver.query()ACTION_OPEN_DOCUMENT/ACTION_CREATE_DOCUMENT、DocumentsContract注意:此類為 @SystemApi,普通應用無法直接使用,需系統簽名權限。原文代碼僅供理解內部機制。
// 僅系統應用可用
public class MyStorageListener extends StorageEventListener {
@Override
public void onStorageStateChanged(String path, String oldState, String newState) {
// 實時接收所有存儲卷狀態變化 (含內部存儲、SD卡、USB OTG、采用式存儲)
}
}
// 註冊 (需系統上下文)
StorageManager storageManager = (StorageManager) context.getSystemService(Context.STORAGE_SERVICE);
storageManager.registerListener(new MyStorageListener());
BroadcastReceiver 監聽 ACTION_MEDIA_* 廣播,配合 Environment.getExternalStorageState() 同步查詢onStart/register、onStop/unregister,使用 ApplicationContext 避免洩漏正確處理 SD 卡狀態變化,是應用穩定性、數據安全、用戶體驗的關鍵環節。隨著分區存儲全面強制,基於 Uri 的存儲訪問模式已成標準,建議盡早遷移。