手電筒功能核心在於控制相機閃光燈。舊版 Camera API 已棄用,現代 App 應使用 Camera2 API 實現更穩定、兼容性更好的手電筒。本文提供完整 Fragment 封裝、生命週期管理、開關狀態同步、無閃光燈設備降級提示。
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-feature android:name="android.hardware.camera.flash" android:required="false" />
public class FlashlightFragment extends Fragment implements SurfaceHolder.Callback {
private ImageButton btnSwitch;
private ImageView bgView;
private boolean isLightOn = false;
private CameraManager cameraManager;
private String cameraId;
private SurfaceView preview;
@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
View view = inflater.inflate(R.layout.fragment_flashlight, container, false);
btnSwitch = view.findViewById(R.id.flashlight_button);
bgView = view.findViewById(R.id.flashlight_bg);
preview = view.findViewById(R.id.preview);
preview.getHolder().addCallback(this);
cameraManager = (CameraManager) requireContext().getSystemService(Context.CAMERA_SERVICE);
try {
cameraId = getBackCameraId();
} catch (CameraAccessException e) {
e.printStackTrace();
}
toggleBgImage();
btnSwitch.setOnClickListener(v -> {
if (isLightOn) turnOffFlash(); else turnOnFlash();
});
return view;
}
private String getBackCameraId() throws CameraAccessException {
for (String id : cameraManager.getCameraIdList()) {
CameraCharacteristics cc = cameraManager.getCameraCharacteristics(id);
if (cc.get(CameraCharacteristics.LENS_FACING) == CameraCharacteristics.LENS_FACING_BACK) {
return id;
}
}
throw new IllegalStateException("No back camera");
}
@Override public void surfaceCreated(SurfaceHolder holder) {
// Camera2 手電筒不需要預覽 Surface,但保留以兼容舊邏輯
}
@Override public void surfaceChanged(SurfaceHolder holder, int format, int w, int h) {}
@Override public void surfaceDestroyed(SurfaceHolder holder) {}
private void turnOnFlash() {
try {
if (cameraId == null) return;
cameraManager.setTorchMode(cameraId, true);
isLightOn = true;
toggleBgImage();
} catch (CameraAccessException e) {
e.printStackTrace();
Toast.makeText(getContext(), "開啟失敗", Toast.LENGTH_SHORT).show();
}
}
private void turnOffFlash() {
try {
if (cameraId == null) return;
cameraManager.setTorchMode(cameraId, false);
isLightOn = false;
toggleBgImage();
} catch (CameraAccessException e) {
e.printStackTrace();
}
}
private void toggleBgImage() {
bgView.setImageResource(isLightOn ? R.mipmap.f_on : R.mipmap.f_off);
}
@Override public void onPause() {
super.onPause();
if (isLightOn) turnOffFlash();
}
@Override public void onDestroy() {
super.onDestroy();
if (isLightOn) turnOffFlash();
}
}
public class FlashlightActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_flashlight);
if (isFlashSupported()) {
if (savedInstanceState == null) {
getSupportFragmentManager().beginTransaction()
.replace(R.id.container, new FlashlightFragment()).commit();
}
} else {
showNoFlashDialog();
}
}
private boolean isFlashSupported() {
PackageManager pm = getPackageManager();
return pm.hasSystemFeature(PackageManager.FEATURE_CAMERA_FLASH);
}
private void showNoFlashDialog() {
new AlertDialog.Builder(this)
.setTitle("不支援手電筒")
.setMessage("此設備無閃光燈,無法使用手電筒功能。")
.setPositiveButton("確定", (d, w) -> finish())
.show();
}
}
<!-- fragment_flashlight.xml -->
<FrameLayout xmlns:android="https://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent">
<SurfaceView android:id="@+id/preview"
android:layout_width="match_parent"
android:layout_height="match_parent" />
<ImageView android:id="@+id/flashlight_bg"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scaleType="centerCrop"
android:src="@mipmap/f_off" />
<ImageButton android:id="@+id/flashlight_button"
android:layout_width="120dp"
android:layout_height="120dp"
android:layout_gravity="center"
android:background="@null"
android:src="@drawable/btn_flashlight_selector" />
</FrameLayout>
CameraManager.setTorchMode() 直接控制閃光燈,無需開啟預覽會話,極大簡化代碼。onPause/onDestroy 確實關閉手電筒,避免用戶切出 App 後閃光燈持續亮著耗電發熱。android:required="false" 讓無閃光燈設備也能安裝,運行時動態檢測優雅降級。android:foregroundServiceType="camera" 若在前台服務中長時間開啟。此方案兼容 Android 5.0+ 絕大多數設備,代碼結構清晰,易於集成至現有專案。