Fotoapparat: 让Android相机更友好的库

1. 项目介绍

Fotoapparat 是一个开源的Android库，旨在简化在Android应用程序中使用相机的过程。它提供了一个简单易用的API，帮助开发者处理不同版本Android系统中的相机兼容性问题，包括对新旧相机API的支持。 Fotoapparat还集成了脸部检测功能，通过其姊妹库FaceDetector实现。

特点

• 自动管理相机权限。
• 支持新的Camera2 API和旧的Camera API。
• 内置自动对焦、曝光控制等相机参数调整。
• 异步照片保存和转换为位图。
• 提供RxJava适配器，方便结合响应式编程。

2. 项目快速启动

要开始使用Fotoapparat，首先在你的build.gradle文件中添加依赖：

dependencies {
    implementation 'io.fotoapparat:fotoapparat:2.7.0'
}

然后请求相机权限（对于Android 6.0及以上版本）：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.CAMERA},
            MY_PERMISSIONS_REQUEST_CAMERA);
}

创建一个Fotoapparat实例并设置到界面上：

final CameraView cameraView = findViewById(R.id.camera_view);

final Fotoapparat fotoapparat = Fotoapparat
        .with(this)
        .into(cameraView)
        .build();

拍照并保存图片：

fotoapparat.takePicture()
    .saveToFile(someFile)
    .whenAvailable(new PhotoAvailabilityListener() {
        @Override
        public void onPhotoAvailable(Photo photo) {
            // 处理图片
        }
    });

3. 应用案例和最佳实践

• 在拍照前先检查相机是否可用，避免因设备无摄像头导致的问题。
• 使用fotoapparat.toBitmap()方法将图片异步转化为位图，以便在UI线程中显示。
• 考虑到用户界面的流畅性，尽量避免在主线程进行耗时操作，如图片处理和保存。
• 针对不同屏幕方向和设备，合理配置相机参数。

4. 典型生态项目

• FaceDetector: 用于面部检测的辅助库，可与Fotoapparat集成。
• Android CameraX: Google官方推荐的现代相机框架，可以与Fotoapparat一起使用，提供更高级的功能。
• RxAndroid: 将Fotoapparat的事件流转化为RxJava Observables，便于响应式编程。

完成这些步骤后，你应该能够轻松地在你的Android应用中集成和使用Fotoapparat来处理相机功能了。更多详细信息及示例代码，可以参考项目官方文档和样例工程。