Android CameraX开发：如何为拍摄图片添加自定义标签实现分类

以下三种方案均满足「同文件夹存储、按标签筛选排序」的需求，按改造成本从低到高排列：

方案1：文件名携带标签（全版本兼容，改造成本最低） #

你设想的文件名存标签是完全可行的，不需要额外依赖存储组件，读取时直接拆分文件名就能拿到标签，只需要修改现有代码里的文件名生成逻辑即可。
拍摄前先拿到当前选中的分类标签，把标签拼接到时间戳文件名中，避免重名覆盖：

private void capturePhoto(String currentTag) { // 传入当前选中的标签，比如选#1就传"1"
        long timestamp = System.currentTimeMillis();

        ContentValues contentValues = new ContentValues();
        // 文件名规则：时间戳_标签，示例：1718234567890_1.jpg
        contentValues.put(MediaStore.MediaColumns.DISPLAY_NAME, timestamp + "_" + currentTag);
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            contentValues.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/" + "Test/");
        }
        contentValues.put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg");


        imageCapture.takePicture(
                new ImageCapture.OutputFileOptions.Builder(
                getContext().getContentResolver(),
                        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                        contentValues
                ).build(), getExecutor(),
                new ImageCapture.OnImageSavedCallback() {
                    @Override
                    public void onImageSaved(@NonNull ImageCapture.OutputFileResults outputFileResults) {
                        Toast.makeText(requireContext(), "Photo has been saved successfully.", Toast.LENGTH_SHORT).show();
                    }

                    @Override
                    public void onError(@NonNull ImageCaptureException exception) {
                        Toast.makeText(requireActivity(), "Error saving photo: " + exception.getMessage(), Toast.LENGTH_SHORT).show();
                    }
                }
        );
    }

后续读取Test文件夹下的图片时，拿到文件名后按下划线拆分，第二段就是标签值，直接做筛选、分组排序即可。

方案2：写入图片元数据（不修改文件名，展示更友好） #

如果不想让文件名带标签后缀，可以把标签存在图片自带的元数据里，不会影响文件名展示：

• Android 10及以上：直接在ContentValues里把标签写入MediaStore提供的DESCRIPTION字段
• Android 10以下：拍照成功后把标签写入图片的EXIF用户注释字段
  代码调整如下：

private void capturePhoto(String currentTag) {
        long timestamp = System.currentTimeMillis();

        ContentValues contentValues = new ContentValues();
        contentValues.put(MediaStore.MediaColumns.DISPLAY_NAME, String.valueOf(timestamp));
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            contentValues.put(MediaStore.Images.Media.RELATIVE_PATH, Environment.DIRECTORY_PICTURES + "/" + "Test/");
            // 高版本直接写入MediaStore描述字段
            contentValues.put(MediaStore.MediaColumns.DESCRIPTION, "camera_tag_" + currentTag);
        }
        contentValues.put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg");


        imageCapture.takePicture(
                new ImageCapture.OutputFileOptions.Builder(
                getContext().getContentResolver(),
                        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                        contentValues
                ).build(), getExecutor(),
                new ImageCapture.OnImageSavedCallback() {
                    @Override
                    public void onImageSaved(@NonNull ImageCapture.OutputFileResults outputFileResults) {
                        Uri savedUri = Objects.requireNonNull(outputFileResults.getSavedUri());
                        // 低版本写入EXIF字段做兼容
                        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
                            try {
                                ExifInterface exif = new ExifInterface(requireContext().getContentResolver().openInputStream(savedUri));
                                exif.setAttribute(ExifInterface.TAG_USER_COMMENT, "camera_tag_" + currentTag);
                                exif.saveAttributes();
                            } catch (IOException e) {
                                e.printStackTrace();
                            }
                        }
                        Toast.makeText(requireContext(), "Photo has been saved successfully.", Toast.LENGTH_SHORT).show();
                    }

                    @Override
                    public void onError(@NonNull ImageCaptureException exception) {
                        Toast.makeText(requireActivity(), "Error saving photo: " + exception.getMessage(), Toast.LENGTH_SHORT).show();
                    }
                }
        );
    }

后续读取图片时，高版本直接查MediaStore的DESCRIPTION列，低版本读图片EXIF的TAG_USER_COMMENT字段就能拿到标签。

方案3：本地数据库维护映射关系（适合复杂分类场景） #

如果后续需要扩展多标签、图片备注、拍摄参数关联等复杂逻辑，可以在拍照保存成功后，把图片Uri、对应标签、拍摄时间等信息存入本地Room数据库，后续筛选排序直接查数据库即可，不需要修改文件名、也不需要改动图片本身的元数据，灵活度最高。

• 注意：这个方案需要额外处理数据同步，比如用户在系统相册删除图片后，要同步删除数据库里的对应记录，避免出现无效数据。

选型建议 #

如果只是做简单的固定分类，优先选方案1，代码改动最少，没有版本兼容问题，稳定性最高；如果对文件名展示有要求，选方案2即可；只有当分类逻辑复杂、需要扩展更多功能时再考虑方案3。

内容的提问来源于stack exchange，提问作者Mister Serhat