读取和编辑图片Exif信息

接口说明

Exif信息的读取与编辑相关的API如下，详细介绍请参考ImageSource。

注意事项

• 需要先创建ImageSource对象，再读取或编辑Exif信息。
• 读取图片Exif信息前，需要确保应用对目标图片具有读取权限；修改图片Exif信息前，需要确保应用对目标图片具有写入权限。
• 在部分图片来源或访问场景下，即使应用具有图片读取权限，系统也可能对GPS等隐私信息进行去隐私化处理，此时无法获取对应的Exif信息。
• 图片文件需要包含Exif信息。对于没有Exif信息或不包含目标属性键的图片，读取结果可能为空或返回默认值。
• 修改Exif信息前，需要确认图片格式和目标属性键支持写入。
• 图片元数据可能包含拍摄位置等隐私信息，应用展示、上传或共享前应结合业务场景做好用户授权和隐私保护。

开发步骤

获取图片并创建ImageSource对象后，可读取或编辑Exif信息。示例代码如下：

1. 导入相关模块包。

   // 导入相关模块。
   import { image } from '@kit.ImageKit';
   import { BusinessError } from '@kit.BasicServicesKit';

   ExifUtility.ets

2. 获取指定属性键的Exif信息。

   // 获取指定key的Exif信息接口示例
   async getExif(imageSourceApi: image.ImageSource | undefined, key: image.PropertyKey): Promise<string> {
     let info: string = '';
     if (imageSourceApi) {
       console.info('getExif: The imageSourceApi is not undefined.');
       // 根据传入的key获取其Exif信息
       let options: image.ImagePropertyOptions = { index: 0, defaultValue: 'This key has no value!' };
       try {
         let data = await imageSourceApi.getImageProperty(key, options);
         info = `Succeeded in getting the ${key}'s value: ${data}.`;
         console.info(info);
         return info; // 获取key值成功时返回获取到的key值
       } catch (error) {
         info =
           `Failed to get the value of the ${key} with error: ${error}.`;
         console.error(info);
         return info; // 获取key值失败时返回错误信息
       }
     } else {
       info = 'getExif: The imageSourceApi is undefined.';
       console.info(info);
       return info; // 如果 imageSourceApi 是 undefined，则直接返回信息
     }
   }

   ExifUtility.ets

3. 修改指定属性键的Exif信息。

   // 修改指定key的Exif信息的接口示例
   async modifyExif(imageSourceApi: image.ImageSource | undefined, key: image.PropertyKey, value: string)
     : Promise<string> {
     let info: string = '';
     if (imageSourceApi) {
       // 编辑EXIF信息
       try {
         await imageSourceApi.modifyImageProperty(key, value);
         try {
           let modifyValue = await imageSourceApi.getImageProperty(key)
           info = `The ${key}'s value is modified to ${modifyValue}.`
           console.info(info);
           return info; // 获取key值成功时返回修改成功信息
         } catch (error) {
           console.error(`Failed to get the ${key}'s value with ${error}`);
           console.error(info);
           return info; // 获取key值失败时返回错误信息
         }
       } catch (error) {
         info = `Failed to modify the ${key}'s value with ${error}`;
         console.error(info);
         return info; // 修改key值失败时返回错误信息
       }
     } else {
       info = 'modifyExif: The imageSourceApi is undefined.';
       console.info(info);
       return info; // 如果 imageSourceApi 是 undefined，直接返回信息
     }
   }

   ExifUtility.ets