萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 通用手電筒實現:Camera2 API 控制閃光燈、兼容性處理與 UI 交互

手電筒功能核心在於控制相機閃光燈。舊版 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" />

二、手電筒 Fragment 完整實現

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();
    }
}

三、Activity 入口與無閃光燈設備處理

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 12+ 需在 Manifest 聲明 android:foregroundServiceType="camera" 若在前台服務中長時間開啟。

此方案兼容 Android 5.0+ 絕大多數設備,代碼結構清晰,易於集成至現有專案。

copyright © 萬盛學電腦網 all rights reserved